Real-time Query for Hadoop; mirror of Apache Impala
C++ Java Python JavaScript C Shell Other
Switch branches/tags
v1.2.2 v0.7.1refresh v0.7refresh v0.6refresh v0.5refresh v0.4refresh v0.3refresh v0.1refresh impala-v1.2.1 impala-v1.1.1 impala-v1.1 impala-v1.0 cdh5.15.0-release cdh5.14.4-release cdh5.14.2-release cdh5.14.0-release cdh5.13.3-release cdh5.13.2-release cdh5.13.1-release cdh5.13.0-release cdh5.12.2-release cdh5.12.1-release cdh5.12.0-release cdh5.11.2-release cdh5.11.1-release cdh5.11.0-release cdh5.10.2-release cdh5.10.1-release cdh5.10.0-release cdh5.9.3-release cdh5.9.2-release cdh5.9.1-release cdh5.9.0-release cdh5.8.5-release cdh5.8.4-release cdh5.8.3-release cdh5.8.2-release cdh5.8.0-release cdh5.7.6-release cdh5.7.5-release cdh5.7.4-release cdh5.7.3-release cdh5.7.2-release cdh5.7.1-release cdh5.7.0-release cdh5.6.1-release cdh5.6.0-release cdh5.5.6-release cdh5.5.5-release cdh5.5.4-release cdh5.5.2-release cdh5.5.1-release cdh5.5.0-release cdh5.4.11-release cdh5.4.10-release cdh5.4.9-release cdh5.4.8-release cdh5.4.7-release cdh5.4.5-release cdh5.4.4-release cdh5.4.3-release cdh5.4.2-release cdh5.4.1-release cdh5.4.0-release cdh5.3.10-release cdh5.3.9-release cdh5.3.8-release cdh5.3.6-release cdh5.3.5-release cdh5.3.4-release cdh5.3.3-release cdh5.3.2-release cdh5.3.1-release cdh5.3.0-release cdh5.2.6-release cdh5.2.5-release cdh5.2.4-release cdh5.2.3-release cdh5.2.2-release cdh5.2.1-release cdh5.2.0-release cdh5.1.5-release cdh5.1.4-release cdh5.1.3-release cdh5.1.2-release cdh5.1.0_v1.4 cdh5.1.0-release cdh5.0.6-release cdh5.0.5-release cdh5.0.3-release cdh5.0.2_v1.3.1 cdh5.0.2-release cdh5.0.1-release cdh4_v2.0 cdh4_v1.4 cdh4_v1.3.1
Nothing to show
Clone or download
Zoltan Borok-Nagy and cloudera-hudson IMPALA-7304: Don't write floating column index until PARQUET-1222 is …

Impala master branch can already write the Parquet
page index. However, we still don't have a well-defined
ordering for floating-point numbers in Parquet, see

Currently impala writes the page index with
fmax()/fmin() semantics, but it might contradicts the
future semantics that will be defined once PARQUET-1222
is resolved.

From this patch Impala won't write the column index
for floating-point columns until PARQUET-1222 is
resolved and implemented.

I updated the python test accordingly.

Change-Id: I50aa2e6607de6a8943eb068b8162b0506763078b
Reviewed-by: Impala Public Jenkins <>
Tested-by: Impala Public Jenkins <>
(cherry picked from commit 041197444d2a73bc3e3da4c6dbfdf1d63c236fbf)
Reviewed-by: Zoltan Borok-Nagy <>
Tested-by: Zoltan Borok-Nagy <>
Latest commit 74300b6 Jul 16, 2018
Failed to load latest commit information.
be IMPALA-7304: Don't write floating column index until PARQUET-1222 is … Jul 18, 2018
bin Change variables to make the code easier to read Jun 13, 2018
cmake_modules IMPALA-5717: Support for reading ORC data files Apr 13, 2018
common IMPALA-5216: Make admission control queuing async Jun 14, 2018
docker IMPALA-6070: Adding ASAN, --tail to test-with-docker. May 22, 2018
docs IMPALA-6408: [DOCS] Add a missing info about SHUFFLE Jun 13, 2018
ext-data-source Use "mvn -B" in builds to avoid dowloading progress bars in logs. Mar 27, 2018
fe IMPALA-6929: Support multi-column range partitions for Kudu Jun 13, 2018
impala-parent IMPALA-7120: remove sonatype repository Jun 6, 2018
infra Remove python dependency binaries from cdh5. May 23, 2018
security KUDU-2305: Limit sidecars to INT_MAX and fortify socket code Mar 23, 2018
shell IMPALA-2751: Matching quotes are not required in comments Jun 13, 2018
ssh_keys Move ssh keys from bin directory to fix packaging build break Jan 8, 2014
testdata IMPALA-6929: Support multi-column range partitions for Kudu Jun 13, 2018
tests IMPALA-7304: Don't write floating column index until PARQUET-1222 is … Jul 18, 2018
thirdparty Update thirdparty dependencies Jun 19, 2018
www IMPALA-5216: Make admission control queuing async Jun 14, 2018
.clang-format Match .clang-format more closely to actual practice. Oct 14, 2016
.clang-tidy IMPALA-5860: upgrade to LLVM 3.9.1 Sep 18, 2017
.gitignore IMPALA-6241: timeout in admission control test under ASAN Nov 29, 2017
CMakeLists.txt IMPALA-5931: Generates scan ranges in planner for s3/adls Jun 13, 2018 IMPALA-4406: Add cryptography export control notice Nov 6, 2016
LICENSE.txt IMPALA-6999: Upgrade to sqlparse-0.1.19 for Impala shell May 12, 2018 Consolidate test and cluster logs under a single directory. Mar 28, 2016
NOTICE.txt Update copyright date to 2018. Jan 12, 2018 IMPALA-6999: Upgrade to sqlparse-0.1.19 for Impala shell May 12, 2018 IMPALA-6317: Add -cmake_only option to May 26, 2018
setup.cfg add impala-flake8 Apr 26, 2018

