본문으로 바로가기
본문으로 바로가기

clickhouse-benchmark

ClickHouse 서버에 연결해 지정한 쿼리를 반복해서 전송합니다.

구문

$ clickhouse-benchmark --query ["single query"] [keys]

또는

$ echo "single query" | clickhouse-benchmark [keys]

또는

$ clickhouse-benchmark [keys] <<< "single query"

일련의 쿼리를 보내려면 텍스트 파일을 하나 만든 다음 이 파일의 각 줄에 쿼리를 하나씩 작성하십시오. 예를 들어:

SELECT * FROM system.numbers LIMIT 10000000;
SELECT 1;

그런 다음 이 파일을 clickhouse-benchmark 표준 입력으로 전달합니다.

clickhouse-benchmark [keys] < queries_file;

Command-line options​

  • --query=QUERY — 실행할 쿼리입니다. 이 매개변수를 전달하지 않으면 clickhouse-benchmark는 표준 입력에서 쿼리를 읽습니다.
  • --query_id=ID — 쿼리 ID입니다.
  • --query_id_prefix=ID_PREFIX — 쿼리 ID 접두사입니다.
  • -c N, --concurrency=N — clickhouse-benchmark가 동시에 전송하는 쿼리 개수입니다. 기본값: 1.
  • -C N, --max_concurrency=N — 지정한 값까지 병렬 쿼리 개수를 점진적으로 증가시키며, 각 동시성 수준마다 하나의 보고서를 생성합니다.
  • --precise — 가중치가 적용된 메트릭을 사용하는 정밀한 구간별 보고를 활성화합니다.
  • -d N, --delay=N — 중간 보고 사이의 간격(초)입니다(보고를 비활성화하려면 0으로 설정). 기본값: 1.
  • -h HOST, --host=HOST — 서버 호스트입니다. 기본값: localhost. 비교 모드에서는 여러 개의 -h 키를 사용할 수 있습니다.
  • -i N, --iterations=N — 전체 쿼리 수입니다. 기본값: 0 (무한 반복).
  • -r, --randomize — 하나 이상의 입력 쿼리가 있을 때 쿼리 실행 순서를 무작위로 섞습니다.
  • -s, --secure — TLS 연결을 사용합니다.
  • -t N, --timelimit=N — 시간 제한(초)입니다. 지정된 시간 제한에 도달하면 clickhouse-benchmark는 쿼리 전송을 중지합니다. 기본값: 0 (시간 제한 없음).
  • --port=N — 서버 포트입니다. 기본값: 9000. 비교 모드에서는 여러 개의 --port 키를 사용할 수 있습니다.
  • --confidence=N — t-검정에 사용할 신뢰 수준입니다. 가능한 값: 0 (80%), 1 (90%), 2 (95%), 3 (98%), 4 (99%), 5 (99.5%). 기본값: 5. 비교 모드에서 clickhouse-benchmark는 선택한 신뢰 수준에서 두 분포가 서로 다르지 않은지를 판단하기 위해 Independent two-sample Student's t-test를 수행합니다.
  • --cumulative — 구간별 데이터 대신 누적 데이터를 출력합니다.
  • --database=DATABASE_NAME — ClickHouse 데이터베이스 이름입니다. 기본값: default.
  • --user=USERNAME — ClickHouse 사용자 이름입니다. 기본값: default.
  • --password=PSWD — ClickHouse 사용자 비밀번호입니다. 기본값: 빈 문자열.
  • --stacktrace — 스택 트레이스를 출력합니다. 이 키가 설정되면 clickhouse-bencmark는 예외의 스택 트레이스를 출력합니다.
  • --stage=WORD — 서버에서의 쿼리 처리 단계입니다. ClickHouse는 지정된 단계에서 쿼리 처리를 중지하고 clickhouse-benchmark에 응답을 반환합니다. 가능한 값: complete, fetch_columns, with_mergeable_state. 기본값: complete.
  • --roundrobin — 서로 다른 --host/--port에 대해 쿼리를 비교하는 대신, 각 쿼리마다 임의의 --host/--port를 하나 선택하여 해당 대상으로 쿼리를 전송합니다.
  • --reconnect=N — 재연결 동작을 제어합니다. 가능한 값: 0 (재연결 안 함), 1 (쿼리마다 재연결), 또는 N (매 N개의 쿼리마다 재연결). 기본값: 0.
  • --max-consecutive-errors=N — 허용되는 연속 오류 개수입니다. 기본값: 0.
  • --ignore-error,--continue_on_errors — 쿼리가 실패하더라도 테스트를 계속합니다.
  • --client-side-time — 서버 측 시간 대신 네트워크 통신을 포함한 시간을 표시합니다. 22.8 이전 서버 버전에서는 항상 클라이언트 측 시간을 표시한다는 점에 유의해야 합니다.
  • --proto-caps — 데이터 전송에서 청크 처리(청크 분할)를 활성화/비활성화합니다. 선택 가능한 값(쉼표로 구분 가능): chunked_optional, notchunked, notchunked_optional, send_chunked, send_chunked_optional, send_notchunked, send_notchunked_optional, recv_chunked, recv_chunked_optional, recv_notchunked, recv_notchunked_optional. 기본값: notchunked.
  • --help — 도움말 메시지를 표시합니다.
  • --verbose — 도움말 메시지의 상세 수준을 높입니다.

