layout: page title: Build Parameters for Velox Backend nav_order: 4 parent: Getting-Started

Build Parameters

Native build parameters for buildbundle-veloxbe.sh or builddeps-veloxbe.sh

Please set them via --, e.g. --build_type=Release.

ParametersDescriptionDefault
build_typeBuild type for Velox & gluten cpp, CMAKE_BUILD_TYPE.Release
build_testsBuild gluten cpp tests.OFF
build_examplesBuild udf example.OFF
build_benchmarksBuild gluten cpp benchmarks.OFF
enable_jemalloc_statsPrint jemalloc stats for debugging.OFF
enable_qatEnable QAT for shuffle data de/compression.OFF
enable_s3Build with S3 support.OFF
enable_gcsBuild with GCS support.OFF
enable_hdfsBuild with HDFS support.OFF
enable_abfsBuild with ABFS support.OFF
enable_vcpkgEnable vcpkg for static build.OFF
run_setup_scriptRun setup script to install Velox dependencies.ON
velox_repoSpecify your own Velox repo to build.""
velox_branchSpecify your own Velox branch to build.""
velox_homeSpecify your own Velox source path to build.""
build_velox_testsBuild Velox tests.OFF
build_velox_benchmarksBuild Velox benchmarks (velox_tests and connectors will be disabled if ON)OFF
build_arrowBuild arrow java/cpp and install the libs in local. Can turn it OFF after first build.ON
spark_versionBuild for specified version of Spark(3.2, 3.3, 3.4, 3.5, ALL). ALL means build for all versions.ALL

Velox build parameters for build_velox.sh

Please set them via --, e.g., --velox_home=/YOUR/PATH.

ParametersDescriptionDefault
velox_homeSpecify Velox source path to build.GLUTEN_SRC/ep/build-velox/build/velox_ep
build_typeVelox build type, i.e., CMAKE_BUILD_TYPE.Release
enable_s3Build Velox with S3 support.OFF
enable_gcsBuild Velox with GCS support.OFF
enable_hdfsBuild Velox with HDFS support.OFF
enable_abfsBuild Velox with ABFS support.OFF
run_setup_scriptRun setup script to install Velox dependencies before build.ON
build_test_utilsBuild Velox with cmake arg -DVELOX_BUILD_TEST_UTILS=ON if ON.OFF
build_testsBuild Velox test.OFF
build_benchmarksBuild Velox benchmarks.OFF

Maven build parameters

The below parameters can be set via -P for mvn.

ParametersDescriptionDefault state
backends-veloxBuild Gluten Velox backend.disabled
backends-clickhouseBuild Gluten ClickHouse backend.disabled
celebornBuild Gluten with Celeborn.disabled
uniffleBuild Gluten with Uniffle.disabled
deltaBuild Gluten with Delta Lake support.disabled
icebergBuild Gluten with Iceberg support.disabled
hudiBuild Gluten with Hudi support.disabled
spark-3.2Build Gluten for Spark 3.2.enabled
spark-3.3Build Gluten for Spark 3.3.disabled
spark-3.4Build Gluten for Spark 3.4.disabled
spark-3.5Build Gluten for Spark 3.5.disabled

Gluten Jar for Deployment

The gluten jar built out is under GLUTEN_SRC/package/target/. It's name pattern is gluten-<backend_type>-bundle-spark<spark.bundle.version>_<scala.binary.version>-<os.detected.release>_<os.detected.release.version>-<project.version>.jar.

Spark Versionspark.bundle.versionscala.binary.version
3.2.23.22.12
3.3.13.32.12
3.4.43.42.12
3.5.53.52.12