Welcome to Impala

Lightning-fast, distributed SQL queries for petabytes of data stored in Apache Hadoop clusters.

Impala is a modern, massively-distributed, massively-parallel, C++ query engine that lets you analyze, transform and combine data from a variety of data sources:

  • Best of breed performance and scalability.
  • Support for data stored in HDFS, Apache HBase and Amazon S3.
  • Wide analytic SQL support, including window functions and subqueries.
  • On-the-fly code generation using LLVM to generate CPU-efficient code tailored specifically to each individual query.
  • Support for the most commonly-used Hadoop file formats, including the Apache Parquet project.
  • Apache-licensed, 100% open source.

More about Impala

To learn more about Impala as a business user, or to try Impala live or in a VM, please visit the Impala homepage.

If you are interested in contributing to Impala as a developer, or learning more about Impala's internals and architecture, visit the Impala wiki.

Supported Platforms

Impala only supports Linux at the moment.

Export Control Notice

This distribution uses cryptographic software and may be subject to export controls. Please refer to for more information.

Build Instructions

See bin/

Detailed Build Notes

Impala can be built with pre-built components, downloaded from S3, or can be built with an in-place toolchain located in the thirdparty directory (not recommended). The components needed to build Impala are Apache Hadoop, Hive, HBase, and Sentry. If you need to manually override the locations or versions of these components, you can do so through the environment variables and scripts listed below.

Scripts and directories
Location Purpose
bin/ This script must be sourced to setup all environment variables properly to allow other scripts to work
bin/ A script can be created in this location to set local overrides for any environment variables
bin/ A version of the above that can be checked into a branch for convenience.
bin/ A helper script to bootstrap some of the build requirements.
bin/ A helper script to bootstrap a developer environment. Please read it before using.
be/build/ Impala build output goes here.
be/generated-sources/ Thrift and other generated source will be found here.
Build Related Variables
Environment variable Default value Description
IMPALA_HOME Top level Impala directory
IMPALA_TOOLCHAIN "${IMPALA_HOME}/toolchain" Native toolchain directory (for compilers, libraries, etc.)
SKIP_TOOLCHAIN_BOOTSTRAP "false" Skips downloading the toolchain any python dependencies if "true"
CDH_COMPONENTS_HOME "${IMPALA_HOME}/toolchain/cdh_components" OR "${IMPALA_HOME}/thirdparty" (if detected) If a thirdparty directory is present, components found here will override anything in IMPALA_TOOLCHAIN.
CDH_MAJOR_VERSION "5" Identifier used to uniqueify paths for potentially incompatible component builds.
IMPALA_CONFIG_SOURCED "1" Set by ${IMPALA_HOME}/bin/ (internal use)
JAVA_HOME "/usr/lib/jvm/${JAVA_VERSION}" Used to locate Java
JAVA_VERSION "java-7-oracle-amd64" Can override to set a local Java version.
JAVA "${JAVA_HOME}/bin/java" Java binary location.
CLASSPATH See bin/ for details.
PYTHONPATH Will be changed to include: "${IMPALA_HOME}/shell/gen-py" "${IMPALA_HOME}/testdata" "${THRIFT_HOME}/python/lib/python2.7/site-packages" "${HIVE_HOME}/lib/py" "${IMPALA_HOME}/shell/ext-py/prettytable-0.7.1/dist/prettytable-0.7.1" "${IMPALA_HOME}/shell/ext-py/sasl-0.1.1/dist/sasl-0.1.1-py2.7-linux-x "${IMPALA_HOME}/shell/ext-py/sqlparse-0.1.19/dist/sqlparse-0.1.19-py2
Source Directories for Impala
Environment variable Default value Description
IMPALA_BE_DIR "${IMPALA_HOME}/be" Backend directory. Build output is also stored here.
IMPALA_FE_DIR "${IMPALA_HOME}/fe" Frontend directory
IMPALA_COMMON_DIR "${IMPALA_HOME}/common" Common code (thrift, function registry)
Various Compilation Settings
Environment variable Default value Description
IMPALA_BUILD_THREADS "8" or set to number of processors by default. Used for make -j and distcc -j settings.
IMPALA_MAKE_FLAGS "" Any extra settings to pass to make. Also used when copying udfs / udas into HDFS.
USE_SYSTEM_GCC "0" If set to any other value, directs cmake to not set GCC_ROOT, CMAKE_C_COMPILER, CMAKE_CXX_COMPILER, as well as setting TOOLCHAIN_LINK_FLAGS
IMPALA_CXX_COMPILER "default" Used by cmake (cmake_modules/toolchain and clang_toolchain.cmake) to select gcc / clang
USE_GOLD_LINKER "true" Directs backend cmake to use gold.
IS_OSX "false" (Experimental) currently only used to disable Kudu.
Environment variable Default value Description
HADOOP_INCLUDE_DIR "${HADOOP_HOME}/include" For 'hdfs.h'
HADOOP_LIB_DIR "${HADOOP_HOME}/lib" For 'libhdfs.a' or ''
HIVE_SRC_DIR "${HIVE_HOME}/src" Used to find Hive thrift files.