쿼리에 일부 settings를 적용하려면 --<session setting name>= SETTING_VALUE 형식의 키로 전달합니다. 예: --max_memory_usage=1048576.

환경 변수 옵션​

사용자 이름, 비밀번호 및 호스트는 환경 변수 CLICKHOUSE_USER, CLICKHOUSE_PASSWORD, CLICKHOUSE_HOST를 통해 설정할 수 있습니다.
명령줄 인수 --user, --password, --host가 설정된 경우 환경 변수보다 우선 적용됩니다.

출력​

기본적으로 clickhouse-benchmark는 각 --delay 간격마다 결과를 출력합니다.

보고서 예시는 다음과 같습니다.

Queries executed: 10.

localhost:9000, queries 10, QPS: 6.772, RPS: 67904487.440, MiB/s: 518.070, result RPS: 67721584.984, result MiB/s: 516.675.

0.000%      0.145 sec.
10.000%     0.146 sec.
20.000%     0.146 sec.
30.000%     0.146 sec.
40.000%     0.147 sec.
50.000%     0.148 sec.
60.000%     0.148 sec.
70.000%     0.148 sec.
80.000%     0.149 sec.
90.000%     0.150 sec.
95.000%     0.150 sec.
99.000%     0.150 sec.
99.900%     0.150 sec.
99.990%     0.150 sec.

보고서에서 다음 정보를 확인할 수 있습니다:

  • Queries executed: 필드에 표시된 쿼리 수.

  • 다음 요소를 (순서대로) 포함하는 상태 문자열:

    • ClickHouse 서버의 엔드포인트.
    • 처리된 쿼리 수.
    • QPS: --delay 인자로 지정된 기간 동안 서버가 1초당 수행한 쿼리 수.
    • RPS: --delay 인자로 지정된 기간 동안 서버가 1초당 읽는 행 수.
    • MiB/s: --delay 인자로 지정된 기간 동안 서버가 1초당 읽는 메비바이트(mebibyte) 수.
    • result RPS: --delay 인자로 지정된 기간 동안 서버가 1초당 쿼리 결과로 반환한 행 수.
    • result MiB/s: --delay 인자로 지정된 기간 동안 서버가 1초당 쿼리 결과로 반환한 메비바이트(mebibyte) 수.

  • 쿼리 실행 시간의 퍼센타일(percentile).

비교 모드​

clickhouse-benchmark는 실행 중인 두 ClickHouse 서버의 성능을 비교할 수 있습니다.

비교 모드를 사용하려면 두 서버의 엔드포인트를 각각 한 쌍의 --host, --port 키로 지정합니다. 키는 명령줄 인수 목록에서의 순서에 따라 서로 짝지어지며, 첫 번째 --host는 첫 번째 --port와 매칭되는 식입니다. clickhouse-benchmark는 두 서버 모두에 대한 연결을 설정한 다음 쿼리를 전송합니다. 각 쿼리는 무작위로 선택된 서버 중 하나로 전송됩니다. 결과는 표 형태로 표시됩니다.

예제​

$ echo "SELECT * FROM system.numbers LIMIT 10000000 OFFSET 10000000" | clickhouse-benchmark --host=localhost --port=9001 --host=localhost --port=9000 -i 10

Loaded 1 queries.

Queries executed: 5.

localhost:9001, queries 2, QPS: 3.764, RPS: 75446929.370, MiB/s: 575.614, result RPS: 37639659.982, result MiB/s: 287.168.
localhost:9000, queries 3, QPS: 3.815, RPS: 76466659.385, MiB/s: 583.394, result RPS: 38148392.297, result MiB/s: 291.049.

0.000%          0.258 sec.      0.250 sec.
10.000%         0.258 sec.      0.250 sec.
20.000%         0.258 sec.      0.250 sec.
30.000%         0.258 sec.      0.267 sec.
40.000%         0.258 sec.      0.267 sec.
50.000%         0.273 sec.      0.267 sec.
60.000%         0.273 sec.      0.267 sec.
70.000%         0.273 sec.      0.267 sec.
80.000%         0.273 sec.      0.269 sec.
90.000%         0.273 sec.      0.269 sec.
95.000%         0.273 sec.      0.269 sec.
99.000%         0.273 sec.      0.269 sec.
99.900%         0.273 sec.      0.269 sec.
99.990%         0.273 sec.      0.269 sec.

No difference proven at 99.5% confidence