ClickHouse/docs/fr/operations/server-configuration-parameters/settings.md

873 lines
33 KiB
Markdown
Raw Normal View History

2020-03-30 12:48:55 +00:00
---
machine_translated: true
2020-04-04 09:15:31 +00:00
machine_translated_rev: f865c9653f9df092694258e0ccdd733c339112f5
toc_priority: 57
toc_title: "Les Param\xE8tres Du Serveur"
2020-03-30 12:48:55 +00:00
---
# Les Paramètres Du Serveur {#server-settings}
## builtin\_dictionaries\_reload\_interval {#builtin-dictionaries-reload-interval}
Lintervalle en secondes avant de recharger les dictionnaires intégrés.
2020-03-30 12:48:55 +00:00
Clickhouse recharge les dictionnaires intégrés toutes les X secondes. Cela permet déditer des dictionnaires “on the fly” sans redémarrer le serveur.
2020-03-30 12:48:55 +00:00
Valeur par défaut: 3600.
**Exemple**
``` xml
<builtin_dictionaries_reload_interval>3600</builtin_dictionaries_reload_interval>
```
## compression {#server-settings-compression}
Paramètres de compression de données pour [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md)-tables de moteur.
2020-03-30 12:48:55 +00:00
!!! warning "Avertissement"
Ne lutilisez pas si vous venez de commencer à utiliser ClickHouse.
2020-03-30 12:48:55 +00:00
Modèle de Configuration:
``` xml
<compression>
<case>
<min_part_size>...</min_part_size>
<min_part_size_ratio>...</min_part_size_ratio>
<method>...</method>
</case>
...
</compression>
```
`<case>` Fields:
- `min_part_size` The minimum size of a data part.
- `min_part_size_ratio` The ratio of the data part size to the table size.
- `method` Compression method. Acceptable values: `lz4` ou `zstd`.
Vous pouvez configurer plusieurs `<case>` section.
Actions lorsque les conditions sont remplies:
- Si une partie de données correspond à un ensemble de conditions, ClickHouse utilise la méthode de compression spécifiée.
- Si une partie de données correspond à plusieurs ensembles de conditions, ClickHouse utilise le premier ensemble de conditions correspondant.
Si aucune condition nest remplie pour une partie de données, ClickHouse utilise `lz4` compression.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<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 {#default-database}
La base de données par défaut.
Pour obtenir une liste de bases de données, utilisez la [SHOW DATABASES](../../sql-reference/statements/show.md#show-databases) requête.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<default_database>default</default_database>
```
## default\_profile {#default-profile}
Profil des paramètres par défaut.
Les paramètres des profils sont situés dans le fichier spécifié dans le paramètre `user_config`.
**Exemple**
``` xml
<default_profile>default</default_profile>
```
2020-04-04 09:15:31 +00:00
## dictionaries\_config {#server_configuration_parameters-dictionaries_config}
2020-03-30 12:48:55 +00:00
Chemin daccès au fichier de configuration des dictionnaires externes.
2020-03-30 12:48:55 +00:00
Chemin:
- Spécifiez le chemin absolu ou le chemin relatif au fichier de configuration du serveur.
- Le chemin peut contenir des caractères génériques \* et ?.
Voir aussi “[Dictionnaires externes](../../sql-reference/dictionaries/external-dictionaries/external-dicts.md)”.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<dictionaries_config>*_dictionary.xml</dictionaries_config>
```
2020-04-04 09:15:31 +00:00
## dictionaries\_lazy\_load {#server_configuration_parameters-dictionaries_lazy_load}
2020-03-30 12:48:55 +00:00
Chargement paresseux des dictionnaires.
Si `true` chaque dictionnaire est créé lors de la première utilisation. Si la création du dictionnaire a échoué, la fonction qui utilisait le dictionnaire lève une exception.
Si `false`, tous les dictionnaires sont créés lorsque le serveur démarre, et si il y a une erreur, le serveur sarrête.
2020-03-30 12:48:55 +00:00
La valeur par défaut est `true`.
**Exemple**
``` xml
<dictionaries_lazy_load>true</dictionaries_lazy_load>
```
2020-04-04 09:15:31 +00:00
## format\_schema\_path {#server_configuration_parameters-format_schema_path}
2020-03-30 12:48:55 +00:00
Le chemin daccès au répertoire avec des régimes pour lentrée de données, tels que les schémas pour l [CapnProto](../../interfaces/formats.md#capnproto) format.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<!-- Directory containing schema files for various input formats. -->
<format_schema_path>format_schemas/</format_schema_path>
```
2020-04-04 09:15:31 +00:00
## graphite {#server_configuration_parameters-graphite}
2020-03-30 12:48:55 +00:00
Envoi de données à [Graphite](https://github.com/graphite-project).
Paramètre:
- host The Graphite server.
- port The port on the Graphite server.
- interval The interval for sending, in seconds.
- timeout The timeout for sending data, in seconds.
- root\_path Prefix for keys.
- metrics Sending data from the [système.métrique](../../operations/system-tables.md#system_tables-metrics) table.
- events Sending deltas data accumulated for the time period from the [système.événement](../../operations/system-tables.md#system_tables-events) table.
- events\_cumulative Sending cumulative data from the [système.événement](../../operations/system-tables.md#system_tables-events) table.
- asynchronous\_metrics Sending data from the [système.asynchronous\_metrics](../../operations/system-tables.md#system_tables-asynchronous_metrics) table.
2020-03-30 12:48:55 +00:00
Vous pouvez configurer plusieurs `<graphite>` clause. Par exemple, vous pouvez lutiliser pour envoyer des données différentes à différents intervalles.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## graphite\_rollup {#server_configuration_parameters-graphite-rollup}
2020-03-30 12:48:55 +00:00
Paramètres pour lamincissement des données pour le Graphite.
2020-03-30 12:48:55 +00:00
Pour plus de détails, voir [GraphiteMergeTree](../../engines/table-engines/mergetree-family/graphitemergetree.md).
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<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 {#http-porthttps-port}
Port de connexion au serveur via HTTP(S).
2020-04-04 09:15:31 +00:00
Si `https_port` est spécifié, [openSSL](#server_configuration_parameters-openssl) doit être configuré.
2020-03-30 12:48:55 +00:00
Si `http_port` est spécifié, la configuration OpenSSL est ignorée même si elle est définie.
**Exemple**
``` xml
<https>0000</https>
```
2020-04-04 09:15:31 +00:00
## http\_server\_default\_response {#server_configuration_parameters-http_server_default_response}
2020-03-30 12:48:55 +00:00
Page affichée par défaut lorsque vous accédez au serveur HTTP(S) ClickHouse.
La valeur par défaut est “Ok.” (avec un saut de ligne à la fin)
**Exemple**
Ouvrir `https://tabix.io/` lors de laccès à `http://localhost: http_port`.
2020-03-30 12:48:55 +00:00
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## include\_from {#server_configuration_parameters-include_from}
2020-03-30 12:48:55 +00:00
Le chemin daccès au fichier avec des substitutions.
2020-03-30 12:48:55 +00:00
Pour plus dinformations, consultez la section “[Fichiers de Configuration](../configuration-files.md#configuration_files)”.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<include_from>/etc/metrica.xml</include_from>
```
## interserver\_http\_port {#interserver-http-port}
Port pour léchange de données entre les serveurs ClickHouse.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<interserver_http_port>9009</interserver_http_port>
```
## interserver\_http\_host {#interserver-http-host}
Le nom dhôte qui peut être utilisé par dautres serveurs pour accéder à ce serveur.
2020-03-30 12:48:55 +00:00
Si elle est omise, elle est définie de la même manière que `hostname-f` commande.
Utile pour rompre avec une interface réseau spécifique.
**Exemple**
``` xml
<interserver_http_host>example.yandex.ru</interserver_http_host>
```
## interserver\_http\_credentials {#server-settings-interserver-http-credentials}
Le nom dutilisateur et le mot de passe utilisés pour [réplication](../../engines/table-engines/mergetree-family/replication.md) avec les moteurs \* répliqués. Ces informations didentification sont utilisées uniquement pour la communication entre les répliques et ne sont pas liées aux informations didentification des clients ClickHouse. Le serveur vérifie ces informations didentification pour la connexion de répliques et utilise les mêmes informations didentification lors de la connexion à dautres répliques. Donc, ces informations didentification doivent être identiques pour tous les réplicas dans un cluster.
Par défaut, lauthentification nest pas utilisé.
2020-03-30 12:48:55 +00:00
Cette section contient les paramètres suivants:
- `user` — username.
- `password` — password.
**Exemple**
``` xml
<interserver_http_credentials>
<user>admin</user>
<password>222</password>
</interserver_http_credentials>
```
## keep\_alive\_timeout {#keep-alive-timeout}
Le nombre de secondes que ClickHouse attend pour les demandes entrantes avant de fermer la connexion. Par défaut est de 3 secondes.
**Exemple**
``` xml
<keep_alive_timeout>3</keep_alive_timeout>
```
2020-04-04 09:15:31 +00:00
## listen\_host {#server_configuration_parameters-listen_host}
2020-03-30 12:48:55 +00:00
Restriction sur les hôtes dont les demandes peuvent provenir. Si vous voulez que le serveur réponde à tous, spécifiez `::`.
Exemple:
``` xml
<listen_host>::1</listen_host>
<listen_host>127.0.0.1</listen_host>
```
2020-04-04 09:15:31 +00:00
## enregistreur {#server_configuration_parameters-logger}
2020-03-30 12:48:55 +00:00
Paramètres de journalisation.
Touches:
- level Logging level. Acceptable values: `trace`, `debug`, `information`, `warning`, `error`.
- log The log file. Contains all the entries according to `level`.
- errorlog Error log file.
- size Size of the file. Applies to `log`et`errorlog`. Une fois que le fichier atteint `size`, Archives ClickHouse et le renomme, et crée un nouveau fichier journal à sa place.
- count The number of archived log files that ClickHouse stores.
**Exemple**
``` xml
<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>
```
Lécriture dans le syslog est également prise en charge. Exemple de Config:
2020-03-30 12:48:55 +00:00
``` xml
<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>
```
Touches:
- use\_syslog — Required setting if you want to write to the syslog.
- address — The host\[:port\] of syslogd. If omitted, the local daemon is used.
- hostname — Optional. The name of the host that logs are sent from.
- facility — [Le mot clé syslog facility](https://en.wikipedia.org/wiki/Syslog#Facility) en majuscules avec la “LOG\_” préfixe: (`LOG_USER`, `LOG_DAEMON`, `LOG_LOCAL3` et ainsi de suite).
Valeur par défaut: `LOG_USER` si `address` est spécifié, `LOG_DAEMON otherwise.`
- format Message format. Possible values: `bsd` et `syslog.`
## macro {#macros}
Substitutions de paramètres pour les tables répliquées.
Peut être omis si les tables répliquées ne sont pas utilisées.
Pour plus dinformations, consultez la section “[Création de tables répliquées](../../engines/table-engines/mergetree-family/replication.md)”.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<macros incl="macros" optional="true" />
```
## mark\_cache\_size {#server-mark-cache-size}
Taille approximative (en octets) du cache des marques utilisées par les [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) famille.
2020-03-30 12:48:55 +00:00
Le cache est partagé pour le serveur et la mémoire est allouée au besoin. La taille du cache doit être dau moins 5368709120.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<mark_cache_size>5368709120</mark_cache_size>
```
## max\_concurrent\_queries {#max-concurrent-queries}
Nombre maximal de demandes traitées simultanément.
**Exemple**
``` xml
<max_concurrent_queries>100</max_concurrent_queries>
```
## max\_connections {#max-connections}
Le nombre maximal de connexions entrantes.
**Exemple**
``` xml
<max_connections>4096</max_connections>
```
## max\_open\_files {#max-open-files}
Le nombre maximal de fichiers ouverts.
Par défaut: `maximum`.
Nous vous recommandons dutiliser cette option sous Mac OS X depuis le `getrlimit()` la fonction renvoie une valeur incorrecte.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<max_open_files>262144</max_open_files>
```
## max\_table\_size\_to\_drop {#max-table-size-to-drop}
Restriction sur la suppression de tables.
Si la taille dun [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) table dépasse `max_table_size_to_drop` (en octets), vous ne pouvez pas le supprimer à laide dune requête DROP.
2020-03-30 12:48:55 +00:00
Si vous devez toujours supprimer la table sans redémarrer le serveur ClickHouse, créez le `<clickhouse-path>/flags/force_drop_table` fichier et exécutez la requête DROP.
Valeur par défaut: 50 Go.
La valeur 0 signifie que vous pouvez supprimer toutes les tables sans aucune restriction.
**Exemple**
``` xml
<max_table_size_to_drop>0</max_table_size_to_drop>
```
2020-04-04 09:15:31 +00:00
## merge\_tree {#server_configuration_parameters-merge_tree}
2020-03-30 12:48:55 +00:00
Réglage fin des tables dans le [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md).
2020-03-30 12:48:55 +00:00
Pour plus dinformations, consultez MergeTreeSettings.h fichier den-tête.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<merge_tree>
<max_suspicious_broken_parts>5</max_suspicious_broken_parts>
</merge_tree>
```
2020-04-04 09:15:31 +00:00
## openSSL {#server_configuration_parameters-openssl}
2020-03-30 12:48:55 +00:00
Configuration client/serveur SSL.
Le Support pour SSL est fourni par le `libpoco` bibliothèque. Linterface est décrite dans le fichier [SSLManager.h](https://github.com/ClickHouse-Extras/poco/blob/master/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h)
2020-03-30 12:48:55 +00:00
Clés pour les paramètres Serveur/client:
- privateKeyFile The path to the file with the secret key of the PEM certificate. The file may contain a key and certificate at the same time.
- certificateFile The path to the client/server certificate file in PEM format. You can omit it if `privateKeyFile` contient le certificat.
- caConfig The path to the file or directory that contains trusted root certificates.
- verificationMode The method for checking the nodes certificates. Details are in the description of the [Cadre](https://github.com/ClickHouse-Extras/poco/blob/master/NetSSL_OpenSSL/include/Poco/Net/Context.h) classe. Valeurs possibles: `none`, `relaxed`, `strict`, `once`.
2020-03-30 12:48:55 +00:00
- verificationDepth The maximum length of the verification chain. Verification will fail if the certificate chain length exceeds the set value.
- loadDefaultCAFile Indicates that built-in CA certificates for OpenSSL will be used. Acceptable values: `true`, `false`. \|
- cipherList Supported OpenSSL encryptions. For example: `ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH`.
- cacheSessions Enables or disables caching sessions. Must be used in combination with `sessionIdContext`. Les valeurs acceptables: `true`, `false`.
- sessionIdContext A unique set of random characters that the server appends to each generated identifier. The length of the string must not exceed `SSL_MAX_SSL_SESSION_ID_LENGTH`. Ce paramètre est toujours recommandé car il permet déviter les problèmes à la fois si le serveur met en cache la session et si le client demande la mise en cache. Valeur par défaut: `${application.name}`.
2020-03-30 12:48:55 +00:00
- sessionCacheSize The maximum number of sessions that the server caches. Default value: 1024\*20. 0 Unlimited sessions.
- sessionTimeout Time for caching the session on the server.
- extendedVerification Automatically extended verification of certificates after the session ends. Acceptable values: `true`, `false`.
- requireTLSv1 Require a TLSv1 connection. Acceptable values: `true`, `false`.
- requireTLSv1\_1 Require a TLSv1.1 connection. Acceptable values: `true`, `false`.
- requireTLSv1 Require a TLSv1.2 connection. Acceptable values: `true`, `false`.
- fips Activates OpenSSL FIPS mode. Supported if the librarys OpenSSL version supports FIPS.
2020-03-30 12:48:55 +00:00
- privateKeyPassphraseHandler Class (PrivateKeyPassphraseHandler subclass) that requests the passphrase for accessing the private key. For example: `<privateKeyPassphraseHandler>`, `<name>KeyFileHandler</name>`, `<options><password>test</password></options>`, `</privateKeyPassphraseHandler>`.
- invalidCertificateHandler Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: `<invalidCertificateHandler> <name>ConsoleCertificateHandler</name> </invalidCertificateHandler>` .
- disableProtocols Protocols that are not allowed to use.
- preferServerCiphers Preferred server ciphers on the client.
**Exemple de paramètres:**
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## part\_log {#server_configuration_parameters-part-log}
2020-03-30 12:48:55 +00:00
Journalisation des événements associés à [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md). Par exemple, ajouter ou fusionner des données. Vous pouvez utiliser le journal pour simuler des algorithmes de fusion et comparer leurs caractéristiques. Vous pouvez visualiser le processus de fusion.
2020-03-30 12:48:55 +00:00
Les requêtes sont enregistrées dans le [système.part\_log](../../operations/system-tables.md#system_tables-part-log) table, pas dans un fichier séparé. Vous pouvez configurer le nom de cette table dans le `table` paramètre (voir ci-dessous).
2020-03-30 12:48:55 +00:00
Utilisez les paramètres suivants pour configurer la journalisation:
- `database` Name of the database.
- `table` Name of the system table.
- `partition_by` Sets a [partitionnement personnalisé clé](../../engines/table-engines/mergetree-family/custom-partitioning-key.md).
2020-03-30 12:48:55 +00:00
- `flush_interval_milliseconds` Interval for flushing data from the buffer in memory to the table.
**Exemple**
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## chemin {#server_configuration_parameters-path}
2020-03-30 12:48:55 +00:00
Chemin daccès au répertoire contenant des données.
2020-03-30 12:48:55 +00:00
!!! note "Note"
La barre oblique de fin est obligatoire.
**Exemple**
``` xml
<path>/var/lib/clickhouse/</path>
```
2020-04-04 09:15:31 +00:00
## query\_log {#server_configuration_parameters-query-log}
2020-03-30 12:48:55 +00:00
Réglage de la journalisation des requêtes reçues avec [log\_queries=1](../settings/settings.md) paramètre.
Les requêtes sont enregistrées dans le [système.query\_log](../../operations/system-tables.md#system_tables-query_log) table, pas dans un fichier séparé. Vous pouvez modifier le nom de la table dans le `table` paramètre (voir ci-dessous).
2020-03-30 12:48:55 +00:00
Utilisez les paramètres suivants pour configurer la journalisation:
- `database` Name of the database.
- `table` Name of the system table the queries will be logged in.
- `partition_by` Sets a [partitionnement personnalisé clé](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) pour une table.
2020-03-30 12:48:55 +00:00
- `flush_interval_milliseconds` Interval for flushing data from the buffer in memory to the table.
Si la table nexiste pas, ClickHouse la créera. Si la structure du journal des requêtes a été modifiée lors de la mise à jour du serveur ClickHouse, la table avec lancienne structure est renommée et une nouvelle table est créée automatiquement.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## query\_thread\_log {#server_configuration_parameters-query-thread-log}
2020-03-30 12:48:55 +00:00
Réglage de la journalisation des threads de requêtes reçues avec [log\_query\_threads=1](../settings/settings.md#settings-log-query-threads) paramètre.
Les requêtes sont enregistrées dans le [système.query\_thread\_log](../../operations/system-tables.md#system_tables-query-thread-log) table, pas dans un fichier séparé. Vous pouvez modifier le nom de la table dans le `table` paramètre (voir ci-dessous).
2020-03-30 12:48:55 +00:00
Utilisez les paramètres suivants pour configurer la journalisation:
- `database` Name of the database.
- `table` Name of the system table the queries will be logged in.
- `partition_by` Sets a [partitionnement personnalisé clé](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) pour un système de tableau.
2020-03-30 12:48:55 +00:00
- `flush_interval_milliseconds` Interval for flushing data from the buffer in memory to the table.
Si la table nexiste pas, ClickHouse la créera. Si la structure du journal des threads de requête a été modifiée lors de la mise à jour du serveur ClickHouse, la table avec lancienne structure est renommée et une nouvelle table est créée automatiquement.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<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>
```
2020-04-04 09:15:31 +00:00
## trace\_log {#server_configuration_parameters-trace_log}
2020-03-30 12:48:55 +00:00
Paramètres pour le [trace\_log](../../operations/system-tables.md#system_tables-trace_log) opération de table de système.
2020-03-30 12:48:55 +00:00
Paramètre:
- `database` — Database for storing a table.
- `table` — Table name.
- `partition_by` — [Partitionnement personnalisé clé](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) pour un système de tableau.
2020-03-30 12:48:55 +00:00
- `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table.
Le fichier de configuration du serveur par défaut `config.xml` contient la section Paramètres suivante:
``` xml
<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 {#query-masking-rules}
Règles basées sur Regexp, qui seront appliquées aux requêtes ainsi quà tous les messages de journal avant de les stocker dans les journaux du serveur,
2020-03-30 12:48:55 +00:00
`system.query_log`, `system.text_log`, `system.processes` table, et dans les journaux envoyés au client. Qui permet à la prévention de
fuite de données sensibles à partir de requêtes SQL (comme les noms, e-mails,
identificateurs ou numéros de carte de crédit) aux journaux.
**Exemple**
``` xml
<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>
```
Config champs:
- `name` - nom de la règle (facultatif)
- `regexp` - Expression régulière compatible RE2 (obligatoire)
- `replace` - chaîne de substitution pour les données sensibles (facultatif, par défaut - six astérisques)
Les règles de masquage sont appliquées à lensemble de la requête (pour éviter les fuites de données sensibles provenant de requêtes malformées / Non analysables).
2020-03-30 12:48:55 +00:00
`system.events` table ont compteur `QueryMaskingRulesMatch` qui ont un nombre global de requête de masquage des règles de correspondances.
Pour les requêtes distribuées chaque serveur doivent être configurés séparément, sinon, les sous-requêtes transmises à dautres
2020-03-30 12:48:55 +00:00
les nœuds seront stockés sans masquage.
## remote\_servers {#server-settings-remote-servers}
Configuration des clusters utilisés par le [Distribué](../../engines/table-engines/special/distributed.md) moteur de table et par le `cluster` table de fonction.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<remote_servers incl="clickhouse_remote_servers" />
```
Pour la valeur de l `incl` attribut, voir la section “[Fichiers de Configuration](../configuration-files.md#configuration_files)”.
2020-03-30 12:48:55 +00:00
**Voir Aussi**
- [skip\_unavailable\_shards](../settings/settings.md#settings-skip_unavailable_shards)
2020-04-04 09:15:31 +00:00
## fuseau {#server_configuration_parameters-timezone}
2020-03-30 12:48:55 +00:00
Le fuseau horaire du serveur.
Spécifié comme identifiant IANA pour le fuseau horaire UTC ou lemplacement géographique (par exemple, Afrique / Abidjan).
2020-03-30 12:48:55 +00:00
Le fuseau horaire est nécessaire pour les conversions entre les formats String et DateTime lorsque les champs DateTime sont sortis au format texte (imprimés à lécran ou dans un fichier) et lors de Lobtention de DateTime à partir dune chaîne. En outre, le fuseau horaire est utilisé dans les fonctions qui fonctionnent avec lheure et la date si elles ne reçoivent pas le fuseau horaire dans les paramètres dentrée.
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<timezone>Europe/Moscow</timezone>
```
2020-04-04 09:15:31 +00:00
## tcp\_port {#server_configuration_parameters-tcp_port}
2020-03-30 12:48:55 +00:00
Port pour communiquer avec les clients via le protocole TCP.
**Exemple**
``` xml
<tcp_port>9000</tcp_port>
```
2020-04-04 09:15:31 +00:00
## tcp\_port\_secure {#server_configuration_parameters-tcp_port-secure}
2020-03-30 12:48:55 +00:00
2020-04-04 09:15:31 +00:00
Port TCP pour une communication sécurisée avec les clients. Utilisez le avec [OpenSSL](#server_configuration_parameters-openssl) paramètre.
2020-03-30 12:48:55 +00:00
**Valeurs possibles**
Entier positif.
**Valeur par défaut**
``` xml
<tcp_port_secure>9440</tcp_port_secure>
```
2020-04-04 09:15:31 +00:00
## mysql\_port {#server_configuration_parameters-mysql_port}
2020-03-30 12:48:55 +00:00
Port pour communiquer avec les clients via le protocole MySQL.
**Valeurs possibles**
Entier positif.
Exemple
``` xml
<mysql_port>9004</mysql_port>
```
## tmp\_path {#server-settings-tmp_path}
Chemin daccès aux données temporaires pour le traitement des requêtes volumineuses.
2020-03-30 12:48:55 +00:00
!!! note "Note"
La barre oblique de fin est obligatoire.
**Exemple**
``` xml
<tmp_path>/var/lib/clickhouse/tmp/</tmp_path>
```
## tmp\_policy {#server-settings-tmp-policy}
La politique de [`storage_configuration`](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-multiple-volumes) pour stocker des fichiers temporaires.
Si cela nest pas [`tmp_path`](#server-settings-tmp_path) est utilisé, sinon elle est ignorée.
2020-03-30 12:48:55 +00:00
!!! note "Note"
- `move_factor` est ignoré
- `keep_free_space_bytes` est ignoré
- `max_data_part_size_bytes` est ignoré
- vous devez avoir exactement un volume dans cette politique
## uncompressed\_cache\_size {#server-settings-uncompressed_cache_size}
Taille du Cache (en octets) pour les données non compressées utilisées par les [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md).
2020-03-30 12:48:55 +00:00
Il y a un cache partagé pour le serveur. La mémoire est allouée à la demande. Le cache est utilisé si loption [use\_uncompressed\_cache](../settings/settings.md#setting-use_uncompressed_cache) est activé.
2020-03-30 12:48:55 +00:00
Le cache non compressé est avantageux pour les requêtes très courtes dans des cas individuels.
**Exemple**
``` xml
<uncompressed_cache_size>8589934592</uncompressed_cache_size>
```
2020-04-04 09:15:31 +00:00
## user\_files\_path {#server_configuration_parameters-user_files_path}
2020-03-30 12:48:55 +00:00
Le répertoire avec les fichiers utilisateur. Utilisé dans la fonction de table [fichier()](../../sql-reference/table-functions/file.md).
2020-03-30 12:48:55 +00:00
**Exemple**
``` xml
<user_files_path>/var/lib/clickhouse/user_files/</user_files_path>
```
## users\_config {#users-config}
Chemin daccès au fichier qui contient:
2020-03-30 12:48:55 +00:00
- Les configurations de lutilisateur.
- Les droits daccès.
2020-03-30 12:48:55 +00:00
- Les paramètres des profils.
- Les paramètres de Quota.
**Exemple**
``` xml
<users_config>users.xml</users_config>
```
## zookeeper {#server-settings_zookeeper}
Contient des paramètres qui permettent à ClickHouse dinteragir avec [ZooKeeper](http://zookeeper.apache.org/) cluster.
2020-03-30 12:48:55 +00:00
ClickHouse utilise ZooKeeper pour stocker les métadonnées des répliques lors de lutilisation de tables répliquées. Si les tables répliquées ne sont pas utilisées, cette section de paramètres peut être omise.
2020-03-30 12:48:55 +00:00
Cette section contient les paramètres suivants:
- `node` — ZooKeeper endpoint. You can set multiple endpoints.
Exemple:
<!-- -->
``` xml
<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` — Maximum timeout for the client session in milliseconds.
- `root` — The [znode](http://zookeeper.apache.org/doc/r3.5.5/zookeeperOver.html#Nodes+and+ephemeral+nodes) qui est utilisé comme racine pour les znodes utilisés par le serveur ClickHouse. Facultatif.
- `identity` — User and password, that can be required by ZooKeeper to give access to requested znodes. Optional.
**Exemple de configuration**
``` xml
<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>
```
**Voir Aussi**
- [Réplication](../../engines/table-engines/mergetree-family/replication.md)
2020-03-30 12:48:55 +00:00
- [Guide du programmeur ZooKeeper](http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html)
## use\_minimalistic\_part\_header\_in\_zookeeper {#server-settings-use_minimalistic_part_header_in_zookeeper}
Méthode de stockage pour les en-têtes de partie de données dans ZooKeeper.
Ce paramètre sapplique uniquement à l `MergeTree` famille. Il peut être spécifié:
2020-03-30 12:48:55 +00:00
- À léchelle mondiale dans le [merge\_tree](#server_configuration_parameters-merge_tree) la section de la `config.xml` fichier.
2020-03-30 12:48:55 +00:00
ClickHouse utilise le paramètre pour toutes les tables du serveur. Vous pouvez modifier le réglage à tout moment. Les tables existantes changent de comportement lorsque le paramètre change.
- Pour chaque table.
Lors de la création dun tableau, indiquer la [moteur de réglage](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table). Le comportement dune table existante avec ce paramètre ne change pas, même si le paramètre global des changements.
2020-03-30 12:48:55 +00:00
**Valeurs possibles**
- 0 — Functionality is turned off.
- 1 — Functionality is turned on.
Si `use_minimalistic_part_header_in_zookeeper = 1`, puis [répliqué](../../engines/table-engines/mergetree-family/replication.md) les tables stockent les en-têtes des parties de données de manière compacte à laide `znode`. Si la table contient plusieurs colonnes, cette méthode de stockage réduit considérablement le volume des données stockées dans Zookeeper.
2020-03-30 12:48:55 +00:00
!!! attention "Attention"
Après lapplication de `use_minimalistic_part_header_in_zookeeper = 1`, vous ne pouvez pas rétrograder le serveur ClickHouse vers une version qui ne prend pas en charge ce paramètre. Soyez prudent lors de la mise à niveau de ClickHouse sur les serveurs dun cluster. Ne mettez pas à niveau tous les serveurs à la fois. Il est plus sûr de tester de nouvelles versions de ClickHouse dans un environnement de test, ou sur quelques serveurs dun cluster.
2020-03-30 12:48:55 +00:00
Data part headers already stored with this setting can't be restored to their previous (non-compact) representation.
**Valeur par défaut:** 0.
## disable\_internal\_dns\_cache {#server-settings-disable-internal-dns-cache}
Désactive le cache DNS interne. Recommandé pour lutilisation de ClickHouse dans les systèmes
2020-03-30 12:48:55 +00:00
avec des infrastructures en constante évolution telles que Kubernetes.
**Valeur par défaut:** 0.
## dns\_cache\_update\_period {#server-settings-dns-cache-update-period}
La période de mise à jour des adresses IP stockées dans le cache DNS interne de ClickHouse (en secondes).
La mise à jour est effectuée de manière asynchrone, dans un thread système séparé.
**Valeur par défaut**: 15.
2020-04-04 09:15:31 +00:00
[Article Original](https://clickhouse.tech/docs/en/operations/server_configuration_parameters/settings/) <!--hide-->