Apache Drill Test Framework

Clone this repo:
  1. aa2fc95 Bump xercesImpl from 2.12.0 to 2.12.2 in /framework (#5) by dependabot[bot] · 5 months ago main
  2. 85fd1eb Merge pull request #1 from agozhiy/resurrection by James Turton · 5 months ago
  3. 3261cf5 Changed logger implementation from log4j to slf4j w/ logback by Anton Gozhiy · 5 months ago
  4. fd0c903 Refactored remaining test suites to use data preparation phases instead of scripts by Anton Gozhiy · 6 months ago resurrection
  5. 5adf73d Added new data preparation phases by Anton Gozhiy · 7 months ago

Test Framework for Apache Drill

Test Framework for SQL on Hadoop technologies. Currently supports Apache Drill, a schema-free SQL query engine for Hadoop, NoSQL and cloud storage.

The framework is built for regression, integration & sanity testing. Includes test coverage (with baselines) for core Drill functionality, and supported features. The Apache Drill community uses the framework for for pre-commit regression testing and as part of the release criteria.

Requirements

  1. The test framework requires a distributed file system such as HDFS or MapR-FS to be configured. Some of the tests can also be run against a local file system. By default, it's configured to run against MapR-FS. You can change the default behavior by modifying conf/core-site.xml. Refer to conf/core-site.xml.example for settings.
  2. To run all tests, Hive and HBase needs to be installed and running. To exclude Hive and HBase tests, please refer to the example in the Execute Tests section.
  3. The test framework should be run on a Drill cluster node. Refer to Drill documentation for details on how to setup Drill. It can also be run on a client node with additional configuration required.
  4. Cluster information are set in the conf/drillTestConfig.properties file. This is the main configuration file for the framework. It needs to be modified with local cluster info before compiling the framework and running tests.

Build Project

To begin using the test framework, you need to build the project and download dependent datasets (configured in pom.xml).

git clone git@github.com:mapr/drill-test-framework.git
cd drill-test-framework
bin/build_framework -Pdownload

If you've already downloaded the datasets previously, you can simply skip the download.

If you‘re going to run tests in docker, you’ll need to build the docker image first:

mvn clean install docker:build -DskipTests

Execute Tests

In the root directory of your repository, execute the following command to run tests:

bin/run_tests -s <suites> -g <groups> -t <Timeout> -x <Exclude> -n <Concurrency> -d`

Alternatively, you can run tests in docker:

mvn docker:start -Dtest.args="-s <suites> -g <groups> -t <Timeout> -x <Exclude> -n <Concurrency> -d"

Example:

Contributing

We encourage contributions from users! You can fix bugs, make enhancements or add new tests. Create a PR here on GitHub for your change.

Refer to CONTRIBUTING.md for details on the test framework structure and instructions on how to contribute.

License

Licensed under the Apache License 2.0. Please see LICENSE.md