f315e5079b
* 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) * Links to nowhere check at least for English * use f string * More complete es translation
3.9 KiB
Archivos de configuración
ClickHouse admite la administración de configuración de varios archivos. El archivo de configuración del servidor principal es /etc/clickhouse-server/config.xml. Otros archivos deben estar en el /etc/clickhouse-server/config.d Directorio.
!!! note "Nota"
Todos los archivos de configuración deben estar en formato XML. Además, deben tener el mismo elemento raíz, generalmente <yandex>.
Algunos valores especificados en el archivo de configuración principal se pueden anular en otros archivos de configuración. El replace o remove se pueden especificar atributos para los elementos de estos archivos de configuración.
Si no se especifica ninguno, combina el contenido de los elementos de forma recursiva, reemplazando los valores de los elementos secundarios duplicados.
Si replace se especifica, reemplaza todo el elemento por el especificado.
Si remove se especifica, elimina el elemento.
La configuración también puede definir “substitutions”. Si un elemento tiene el incl atributo, la sustitución correspondiente del archivo se utilizará como el valor. De forma predeterminada, la ruta al archivo con sustituciones es /etc/metrika.xml. Esto se puede cambiar en el include_from elemento en la configuración del servidor. Los valores de sustitución se especifican en /yandex/substitution_name elementos en este archivo. Si una sustitución especificada en incl No existe, se registra en el registro. Para evitar que ClickHouse registre las sustituciones que faltan, especifique optional="true" atributo (por ejemplo, ajustes para macro).
Las sustituciones también se pueden realizar desde ZooKeeper. Para hacer esto, especifique el atributo from_zk = "/path/to/node". El valor del elemento se sustituye por el contenido del nodo en /path/to/node en ZooKeeper. También puede colocar un subárbol XML completo en el nodo ZooKeeper y se insertará completamente en el elemento de origen.
El config.xml file puede especificar una configuración separada con configuraciones de usuario, perfiles y cuotas. La ruta relativa a esta configuración se establece en el ‘users_config’ elemento. Por defecto, es users.xml. Si users_config se omite, la configuración de usuario, los perfiles y las cuotas se especifican directamente en config.xml.
Además, users_config puede tener anulaciones en los archivos users_config.d Directorio (por ejemplo, users.d) y sustituciones. Por ejemplo, puede tener un archivo de configuración separado para cada usuario como este:
$ cat /etc/clickhouse-server/users.d/alice.xml
<yandex>
<users>
<alice>
<profile>analytics</profile>
<networks>
<ip>::/0</ip>
</networks>
<password_sha256_hex>...</password_sha256_hex>
<quota>analytics</quota>
</alice>
</users>
</yandex>
Para cada archivo de configuración, el servidor también genera file-preprocessed.xml archivos al iniciar. Estos archivos contienen todas las sustituciones y anulaciones completadas, y están destinados para uso informativo. Si se utilizaron sustituciones de ZooKeeper en los archivos de configuración pero ZooKeeper no está disponible en el inicio del servidor, el servidor carga la configuración desde el archivo preprocesado.
El servidor realiza un seguimiento de los cambios en los archivos de configuración, así como archivos y nodos ZooKeeper que se utilizaron al realizar sustituciones y anulaciones, y vuelve a cargar la configuración de los usuarios y clústeres sobre la marcha. Esto significa que puede modificar el clúster, los usuarios y su configuración sin reiniciar el servidor.