ClickHouse/dbms/tests/integration
2018-10-14 12:51:16 +03:00
..
helpers Remove abs path from testing framework 2018-10-14 12:51:16 +03:00
test_cluster_copier Build fixes (#3181) 2018-09-28 17:53:20 +03:00
test_config_substitutions CLICKHOUSE-3894: Fix test_config_substs test 2018-08-27 14:40:01 +03:00
test_cross_replication CLICKHOUSE-3894: Some improvements in flapping tests. Bug fix of ATTACH TABLE xxx ON CLUSTER (previously doesn't work). 2018-09-03 17:06:00 +03:00
test_delayed_replica_failover fix test to conform to the new GROUP BY behaviour on empty tables 2018-03-07 18:09:26 +00:00
test_dictionaries Update test.py 2018-10-09 23:43:52 +03:00
test_distributed_ddl Merge pull request #3251 from CurtizJ/table-db-macros 2018-10-01 21:45:52 +03:00
test_extreme_deduplication CLICKHOUSE-3894: Fixes in tests 2018-09-07 14:51:51 +03:00
test_graphite_merge_tree Fixed nondeterministic merge in GraphiteMergeTree. [#CLICKHOUSE-2860] 2018-01-18 23:30:03 +03:00
test_https_replication CLICKHOUSE-3894: Some improvements in flapping tests. Bug fix of ATTACH TABLE xxx ON CLUSTER (previously doesn't work). 2018-09-03 17:06:00 +03:00
test_insert_into_distributed Fixed potential error #2832 2018-08-10 04:31:55 +03:00
test_insert_into_distributed_sync_async Rewritten and improved sync distributed insert. [#CLICKHOUSE-3346] 2018-02-19 20:26:47 +03:00
test_insert_into_distributed_through_materialized_view add needed file 2018-05-31 21:41:39 +03:00
test_merge_table_over_distributed Fixed Illegal PREWHERE error for Merge tables over Distributed. [#CLICKHOUSE-3637] 2018-03-12 18:14:26 +03:00
test_odbc_interaction Fix odbc table function 2018-09-22 17:58:03 +03:00
test_random_inserts CLICKHOUSE-3894: Fixes in tests 2018-09-07 14:51:51 +03:00
test_recovery_replica CLICKHOUSE-3894: Some improvements in flapping tests. Bug fix of ATTACH TABLE xxx ON CLUSTER (previously doesn't work). 2018-09-03 17:06:00 +03:00
test_replace_partition CLICKHOUSE-3894: Some improvements in flapping tests. Bug fix of ATTACH TABLE xxx ON CLUSTER (previously doesn't work). 2018-09-03 17:06:00 +03:00
test_replicated_mutations CLICKHOUSE-3894: Fixes in tests 2018-09-07 14:51:51 +03:00
test_replication_credentials Remove wrong option 2018-07-27 20:25:51 +03:00
test_server_initialization attempt to fix integration tests 2017-07-11 20:56:17 +03:00
test_storage_kafka CLICKHOUSE-3894: Fix Kafka test 2018-08-27 19:15:39 +03:00
test_storage_mysql CLICKHOUSE-3947 add tests 2018-10-08 18:05:23 +03:00
test_system_queries CLICKHOUSE-3894: Save localhost record 2018-09-03 18:26:11 +03:00
test_zookeeper_config Added test for chroot in ZK [#MDBSUPPORT-204] 2018-07-10 19:14:27 +03:00
.gitignore Fix trying to load database.sql from incorrect path. [#CLICKHOUSE-3044] 2017-06-16 19:08:24 +03:00
CMakeLists.txt Build fixes (#3181) 2018-09-28 17:53:20 +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 Use docker exec to operate on kafka. 2018-07-27 01:24:35 +08:00

ClickHouse integration tests

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

Running

Prerequisites:

  • Ubuntu 14.04 (Trusty) or higher.
  • docker. Minimum required API version: 1.25, check with docker version.

You must install latest Docker from https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/#set-up-the-repository Don't use Docker from your system repository.

  • 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 kazoo PyMySQL

(highly not recommended) If you really want to use OS packages on modern debian/ubuntu instead of "pip": sudo apt install -y docker docker-compose python-pytest python-dicttoxml python-docker python-pymysql python-kazoo

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. (You must close all your sessions (for example, restart your computer)) To check, that you have access to Docker, run docker ps.

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.