ClickHouse/dbms/tests/integration
2017-09-01 20:05:24 +03:00
..
helpers added tests [#CLICKHOUSE-3031] 2017-08-30 21:30:57 +03:00
test_cross_replication cosmetics [#CLICKHOUSE-1979] 2017-06-16 21:35:49 +03:00
test_delayed_replica_failover Fix false IOError messages in integration tests log. [#CLICKHOUSE-2] 2017-08-14 14:49:30 +03:00
test_dictionaries Add useful .gitignore. [#CLICKHOUSE-2] 2017-08-14 15:03:43 +03:00
test_distributed_ddl Add ability to run an integration test env without test runs. [#CLICKHOUSE-2] 2017-08-25 16:51:12 +03:00
test_extreme_deduplication Fix integration tests. [#CLICKHOUSE-3173] 2017-07-27 11:19:20 +03:00
test_graphite_merge_tree Updated integration tests. Add integration test for DDL. [#CLICKHOUSE-5] 2017-06-01 13:49:21 +03:00
test_insert_into_distributed added tests [#CLICKHOUSE-3245] 2017-08-23 15:44:18 +03:00
test_merge_table_over_distributed rewrote rewriting of SELECT query in StorageMerge with WITH statement 2017-08-12 00:01:28 +03:00
test_server_initialization attempt to fix integration tests 2017-07-11 20:56:17 +03:00
test_sync_insert_into_distributed added tests for synchronous insert into distributed table [#CLICKHOUSE-3033] 2017-07-26 17:41:21 +03:00
test_system_queries Use only one cache in DNSCache. Add requested changes. [#CLICKHOUSE-2931] 2017-09-01 20:05:24 +03:00
test_zookeeper_config replaced tabs to spaces in config files [#CLICKHOUSE-3031] 2017-08-30 21:30:57 +03:00
.gitignore Fix trying to load database.sql from incorrect path. [#CLICKHOUSE-3044] 2017-06-16 19:08:24 +03:00
conftest.py ClickHouse integration tests. [#CLICKHOUSE-2821] 2017-05-22 17:56:41 +04:00
pytest.ini ClickHouse integration tests. [#CLICKHOUSE-2821] 2017-05-22 17:56:41 +04:00
README.md Updated integration tests. Add integration test for DDL. [#CLICKHOUSE-5] 2017-06-01 13:49:21 +03:00

ClickHouse integration tests

This directory contains tests that involve several ClickHouse instances, custom configs, ZooKeeper, etc.

Running

Prerequisites:

  • Ubuntu 14.04 (Trusty).
  • docker. Minimum required API version: 1.25, check with docker version.
  • pip. To install: sudo apt-get install python-pip
  • py.test testing framework. To install: sudo -H pip install pytest
  • docker-compose and additional python libraries. To install: sudo -H pip install docker-compose docker dicttoxml

If you want to run the tests under a non-privileged user, you must add this user to docker group: sudo usermod -aG docker $USER and re-login.

Run the tests with the pytest command. To select which tests to run, use: pytest -k <test_name_pattern>

By default tests are run with system-wide client binary, server binary and base configs. To change that, set the following environment variables:

  • CLICKHOUSE_TESTS_SERVER_BIN_PATH to choose the server binary.
  • CLICKHOUSE_TESTS_CLIENT_BIN_PATH to choose the client binary.
  • CLICKHOUSE_TESTS_BASE_CONFIG_DIR to choose the directory from which base configs (config.xml and users.xml) are taken.

Adding new tests

To add new test named foo, create a directory test_foo with an empty __init__.py and a file named test.py containing tests in it. All functions with names starting with test will become test cases.

helpers directory contains utilities for:

  • Launching a ClickHouse cluster with or without ZooKeeper indocker containers.
  • Sending queries to launched instances.
  • Introducing network failures such as severing network link between two instances.

To assert that two TSV files must be equal, wrap them in the TSV class and use the regular assert statement. Example: assert TSV(result) == TSV(reference). In case the assertion fails, pytest will automagically detect the types of variables and only the small diff of two files is printed.