ClickHouse/docs/es/operations/server_settings/settings.md
Ivan Blinkov 2e1f6bc56d
[experimental] add "es" docs language as machine translated draft (#9787)
* replace exit with assert in test_single_page

* improve save_raw_single_page docs option

* More grammar fixes

* "Built from" link in new tab

* fix mistype

* Example of include in docs

* add anchor to meeting form

* Draft of translation helper

* WIP on translation helper

* Replace some fa docs content with machine translation

* add normalize-en-markdown.sh

* normalize some en markdown

* normalize some en markdown

* admonition support

* normalize

* normalize

* normalize

* support wide tables

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* normalize

* lightly edited machine translation of introdpection.md

* lightly edited machhine translation of lazy.md

* WIP on translation utils

* Normalize ru docs

* Normalize other languages

* some fixes

* WIP on normalize/translate tools

* add requirements.txt

* [experimental] add es docs language as machine translated draft

* remove duplicate script

* Back to wider tab-stop (narrow renders not so well)
2020-03-21 07:11:51 +03:00

32 KiB
Raw Blame History

Configuración del servidor

builtin_dictionaries_reload_interval

El intervalo en segundos antes de volver a cargar los diccionarios integrados.

ClickHouse recarga los diccionarios incorporados cada x segundos. Esto hace posible editar diccionarios “on the fly” sin reiniciar el servidor.

Valor predeterminado: 3600.

Ejemplo

<builtin_dictionaries_reload_interval>3600</builtin_dictionaries_reload_interval>

compresión

Ajustes de compresión de datos para Método de codificación de datos:-mesas de motor.

!!! warning "Advertencia" No lo use si acaba de comenzar a usar ClickHouse.

Plantilla de configuración:

<compression>
    <case>
      <min_part_size>...</min_part_size>
      <min_part_size_ratio>...</min_part_size_ratio>
      <method>...</method>
    </case>
    ...
</compression>

<case> campo:

  • min_part_size El tamaño mínimo de una parte de datos.
  • min_part_size_ratio La relación entre el tamaño de la parte de datos y el tamaño de la tabla.
  • method Método de compresión. Valores aceptables: lz4 o zstd.

Puede configurar múltiples <case> apartado.

Acciones cuando se cumplen las condiciones:

  • Si un elemento de datos coincide con un conjunto de condiciones, ClickHouse utiliza el método de compresión especificado.
  • Si un elemento de datos coincide con varios conjuntos de condiciones, ClickHouse utiliza el primer conjunto de condiciones coincidente.

Si no se cumplen condiciones para un elemento de datos, ClickHouse utiliza el lz4 compresión.

Ejemplo

<compression incl="clickhouse_compression">
    <case>
        <min_part_size>10000000000</min_part_size>
        <min_part_size_ratio>0.01</min_part_size_ratio>
        <method>zstd</method>
    </case>
</compression>

default_database

La base de datos predeterminada.

Para obtener una lista de bases de datos, MOSTRAR BASAS DE DATOS consulta.

Ejemplo

<default_database>default</default_database>

default_profile

Perfil de configuración predeterminado.

Los perfiles de configuración se encuentran en el archivo especificado en el parámetro user_config.

Ejemplo

<default_profile>default</default_profile>

Diccionarios_config

La ruta de acceso al archivo de configuración para diccionarios externos.

Camino:

  • Especifique la ruta absoluta o la ruta relativa al archivo de configuración del servidor.
  • La ruta puede contener comodines * y ?.

Ver también “Diccionarios externos”.

Ejemplo

<dictionaries_config>*_dictionary.xml</dictionaries_config>

Diccionarios_lazy_load

La carga perezosa de los diccionarios.

Si true, entonces cada diccionario es creado en el primer uso. Si se produce un error en la creación del diccionario, la función que estaba utilizando el diccionario produce una excepción.

Si false, todos los diccionarios se crean cuando se inicia el servidor, y si hay un error, el servidor se apaga.

El valor predeterminado es true.

Ejemplo

<dictionaries_lazy_load>true</dictionaries_lazy_load>

format_schema_path

La ruta de acceso al directorio con los esquemas para los datos de entrada, como los esquemas CapnProto formato.

Ejemplo

  <!-- Directory containing schema files for various input formats. -->
  <format_schema_path>format_schemas/</format_schema_path>

grafito

Envío de datos a Grafito.

Configuración:

  • host El servidor de grafito.
  • port: el puerto del servidor Graphite.
  • intervalo El intervalo para el envío, en segundos.
  • timeout El tiempo de espera para el envío de datos, en segundos.
  • root_path Prefijo para las claves.
  • métricas Envío de datos desde el sistema.métricas tabla.
  • eventos Envío de datos deltas acumulados para el período de tiempo sistema.evento tabla.
  • events_cumulative: envío de datos acumulativos desde el sistema.evento tabla.
  • asynchronous_metrics Envío de datos desde el sistema.asynchronous_metrics tabla.

Puede configurar múltiples <graphite> clausula. Por ejemplo, puede usar esto para enviar datos diferentes a intervalos diferentes.

Ejemplo

<graphite>
    <host>localhost</host>
    <port>42000</port>
    <timeout>0.1</timeout>
    <interval>60</interval>
    <root_path>one_min</root_path>
    <metrics>true</metrics>
    <events>true</events>
    <events_cumulative>false</events_cumulative>
    <asynchronous_metrics>true</asynchronous_metrics>
</graphite>

graphite_rollup

Ajustes para reducir los datos de grafito.

Para obtener más información, consulte GraphiteMergeTree.

Ejemplo

<graphite_rollup_example>
    <default>
        <function>max</function>
        <retention>
            <age>0</age>
            <precision>60</precision>
        </retention>
        <retention>
            <age>3600</age>
            <precision>300</precision>
        </retention>
        <retention>
            <age>86400</age>
            <precision>3600</precision>
        </retention>
    </default>
</graphite_rollup_example>

http_port/https_port

El puerto para conectarse al servidor a través de HTTP(s).

Si https_port se especifica, openSSL debe ser configurado.

Si http_port se especifica, la configuración de OpenSSL se ignora incluso si está establecida.

Ejemplo

<https>0000</https>

http_server_default_response

La página que se muestra de forma predeterminada al acceder al servidor HTTP de ClickHouse. El valor predeterminado es “Ok.” (con un avance de línea al final)

Ejemplo

Abrir https://tabix.io/ al acceder http://localhost: http_port.

<http_server_default_response>
  <![CDATA[<html ng-app="SMI2"><head><base href="http://ui.tabix.io/"></head><body><div ui-view="" class="content-ui"></div><script src="http://loader.tabix.io/master.js"></script></body></html>]]>
</http_server_default_response>

include_from

La ruta al archivo con sustituciones.

Para obtener más información, consulte la sección “Archivos de configuración”.

Ejemplo

<include_from>/etc/metrica.xml</include_from>

Interesante

Puerto para el intercambio de datos entre servidores ClickHouse.

Ejemplo

<interserver_http_port>9009</interserver_http_port>

Sistema abierto.

El nombre de host que pueden utilizar otros servidores para acceder a este servidor.

Si se omite, se define de la misma manera que el hostname-f comando.

Útil para separarse de una interfaz de red específica.

Ejemplo

<interserver_http_host>example.yandex.ru</interserver_http_host>

interserver_http_credentials

El nombre de usuario y la contraseña utilizados para replicación con los motores Replicated*. Estas credenciales sólo se utilizan para la comunicación entre réplicas y no están relacionadas con las credenciales de los clientes de ClickHouse. El servidor está comprobando estas credenciales para conectar réplicas y utiliza las mismas credenciales cuando se conecta a otras réplicas. Por lo tanto, estas credenciales deben establecerse igual para todas las réplicas de un clúster. De forma predeterminada, la autenticación no se utiliza.

Esta sección contiene los siguientes parámetros:

  • user — nombre de usuario.
  • password — contraseña.

Ejemplo

<interserver_http_credentials>
    <user>admin</user>
    <password>222</password>
</interserver_http_credentials>

keep_alive_timeout

El número de segundos que ClickHouse espera las solicitudes entrantes antes de cerrar la conexión. El valor predeterminado es de 3 segundos.

Ejemplo

<keep_alive_timeout>3</keep_alive_timeout>

listen_host

Restricción en hosts de los que pueden provenir las solicitudes. Si desea que el servidor responda a todos ellos, especifique ::.

Ejemplos:

<listen_host>::1</listen_host>
<listen_host>127.0.0.1</listen_host>

registrador

Configuración de registro.

Claves:

  • level Nivel de registro. Valores aceptables: trace, debug, information, warning, error.
  • log El archivo de registro. Contiene todas las entradas según level.
  • errorlog Archivo de registro de errores.
  • size Tamaño del archivo. Se aplica a logyerrorlog. Una vez que el archivo alcanza size, ClickHouse archiva y cambia el nombre, y crea un nuevo archivo de registro en su lugar.
  • count: el número de archivos de registro archivados que almacena ClickHouse.

Ejemplo

<logger>
    <level>trace</level>
    <log>/var/log/clickhouse-server/clickhouse-server.log</log>
    <errorlog>/var/log/clickhouse-server/clickhouse-server.err.log</errorlog>
    <size>1000M</size>
    <count>10</count>
</logger>

También se admite la escritura en el syslog. Config ejemplo:

<logger>
    <use_syslog>1</use_syslog>
    <syslog>
        <address>syslog.remote:10514</address>
        <hostname>myhost.local</hostname>
        <facility>LOG_LOCAL6</facility>
        <format>syslog</format>
    </syslog>
</logger>

Claves:

  • use_syslog — Ajuste requerido si desea escribir en el syslog.
  • address — El host[:port] de syslogd. Si se omite, se utiliza el daemon local.
  • hostname — Opcional. El nombre del host desde el que se envían los registros.
  • instalación — La palabra clave syslog facility en letras mayúsculas con el “LOG_” prefijo: (LOG_USER, LOG_DAEMON, LOG_LOCAL3 y así sucesivamente). Valor predeterminado: LOG_USER si address se especifica, LOG_DAEMON otherwise.
  • format Formato de mensaje. Valores posibles: bsd y syslog.

macro

Sustituciones de parámetros para tablas replicadas.

Se puede omitir si no se utilizan tablas replicadas.

Para obtener más información, consulte la sección “Creación de tablas replicadas”.

Ejemplo

<macros incl="macros" optional="true" />

Método de codificación de datos:

Tamaño aproximado (en bytes) de la memoria caché de marcas utilizadas por los motores de Método de codificación de datos: familia.

La memoria caché se comparte para el servidor y la memoria se asigna según sea necesario. El tamaño de la memoria caché debe ser al menos 5368709120.

Ejemplo

<mark_cache_size>5368709120</mark_cache_size>

max_concurrent_queries

El número máximo de solicitudes procesadas simultáneamente.

Ejemplo

<max_concurrent_queries>100</max_concurrent_queries>

max_connections

El número máximo de conexiones entrantes.

Ejemplo

<max_connections>4096</max_connections>

max_open_files

El número máximo de archivos abiertos.

Predeterminada: maximum.

Recomendamos usar esta opción en Mac OS X desde el getrlimit() función devuelve un valor incorrecto.

Ejemplo

<max_open_files>262144</max_open_files>

max_table_size_to_drop

Restricción en la eliminación de tablas.

Si el tamaño de un Método de codificación de datos: mesa excede max_table_size_to_drop (en bytes), no puede eliminarlo mediante una consulta DROP.

Si aún necesita eliminar la tabla sin reiniciar el servidor ClickHouse, cree el <clickhouse-path>/flags/force_drop_table y ejecute la consulta DROP.

Valor predeterminado: 50 GB.

El valor 0 significa que puede eliminar todas las tablas sin restricciones.

Ejemplo

<max_table_size_to_drop>0</max_table_size_to_drop>

merge_tree

Ajuste fino para tablas en el Método de codificación de datos:.

Para obtener más información, vea MergeTreeSettings.h archivo de encabezado.

Ejemplo

<merge_tree>
    <max_suspicious_broken_parts>5</max_suspicious_broken_parts>
</merge_tree>

openSSL

Configuración cliente/servidor SSL.

El soporte para SSL es proporcionado por el libpoco biblioteca. La interfaz se describe en el archivo Nombre de la red inalámbrica (SSID):h

Claves para la configuración del servidor/cliente:

  • privateKeyFile: la ruta de acceso al archivo con la clave secreta del certificado PEM. El archivo puede contener una clave y un certificado al mismo tiempo.
  • certificateFile: la ruta de acceso al archivo de certificado cliente/servidor en formato PEM. Puede omitirlo si privateKeyFile contiene el certificado.
  • caConfig: la ruta de acceso al archivo o directorio que contiene certificados raíz de confianza.
  • verificationMode: el método para verificar los certificados del nodo. Los detalles están en la descripción del Contexto clase. Valores posibles: none, relaxed, strict, once.
  • Profundidad de verificación: la longitud máxima de la cadena de verificación. La verificación fallará si la longitud de la cadena del certificado supera el valor establecido.
  • loadDefaultCAFile: indica que se usarán certificados de CA integrados para OpenSSL. Valores aceptables: true, false. |
  • cipherList: encriptaciones OpenSSL compatibles. Por ejemplo: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH.
  • cacheSessions: habilita o deshabilita las sesiones de almacenamiento en caché. Debe usarse en combinación con sessionIdContext. Valores aceptables: true, false.
  • sessionIdContext: un conjunto único de caracteres aleatorios que el servidor agrega a cada identificador generado. La longitud de la cuerda no debe exceder SSL_MAX_SSL_SESSION_ID_LENGTH. Este parámetro siempre se recomienda ya que ayuda a evitar problemas tanto si el servidor almacena en caché la sesión como si el cliente solicita el almacenamiento en caché. Valor predeterminado: ${application.name}.
  • sessionCacheSize: el número máximo de sesiones que el servidor almacena en caché. Valor predeterminado: 1024*20. 0 Sesiones ilimitadas.
  • sessionTimeout - Tiempo para almacenar en caché la sesión en el servidor.
  • extendedVerification : la verificación extendida automáticamente de los certificados después de que finalice la sesión. Valores aceptables: true, false.
  • requireTLSv1: requiere una conexión TLSv1. Valores aceptables: true, false.
  • requireTLSv1_1: requiere una conexión TLSv1.1. Valores aceptables: true, false.
  • requireTLSv1: requiere una conexión TLSv1.2. Valores aceptables: true, false.
  • fips: activa el modo FIPS OpenSSL. Se admite si la versión OpenSSL de la biblioteca admite FIPS.
  • privateKeyPassphraseHandler: clase (subclase PrivateKeyPassphraseHandler) que solicita la frase de contraseña para acceder a la clave privada. Por ejemplo: <privateKeyPassphraseHandler>, <name>KeyFileHandler</name>, <options><password>test</password></options>, </privateKeyPassphraseHandler>.
  • invalidCertificateHandler: clase (una subclase de CertificateHandler) para verificar certificados no válidos. Por ejemplo: <invalidCertificateHandler> <name>ConsoleCertificateHandler</name> </invalidCertificateHandler> .
  • disableProtocols: protocolos que no pueden usarse.
  • preferServerCiphers: cifras de servidor preferidas en el cliente.

Ejemplo de configuración:

<openSSL>
    <server>
        <!-- openssl req -subj "/CN=localhost" -new -newkey rsa:2048 -days 365 -nodes -x509 -keyout /etc/clickhouse-server/server.key -out /etc/clickhouse-server/server.crt -->
        <certificateFile>/etc/clickhouse-server/server.crt</certificateFile>
        <privateKeyFile>/etc/clickhouse-server/server.key</privateKeyFile>
        <!-- openssl dhparam -out /etc/clickhouse-server/dhparam.pem 4096 -->
        <dhParamsFile>/etc/clickhouse-server/dhparam.pem</dhParamsFile>
        <verificationMode>none</verificationMode>
        <loadDefaultCAFile>true</loadDefaultCAFile>
        <cacheSessions>true</cacheSessions>
        <disableProtocols>sslv2,sslv3</disableProtocols>
        <preferServerCiphers>true</preferServerCiphers>
    </server>
    <client>
        <loadDefaultCAFile>true</loadDefaultCAFile>
        <cacheSessions>true</cacheSessions>
        <disableProtocols>sslv2,sslv3</disableProtocols>
        <preferServerCiphers>true</preferServerCiphers>
        <!-- Use for self-signed: <verificationMode>none</verificationMode> -->
        <invalidCertificateHandler>
            <!-- Use for self-signed: <name>AcceptCertificateHandler</name> -->
            <name>RejectCertificateHandler</name>
        </invalidCertificateHandler>
    </client>
</openSSL>

part_log

Registro de eventos asociados con Método de codificación de datos:. Por ejemplo, agregar o fusionar datos. Puede utilizar el registro para simular algoritmos de combinación y comparar sus características. Puede visualizar el proceso de fusión.

Las consultas se registran en el sistema.part_log tabla, no en un archivo separado. Puede configurar el nombre de esta tabla en el table parámetro (ver más abajo).

Utilice los siguientes parámetros para configurar el registro:

  • database Nombre de la base de datos.
  • table Nombre de la tabla del sistema.
  • partition_by Establece un clave de partición personalizada.
  • flush_interval_milliseconds Intervalo para el vaciado de datos desde el búfer en la memoria a la tabla.

Ejemplo

<part_log>
    <database>system</database>
    <table>part_log</table>
    <partition_by>toMonday(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
</part_log>

camino

La ruta de acceso al directorio que contiene los datos.

!!! note "Nota" La barra diagonal es obligatoria.

Ejemplo

<path>/var/lib/clickhouse/</path>

query_log

Configuración de las consultas de registro recibidas con log_queries=1 configuración.

Las consultas se registran en el sistema.query_log tabla, no en un archivo separado. Puede cambiar el nombre de la tabla en el table parámetro (ver más abajo).

Utilice los siguientes parámetros para configurar el registro:

  • database Nombre de la base de datos.
  • table Nombre de la tabla del sistema en la que se registrarán las consultas.
  • partition_by Establece un clave de partición personalizada para una mesa.
  • flush_interval_milliseconds Intervalo para el vaciado de datos desde el búfer en la memoria a la tabla.

Si la tabla no existe, ClickHouse la creará. Si la estructura del registro de consultas cambió cuando se actualizó el servidor ClickHouse, se cambia el nombre de la tabla con la estructura anterior y se crea una nueva tabla automáticamente.

Ejemplo

<query_log>
    <database>system</database>
    <table>query_log</table>
    <partition_by>toMonday(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
</query_log>

Sistema abierto.

Configuración de subprocesos de registro de consultas recibidas con Log_query_threads = 1 configuración.

Las consultas se registran en el sistema.Sistema abierto. tabla, no en un archivo separado. Puede cambiar el nombre de la tabla en el table parámetro (ver más abajo).

Utilice los siguientes parámetros para configurar el registro:

  • database Nombre de la base de datos.
  • table Nombre de la tabla del sistema en la que se registrarán las consultas.
  • partition_by Establece un clave de partición personalizada para una tabla del sistema.
  • flush_interval_milliseconds Intervalo para el vaciado de datos desde el búfer en la memoria a la tabla.

Si la tabla no existe, ClickHouse la creará. Si la estructura del registro de subprocesos de consulta cambió cuando se actualizó el servidor ClickHouse, se cambia el nombre de la tabla con la estructura anterior y se crea una nueva tabla automáticamente.

Ejemplo

<query_thread_log>
    <database>system</database>
    <table>query_thread_log</table>
    <partition_by>toMonday(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
</query_thread_log>

trace_log

Ajustes para el trace_log operación de la tabla del sistema.

Parámetros:

  • database — Base de datos para almacenar una tabla.
  • table — Nombre de la tabla.
  • partition_byClave de partición personalizada para una tabla del sistema.
  • flush_interval_milliseconds — Intervalo para el vaciado de datos del búfer en la memoria a la tabla.

El archivo de configuración del servidor predeterminado config.xml contiene la siguiente sección de configuración:

<trace_log>
    <database>system</database>
    <table>trace_log</table>
    <partition_by>toYYYYMM(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
</trace_log>

query_masking_rules

Reglas basadas en Regexp, que se aplicarán a las consultas, así como a todos los mensajes de registro antes de almacenarlos en los registros del servidor, system.query_log, system.text_log, system.processes tabla, y en los registros enviados al cliente. Eso permite prevenir fuga de datos sensible de consultas SQL (como nombres, correos electrónicos, identificadores o números de tarjetas de crédito) a los registros.

Ejemplo

<query_masking_rules>
    <rule>
        <name>hide SSN</name>
        <regexp>(^|\D)\d{3}-\d{2}-\d{4}($|\D)</regexp>
        <replace>000-00-0000</replace>
    </rule>
</query_masking_rules>

Campos de configuración:

  • name - nombre de la regla (opcional)
  • regexp - Expresión regular compatible con RE2 (obligatoria)
  • replace - cadena de sustitución para datos confidenciales (opcional, por defecto - seis asteriscos)

Las reglas de enmascaramiento se aplican a toda la consulta (para evitar fugas de datos confidenciales de consultas mal formadas / no analizables).

system.events la tabla tiene contador QueryMaskingRulesMatch que tienen un número total de coincidencias de reglas de enmascaramiento de consultas.

Para consultas distribuidas, cada servidor debe configurarse por separado; de lo contrario, las subconsultas pasan a otros los nodos se almacenarán sin enmascarar.

remote_servers

Configuración de los clústeres utilizados por Distribuido motor de mesa y por el cluster función de la tabla.

Ejemplo

<remote_servers incl="clickhouse_remote_servers" />

Para el valor de la incl atributo, consulte la sección “Archivos de configuración”.

Ver también

Zona horaria

La zona horaria del servidor.

Especificado como un identificador de la IANA para la zona horaria UTC o la ubicación geográfica (por ejemplo, África/Abidjan).

La zona horaria es necesaria para las conversiones entre los formatos String y DateTime cuando los campos DateTime se envían al formato de texto (impreso en la pantalla o en un archivo) y cuando se obtiene DateTime de una cadena. Además, la zona horaria se usa en funciones que funcionan con la hora y la fecha si no recibieron la zona horaria en los parámetros de entrada.

Ejemplo

<timezone>Europe/Moscow</timezone>

Tcp_port

Puerto para comunicarse con clientes a través del protocolo TCP.

Ejemplo

<tcp_port>9000</tcp_port>

Tcp_port_secure

Puerto TCP para una comunicación segura con los clientes. Úselo con OpenSSL configuración.

Valores posibles

Entero positivo.

Valor predeterminado

<tcp_port_secure>9440</tcp_port_secure>

mysql_port

Puerto para comunicarse con clientes a través del protocolo MySQL.

Valores posibles

Entero positivo.

Ejemplo

<mysql_port>9004</mysql_port>

tmp_path

Ruta de acceso a datos temporales para procesar consultas grandes.

!!! note "Nota" La barra diagonal es obligatoria.

Ejemplo

<tmp_path>/var/lib/clickhouse/tmp/</tmp_path>

tmp_policy

Política de storage_configuration para almacenar archivos temporales. Si no se establece tmp_path se utiliza, de lo contrario se ignora.

!!! note "Nota" - move_factor se ignora

  • keep_free_space_bytes se ignora
  • max_data_part_size_bytes se ignora
  • debe tener exactamente un volumen en esa política

Uncompressed_cache_size

Tamaño de la memoria caché (en bytes) para los datos sin comprimir utilizados por los motores de Método de codificación de datos:.

Hay una caché compartida para el servidor. La memoria se asigna a pedido. La caché se usa si la opción Use_uncompressed_cache está habilitado.

La caché sin comprimir es ventajosa para consultas muy cortas en casos individuales.

Ejemplo

<uncompressed_cache_size>8589934592</uncompressed_cache_size>

user_files_path

El directorio con archivos de usuario. Utilizado en la función de tabla file().

Ejemplo

<user_files_path>/var/lib/clickhouse/user_files/</user_files_path>

users_config

Ruta de acceso al archivo que contiene:

  • Configuraciones de usuario.
  • Derechos de acceso.
  • Perfiles de configuración.
  • Configuración de cuota.

Ejemplo

<users_config>users.xml</users_config>

Zookeeper

Contiene la configuración que permite a ClickHouse interactuar con ZooKeeper Cluster.

ClickHouse utiliza ZooKeeper para almacenar metadatos de réplicas cuando se utilizan tablas replicadas. Si no se utilizan tablas replicadas, se puede omitir esta sección de parámetros.

Esta sección contiene los siguientes parámetros:

  • node — Punto final ZooKeeper. Puede establecer varios puntos finales.

    Por ejemplo:

    <node index="1">
        <host>example_host</host>
        <port>2181</port>
    </node>
  The `index` attribute specifies the node order when trying to connect to the ZooKeeper cluster.
  • session_timeout — Tiempo de espera máximo para la sesión del cliente en milisegundos.
  • root — El Znode que se utiliza como la raíz de los znodes utilizados por el servidor ClickHouse. Opcional.
  • identity — Usuario y contraseña, que puede ser requerido por ZooKeeper para dar acceso a los znodes solicitados. Opcional.

Ejemplo de configuración

<zookeeper>
    <node>
        <host>example1</host>
        <port>2181</port>
    </node>
    <node>
        <host>example2</host>
        <port>2181</port>
    </node>
    <session_timeout_ms>30000</session_timeout_ms>
    <operation_timeout_ms>10000</operation_timeout_ms>
    <!-- Optional. Chroot suffix. Should exist. -->
    <root>/path/to/zookeeper/node</root>
    <!-- Optional. Zookeeper digest ACL string. -->
    <identity>user:password</identity>
</zookeeper>

Ver también

use_minimalistic_part_header_in_zookeeper

Método de almacenamiento para encabezados de parte de datos en ZooKeeper.

Esta configuración sólo se aplica a MergeTree familia. Se puede especificar:

  • A nivel mundial en el merge_tree sección de la config.xml file.

    ClickHouse utiliza la configuración para todas las tablas del servidor. Puede cambiar la configuración en cualquier momento. Las tablas existentes cambian su comportamiento cuando cambia la configuración.

  • Para cada tabla.

    Al crear una tabla, especifique la correspondiente ajuste del motor. El comportamiento de una tabla existente con esta configuración no cambia, incluso si la configuración global cambia.

Valores posibles

  • 0 — Funcionalidad está desactivada.
  • 1 — Funcionalidad está activada.

Si use_minimalistic_part_header_in_zookeeper = 1, entonces repetición las tablas almacenan los encabezados de las partes de datos de forma compacta znode. Si la tabla contiene muchas columnas, este método de almacenamiento reduce significativamente el volumen de los datos almacenados en Zookeeper.

!!! attention "Atención" Después de aplicar use_minimalistic_part_header_in_zookeeper = 1, no puede degradar el servidor ClickHouse a una versión que no admite esta configuración. Tenga cuidado al actualizar ClickHouse en servidores de un clúster. No actualice todos los servidores a la vez. Es más seguro probar nuevas versiones de ClickHouse en un entorno de prueba o solo en unos pocos servidores de un clúster.

  Data part headers already stored with this setting can't be restored to their previous (non-compact) representation.

Valor predeterminado: 0.

disable_internal_dns_cache

Deshabilita la memoria caché DNS interna. Recomendado para operar ClickHouse en sistemas con infraestructura que cambia frecuentemente como Kubernetes.

Valor predeterminado: 0.

dns_cache_update_period

El período de actualización de las direcciones IP almacenadas en la caché DNS interna de ClickHouse (en segundos). La actualización se realiza de forma asíncrona, en un subproceso del sistema separado.

Valor predeterminado: 15.

Artículo Original