ClickHouse/docs/es/operations/utils/clickhouse-benchmark.md

Sistema abierto.

Se conecta a un servidor ClickHouse y envía repetidamente las consultas especificadas.

Sintaxis:

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

o

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

Si desea enviar un conjunto de consultas, cree un archivo de texto y coloque cada consulta en la cadena individual de este archivo. Por ejemplo:

SELECT * FROM system.numbers LIMIT 10000000
SELECT 1

Luego pase este archivo a una entrada estándar de clickhouse-benchmark.

clickhouse-benchmark [keys] < queries_file

Claves

• -c N, --concurrency=N — Número de consultas que clickhouse-benchmark se envía simultáneamente. Valor predeterminado: 1.
• -d N, --delay=N — Intervalo en segundos entre informes intermedios (ajuste 0 para deshabilitar informes). Valor predeterminado: 1.
• -h WORD, --host=WORD — Host del servidor. Valor predeterminado: localhost. Para el modo de comparación puedes usar múltiples -h claves.
• -p N, --port=N — Puerto del servidor. Valor predeterminado: 9000. Para el modo de comparación puedes usar múltiples -p claves.
• -i N, --iterations=N — Número Total de consultas. Valor predeterminado: 0.
• -r, --randomize - Orden aleatorio de ejecución de consultas si hay más de una consulta de entrada.
• -s, --secure — Usando la conexión TLS.
• -t N, --timelimit=N — Límite de tiempo en segundos. clickhouse-benchmark detiene el envío de consultas cuando se alcanza el límite de tiempo especificado. Valor predeterminado: 0 (límite de tiempo desactivado).
• --confidence=N — Nivel de confianza para la prueba T. Valores posibles: 0 (80%), 1 (90%), 2 (95%), 3 (98%), 4 (99%), 5 (99.5%). Valor predeterminado: 5. En el modo de comparación clickhouse-benchmark realiza el Examen t independiente de dos muestras para estudiantes para determinar si las dos distribuciones no son diferentes con el nivel de confianza seleccionado.
• --cumulative — Impresión de datos acumulativos en lugar de datos por intervalo.
• --database=DATABASE_NAME — Nombre de base de datos ClickHouse. Valor predeterminado: default.
• --json=FILEPATH — Salida JSON. Cuando se establece la clave, clickhouse-benchmark " resultados de la búsqueda relacionados
• --user=USERNAME — Nombre de usuario de ClickHouse. Valor predeterminado: default.
• --password=PSWD — Contraseña de usuario de ClickHouse. Valor predeterminado: cadena vacía.
• --stacktrace — Pila trazas de salida. Cuando se establece la clave, clickhouse-bencmark las salidas acumulan rastros de excepciones.
• --stage=WORD - Etapa de procesamiento de consultas en el servidor. ClickHouse detiene el procesamiento de consultas y devuelve la respuesta a clickhouse-benchmark en la etapa especificada. Valores posibles: complete, fetch_columns, with_mergeable_state. Valor predeterminado: complete.
• --help — Muestra el mensaje de ayuda.

Si desea aplicar alguna configuración para consultas, páselas como una clave --<session setting name>= SETTING_VALUE. Por ejemplo, --max_memory_usage=1048576.

Salida

Predeterminada, clickhouse-benchmark Informes para cada --delay intervalo.

Ejemplo del informe:

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.

En el informe puedes encontrar:

• Número de consultas en el Queries executed: campo.

• Cadena de estado que contiene (en orden):

  • Punto final del servidor ClickHouse.
  • Número de consultas procesadas.
  • QPS: QPS: ¿Cuántas consultas realizó el servidor por segundo durante un período --delay argumento.
  • RPS: ¿Cuántas filas lee el servidor por segundo durante un período --delay argumento.
  • MiB/s: ¿Cuántos mebibytes servidor leído por segundo durante un período especificado en el --delay argumento.
  • resultado RPS: ¿Cuántas filas colocadas por el servidor al resultado de una consulta por segundo durante un período --delay argumento.
  • resultado MiB/s. ¿Cuántos mebibytes colocados por el servidor al resultado de una consulta por segundo durante un período especificado en el --delay argumento.

• Percentiles de tiempo de ejecución de consultas.

Modo de comparación

clickhouse-benchmark puede comparar el rendimiento de dos servidores ClickHouse en ejecución.

Para utilizar el modo de comparación, especifique los puntos finales de ambos servidores --host, --port claves. Las claves coinciden entre sí por posición en la lista de argumentos, la primera --host se empareja con la primera --port y así sucesivamente. clickhouse-benchmark establece conexiones a ambos servidores, luego envía consultas. Cada consulta dirigida a un servidor seleccionado al azar. Los resultados se muestran para cada servidor por separado.

Ejemplo

$ echo "SELECT * FROM system.numbers LIMIT 10000000 OFFSET 10000000" | clickhouse-benchmark -i 10

Loaded 1 queries.

Queries executed: 6.

localhost:9000, queries 6, QPS: 6.153, RPS: 123398340.957, MiB/s: 941.455, result RPS: 61532982.200, result MiB/s: 469.459.

0.000%      0.159 sec.
10.000%     0.159 sec.
20.000%     0.159 sec.
30.000%     0.160 sec.
40.000%     0.160 sec.
50.000%     0.162 sec.
60.000%     0.164 sec.
70.000%     0.165 sec.
80.000%     0.166 sec.
90.000%     0.166 sec.
95.000%     0.167 sec.
99.000%     0.167 sec.
99.900%     0.167 sec.
99.990%     0.167 sec.



Queries executed: 10.

localhost:9000, queries 10, QPS: 6.082, RPS: 121959604.568, MiB/s: 930.478, result RPS: 60815551.642, result MiB/s: 463.986.

0.000%      0.159 sec.
10.000%     0.159 sec.
20.000%     0.160 sec.
30.000%     0.163 sec.
40.000%     0.164 sec.
50.000%     0.165 sec.
60.000%     0.166 sec.
70.000%     0.166 sec.
80.000%     0.167 sec.
90.000%     0.167 sec.
95.000%     0.170 sec.
99.000%     0.172 sec.
99.900%     0.172 sec.
99.990%     0.172 sec.