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

907 lines
34 KiB
Markdown
Raw Normal View History

2020-03-30 12:48:55 +00:00
---
machine_translated: true
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
2020-04-04 09:15:31 +00:00
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}
L'intervalle 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 l'utilisez 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 n'est 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 d'accè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 s'arrê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 d'accès au répertoire avec des régimes pour l'entré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 l'utiliser 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 l'amincissement 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
2020-05-15 13:14:39 +00:00
<https_port>9999</https_port>
2020-03-30 12:48:55 +00:00
```
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 l'accè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 d'accès au fichier avec des substitutions.
2020-03-30 12:48:55 +00:00
Pour plus d'informations, 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 d'hôte qui peut être utilisé par d'autres 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 d'utilisateur 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 d'identification sont utilisées uniquement pour la communication entre les répliques et ne sont pas liées aux informations d'identification des clients ClickHouse. Le serveur vérifie ces informations d'identification pour la connexion de répliques et utilise les mêmes informations d'identification lors de la connexion à d'autres répliques. Donc, ces informations d'identification doivent être identiques pour tous les réplicas dans un cluster.
Par défaut, l'authentification n'est 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 d'informations, 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 d'au 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 d'utiliser 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 d'un [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) table dépasse `max_table_size_to_drop` (en octets), vous ne pouvez pas le supprimer à l'aide d'une 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 d'informations, consultez MergeTreeSettings.h fichier d'en-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. L'interface 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 node's 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 library's 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 d'accè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>
```
## prometheus {#server_configuration_parameters-prometheus}
Exposer les données de métriques pour le raclage à partir [Prometheus](https://prometheus.io).
Paramètre:
- `endpoint` HTTP endpoint for scraping metrics by prometheus server. Start from /.
- `port` Port for `endpoint`.
- `metrics` Flag that sets to expose metrics from the [système.métrique](../system-tables.md#system_tables-metrics) table.
- `events` Flag that sets to expose metrics from the [système.événement](../system-tables.md#system_tables-events) table.
- `asynchronous_metrics` Flag that sets to expose current metrics values from the [système.asynchronous\_metrics](../system-tables.md#system_tables-asynchronous_metrics) table.
**Exemple**
``` xml
<prometheus>
<endpoint>/metrics</endpoint>
<port>8001</port>
<metrics>true</metrics>
<events>true</events>
<asynchronous_metrics>true</asynchronous_metrics>
</prometheus>
```
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 n'existe 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 l'ancienne 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 n'existe 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 l'ancienne 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 à l'ensemble 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 à d'autres
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 l'emplacement 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 L'obtention de DateTime à partir d'une chaîne. En outre, le fuseau horaire est utilisé dans les fonctions qui fonctionnent avec l'heure et la date si elles ne reçoivent pas le fuseau horaire dans les paramètres d'entré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>
```
DOCS-624: Fixing links to nowhere (#10675) * enbaskakova-DOCSUP-652 (#101) * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" * Update docs/en/sql_reference/aggregate_functions/combinators.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/sql_reference/aggregate_functions/combinators.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/sql_reference/aggregate_functions/combinators.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/sql_reference/aggregate_functions/combinators.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/sql_reference/aggregate_functions/combinators.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" * "docs(orNull&orDefault): Functions 'orNull&orDefault' have been edited" Co-authored-by: elenbaskakova <elenbaskakova@yandex-team.ru> Co-authored-by: BayoNet <da-daos@yandex.ru> * Revert "enbaskakova-DOCSUP-652 (#101)" (#107) This reverts commit 639fee7610f28e421d14e535b7def3f466e7efca. * CLICKHOUSEDOCS-624: Fixed links. Was 60, became 13. * CLICKHOUSEDOCS-624: Finished fix links in Enlish version. * CLICKHOUSEDOCS-624: Fixed RU links Co-authored-by: elenaspb2019 <47083263+elenaspb2019@users.noreply.github.com> Co-authored-by: elenbaskakova <elenbaskakova@yandex-team.ru> Co-authored-by: Sergei Shtykov <bayonet@yandex-team.ru>
2020-05-06 06:13:29 +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 d'accè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 n'est 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 l'option [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 d'accès au fichier qui contient:
2020-03-30 12:48:55 +00:00
- Les configurations de l'utilisateur.
- Les droits d'accè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 d'interagir 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 l'utilisation 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 s'applique 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 d'un tableau, indiquer la [moteur de réglage](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table). Le comportement d'une 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 à l'aide `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 l'application 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 d'un 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 d'un 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 l'utilisation 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.
## access\_control\_path {#access_control_path}
Chemin d'accès à un dossier dans lequel un serveur clickhouse stocke les configurations utilisateur et rôle créées par les commandes SQL.
Valeur par défaut: `/var/lib/clickhouse/access/`.
**Voir aussi**
- [Le Contrôle d'accès et de Gestion de Compte](../access-rights.md#access-control)
2020-04-04 09:15:31 +00:00
[Article Original](https://clickhouse.tech/docs/en/operations/server_configuration_parameters/settings/) <!--hide-->