--- toc_priority: 57 toc_title: "\u670D\u52A1\u5668\u8BBE\u7F6E" --- # 服务器配置 {#server-settings} ## builtin\_dictionaries\_reload\_interval {#builtin-dictionaries-reload-interval} 重新加载内置字典的间隔时间(以秒为单位)。 ClickHouse每x秒重新加载内置字典。 这使得编辑字典 “on the fly”,而无需重新启动服务器。 默认值:3600. **示例** ``` xml 3600 ``` ## 压缩 {#server-settings-compression} 数据压缩配置 [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md)-引擎表。 !!! warning "警告" 如果您刚开始使用ClickHouse,请不要使用它。 配置模板: ``` xml ... ... ... ... ``` `` 参数: - `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` 或 `zstd`. 您可以配置多个 `` 部分。 满足条件时的操作: - 如果数据部分与条件集匹配,ClickHouse将使用指定的压缩方法。 - 如果数据部分匹配多个条件集,ClickHouse将使用第一个匹配的条件集。 如果没有满足数据部分的条件,ClickHouse使用 `lz4` 压缩。 **示例** ``` xml 10000000000 0.01 zstd ``` ## default\_database {#default-database} 默认数据库。 要获取数据库列表,请使用 [SHOW DATABASES](../../sql-reference/statements/show.md#show-databases) 查询。 **示例** ``` xml default ``` ## default\_profile {#default-profile} 默认配置文件。 配置文件位于`user_config`参数指定的文件中 . **示例** ``` xml default ``` ## dictionaries\_config {#server_configuration_parameters-dictionaries_config} 外部字典的配置文件的路径。 路径: - 指定相对于服务器配置文件的绝对路径或路径。 - 路径可以包含通配符\*和?. 另请参阅 “[外部字典](../../sql-reference/dictionaries/external-dictionaries/external-dicts.md)”. **示例** ``` xml *_dictionary.xml ``` ## dictionaries\_lazy\_load {#server_configuration_parameters-dictionaries_lazy_load} 延迟加载字典。 如果 `true`,然后在第一次使用时创建每个字典。 如果字典创建失败,则使用该字典的函数将引发异常。 如果 `false`,服务器启动时创建所有字典,如果出现错误,服务器将关闭。 默认值为 `true`. **示例** ``` xml true ``` ## format\_schema\_path {#server_configuration_parameters-format_schema_path} 包含输入数据方案的目录路径,例如输入数据的方案 [CapnProto](../../interfaces/formats.md#capnproto) 格式。 **示例** ``` xml format_schemas/ ``` ## 石墨 {#server_configuration_parameters-graphite} 将数据发送到 [石墨](https://github.com/graphite-project). 设置: - 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 [系统。指标](../../operations/system-tables/metrics.md#system_tables-metrics) 桌子 - events – Sending deltas data accumulated for the time period from the [系统。活动](../../operations/system-tables/events.md#system_tables-events) 桌子 - events\_cumulative – Sending cumulative data from the [系统。活动](../../operations/system-tables/events.md#system_tables-events) 桌子 - asynchronous\_metrics – Sending data from the [系统。asynchronous\_metrics](../../operations/system-tables/asynchronous_metrics.md#system_tables-asynchronous_metrics) 桌子 您可以配置多个 `` 条款 例如,您可以使用它以不同的时间间隔发送不同的数据。 **示例** ``` xml localhost 42000 0.1 60 one_min true true false true ``` ## graphite\_rollup {#server_configuration_parameters-graphite-rollup} 石墨细化数据的设置。 有关详细信息,请参阅 [GraphiteMergeTree](../../engines/table-engines/mergetree-family/graphitemergetree.md). **示例** ``` xml max 0 60 3600 300 86400 3600 ``` ## http\_port/https\_port {#http-porthttps-port} 通过HTTP连接到服务器的端口。 如果 `https_port` 被指定, [openSSL](#server_configuration_parameters-openssl) 必须配置。 如果 `http_port` 指定时,即使设置了OpenSSL配置,也会忽略该配置。 **示例** ``` xml 9999 ``` ## http\_server\_default\_response {#server_configuration_parameters-http_server_default_response} 访问ClickHouse HTTP(s)服务器时默认显示的页面。 默认值为 “Ok.” (最后有换行符) **示例** 打开 `https://tabix.io/` 访问时 `http://localhost: http_port`. ``` xml
]]>
``` ## 包括\_从 {#server_configuration_parameters-include_from} 带替换的文件的路径。 有关详细信息,请参阅部分 “[配置文件](../configuration-files.md#configuration_files)”. **示例** ``` xml /etc/metrica.xml ``` ## interserver\_http\_port {#interserver-http-port} 用于在ClickHouse服务器之间交换数据的端口。 **示例** ``` xml 9009 ``` ## interserver\_http\_host {#interserver-http-host} 其他服务器可用于访问此服务器的主机名。 如果省略,它以相同的方式作为定义 `hostname-f` 指挥部 用于脱离特定的网络接口。 **示例** ``` xml example.yandex.ru ``` ## interserver\_http\_credentials {#server-settings-interserver-http-credentials} 用户名和密码用于在以下期间进行身份验证 [复制](../../engines/table-engines/mergetree-family/replication.md) 与复制\*引擎。 这些凭据仅用于副本之间的通信,与ClickHouse客户端的凭据无关。 服务器正在检查这些凭据以连接副本,并在连接到其他副本时使用相同的凭据。 因此,这些凭据应该为集群中的所有副本设置相同。 默认情况下,不使用身份验证。 本节包含以下参数: - `user` — username. - `password` — password. **示例** ``` xml admin 222 ``` ## keep\_alive\_timeout {#keep-alive-timeout} ClickHouse在关闭连接之前等待传入请求的秒数。 默认为3秒。 **示例** ``` xml 3 ``` ## listen\_host {#server_configuration_parameters-listen_host} 对请求可能来自的主机的限制。 如果您希望服务器回答所有这些问题,请指定 `::`. 例: ``` xml ::1 127.0.0.1 ``` ## 记录器 {#server_configuration_parameters-logger} 日志记录设置。 键: - 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`和`errorlog`. 一旦文件到达 `size`,ClickHouse存档并重命名它,并在其位置创建一个新的日志文件。 - count – The number of archived log files that ClickHouse stores. **示例** ``` xml trace /var/log/clickhouse-server/clickhouse-server.log /var/log/clickhouse-server/clickhouse-server.err.log 1000M 10 ``` 还支持写入系统日志。 配置示例: ``` xml 1
syslog.remote:10514
myhost.local LOG_LOCAL6 syslog
``` 键: - 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 — [系统日志工具关键字](https://en.wikipedia.org/wiki/Syslog#Facility) 在大写字母与 “LOG\_” 前缀: (`LOG_USER`, `LOG_DAEMON`, `LOG_LOCAL3`,等等)。 默认值: `LOG_USER` 如果 `address` 被指定, `LOG_DAEMON otherwise.` - format – Message format. Possible values: `bsd` 和 `syslog.` ## 宏 {#macros} 复制表的参数替换。 如果不使用复制的表,则可以省略。 有关详细信息,请参阅部分 “[创建复制的表](../../engines/table-engines/mergetree-family/replication.md)”. **示例** ``` xml ``` ## mark\_cache\_size {#server-mark-cache-size} 表引擎使用的标记缓存的近似大小(以字节为单位) [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) 家人 缓存为服务器共享,并根据需要分配内存。 缓存大小必须至少为5368709120。 **示例** ``` xml 5368709120 ``` ## max\_concurrent\_queries {#max-concurrent-queries} 同时处理的请求的最大数量。 **示例** ``` xml 100 ``` ## max\_connections {#max-connections} 入站连接的最大数量。 **示例** ``` xml 4096 ``` ## max\_open\_files {#max-open-files} 打开文件的最大数量。 默认情况下: `maximum`. 我们建议在Mac OS X中使用此选项,因为 `getrlimit()` 函数返回一个不正确的值。 **示例** ``` xml 262144 ``` ## max\_table\_size\_to\_drop {#max-table-size-to-drop} 限制删除表。 如果一个大小 [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) 表超过 `max_table_size_to_drop` (以字节为单位),您无法使用删除查询将其删除。 如果仍然需要在不重新启动ClickHouse服务器的情况下删除表,请创建 `/flags/force_drop_table` 文件并运行DROP查询。 默认值:50GB。 值0表示您可以删除所有表而不受任何限制。 **示例** ``` xml 0 ``` ## merge\_tree {#server_configuration_parameters-merge_tree} 微调中的表 [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md). 有关详细信息,请参阅MergeTreeSettings。h头文件。 **示例** ``` xml 5 ``` ## openSSL {#server_configuration_parameters-openssl} SSL客户端/服务器配置。 对SSL的支持由 `libpoco` 图书馆. 该接口在文件中描述 [SSLManager.h](https://github.com/ClickHouse-Extras/poco/blob/master/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h) 服务器/客户端设置的密钥: - 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` 包含证书。 - 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 [A.背景](https://github.com/ClickHouse-Extras/poco/blob/master/NetSSL_OpenSSL/include/Poco/Net/Context.h) 同学们 可能的值: `none`, `relaxed`, `strict`, `once`. - 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`. 可接受的值: `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`. 始终建议使用此参数,因为如果服务器缓存会话,以及客户端请求缓存,它有助于避免出现问题。 默认值: `${application.name}`. - 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. - privateKeyPassphraseHandler – Class (PrivateKeyPassphraseHandler subclass) that requests the passphrase for accessing the private key. For example: ``, `KeyFileHandler`, `test`, ``. - invalidCertificateHandler – Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: ` ConsoleCertificateHandler ` . - disableProtocols – Protocols that are not allowed to use. - preferServerCiphers – Preferred server ciphers on the client. **设置示例:** ``` xml /etc/clickhouse-server/server.crt /etc/clickhouse-server/server.key /etc/clickhouse-server/dhparam.pem none true true sslv2,sslv3 true true true sslv2,sslv3 true RejectCertificateHandler ``` ## part\_log {#server_configuration_parameters-part-log} 记录与之关联的事件 [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md). 例如,添加或合并数据。 您可以使用日志来模拟合并算法并比较它们的特征。 您可以可视化合并过程。 查询记录在 [系统。part\_log](../../operations/system-tables/part_log.md#system_tables-part-log) 表,而不是在一个单独的文件。 您可以在以下命令中配置此表的名称 `table` 参数(见下文)。 使用以下参数配置日志记录: - `database` – Name of the database. - `table` – Name of the system table. - `partition_by` – Sets a [自定义分区键](../../engines/table-engines/mergetree-family/custom-partitioning-key.md). - `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table. **示例** ``` xml system part_log
toMonday(event_date) 7500
``` ## 路径 {#server_configuration_parameters-path} 包含数据的目录的路径。 !!! note "注" 尾部斜杠是强制性的。 **示例** ``` xml /var/lib/clickhouse/ ``` ## query\_log {#server_configuration_parameters-query-log} 用于记录接收到的查询的设置 [log\_queries=1](../settings/settings.md) 设置。 查询记录在 [系统。query\_log](../../operations/system-tables/query_log.md#system_tables-query_log) 表,而不是在一个单独的文件。 您可以更改表的名称 `table` 参数(见下文)。 使用以下参数配置日志记录: - `database` – Name of the database. - `table` – Name of the system table the queries will be logged in. - `partition_by` – Sets a [自定义分区键](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) 为了一张桌子 - `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table. 如果该表不存在,ClickHouse将创建它。 如果在ClickHouse服务器更新时查询日志的结构发生了更改,则会重命名具有旧结构的表,并自动创建新表。 **示例** ``` xml system query_log
toMonday(event_date) 7500
``` ## query\_thread\_log {#server_configuration_parameters-query-thread-log} 设置用于记录接收到的查询的线程 [log\_query\_threads=1](../settings/settings.md#settings-log-query-threads) 设置。 查询记录在 [系统。query\_thread\_log](../../operations/system-tables/query_thread_log.md#system_tables-query-thread-log) 表,而不是在一个单独的文件。 您可以更改表的名称 `table` 参数(见下文)。 使用以下参数配置日志记录: - `database` – Name of the database. - `table` – Name of the system table the queries will be logged in. - `partition_by` – Sets a [自定义分区键](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) 对于一个系统表。 - `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table. 如果该表不存在,ClickHouse将创建它。 如果更新ClickHouse服务器时查询线程日志的结构发生了更改,则会重命名具有旧结构的表,并自动创建新表。 **示例** ``` xml system query_thread_log
toMonday(event_date) 7500
``` ## trace\_log {#server_configuration_parameters-trace_log} 设置为 [trace\_log](../../operations/system-tables/trace_log.md#system_tables-trace_log) 系统表操作。 参数: - `database` — Database for storing a table. - `table` — Table name. - `partition_by` — [自定义分区键](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) 对于一个系统表。 - `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table. 默认服务器配置文件 `config.xml` 包含以下设置部分: ``` xml system trace_log
toYYYYMM(event_date) 7500
``` ## query\_masking\_rules {#query-masking-rules} 基于正则表达式的规则,在将查询以及所有日志消息存储在服务器日志中之前,这些规则将应用于查询以及所有日志消息, `system.query_log`, `system.text_log`, `system.processes` 表,并在日志中发送给客户端。 这允许防止 从SQL查询敏感数据泄漏(如姓名,电子邮件,个人 标识符或信用卡号码)记录。 **示例** ``` xml hide SSN (^|\D)\d{3}-\d{2}-\d{4}($|\D) 000-00-0000 ``` 配置字段: - `name` -规则的名称(可选) - `regexp` -RE2兼容正则表达式(强制性) - `replace` -敏感数据的替换字符串(可选,默认情况下-六个星号) 屏蔽规则应用于整个查询(以防止敏感数据从格式错误/不可解析的查询泄漏)。 `system.events` 表有计数器 `QueryMaskingRulesMatch` 其中具有匹配的查询屏蔽规则的总数。 对于分布式查询,每个服务器必须单独配置,否则,子查询传递给其他 节点将被存储而不屏蔽。 ## remote\_servers {#server-settings-remote-servers} 所使用的集群的配置 [分布](../../engines/table-engines/special/distributed.md) 表引擎和由 `cluster` 表功能。 **示例** ``` xml ``` 对于该值 `incl` 属性,请参阅部分 “[配置文件](../configuration-files.md#configuration_files)”. **另请参阅** - [skip\_unavailable\_shards](../settings/settings.md#settings-skip_unavailable_shards) ## 时区 {#server_configuration_parameters-timezone} 服务器的时区。 指定为UTC时区或地理位置(例如,非洲/阿比让)的IANA标识符。 当DateTime字段输出为文本格式(打印在屏幕上或文件中)时,以及从字符串获取DateTime时,时区对于字符串和DateTime格式之间的转换是必需的。 此外,如果在输入参数中没有收到时区,则时区用于处理时间和日期的函数。 **示例** ``` xml Europe/Moscow ``` ## tcp\_port {#server_configuration_parameters-tcp_port} 通过TCP协议与客户端通信的端口。 **示例** ``` xml 9000 ``` ## tcp\_port\_secure {#server_configuration_parameters-tcp_port_secure} TCP端口,用于与客户端进行安全通信。 使用它与 [OpenSSL](#server_configuration_parameters-openssl) 设置。 **可能的值** 整数。 **默认值** ``` xml 9440 ``` ## mysql\_port {#server_configuration_parameters-mysql_port} 通过MySQL协议与客户端通信的端口。 **可能的值** 整数。 示例 ``` xml 9004 ``` ## tmp\_path {#server-settings-tmp_path} 用于处理大型查询的临时数据的路径。 !!! note "注" 尾部斜杠是强制性的。 **示例** ``` xml /var/lib/clickhouse/tmp/ ``` ## tmp\_policy {#server-settings-tmp-policy} 从政策 [`storage_configuration`](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-multiple-volumes) 存储临时文件。 如果没有设置 [`tmp_path`](#server-settings-tmp_path) 被使用,否则被忽略。 !!! note "注" - `move_factor` 被忽略 - `keep_free_space_bytes` 被忽略 - `max_data_part_size_bytes` 被忽略 -您必须在该政策中只有一个卷 ## uncompressed\_cache\_size {#server-settings-uncompressed_cache_size} 表引擎使用的未压缩数据的缓存大小(以字节为单位) [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md). 服务器有一个共享缓存。 内存按需分配。 如果选项使用缓存 [use\_uncompressed\_cache](../settings/settings.md#setting-use_uncompressed_cache) 被启用。 在个别情况下,未压缩的缓存对于非常短的查询是有利的。 **示例** ``` xml 8589934592 ``` ## user\_files\_path {#server_configuration_parameters-user_files_path} 包含用户文件的目录。 在表函数中使用 [文件()](../../sql-reference/table-functions/file.md). **示例** ``` xml /var/lib/clickhouse/user_files/ ``` ## users\_config {#users-config} 包含文件的路径: - 用户配置。 - 访问权限。 - 设置配置文件。 - 配额设置。 **示例** ``` xml users.xml ``` ## zookeeper {#server-settings_zookeeper} 包含允许ClickHouse与 [zookpeer](http://zookeeper.apache.org/) 集群。 ClickHouse使用ZooKeeper存储复制表副本的元数据。 如果未使用复制的表,则可以省略此部分参数。 本节包含以下参数: - `node` — ZooKeeper endpoint. You can set multiple endpoints. 例如: ``` xml example_host 2181 ``` 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) 隆隆隆隆路虏脢..陇.貌.垄拢卢虏禄.陇.貌路.隆拢脳枚脢虏.麓脢for脱 可选。 - `identity` — User and password, that can be required by ZooKeeper to give access to requested znodes. Optional. **配置示例** ``` xml example1 2181 example2 2181 30000 10000 /path/to/zookeeper/node user:password ``` **另请参阅** - [复制](../../engines/table-engines/mergetree-family/replication.md) - [动物园管理员程序员指南](http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html) ## use\_minimalistic\_part\_header\_in\_zookeeper {#server-settings-use_minimalistic_part_header_in_zookeeper} ZooKeeper中数据部分头的存储方法。 此设置仅适用于 `MergeTree` 家人 它可以指定: - 在全球范围内 [merge\_tree](#server_configuration_parameters-merge_tree) 一节 `config.xml` 文件 ClickHouse使用服务器上所有表的设置。 您可以随时更改设置。 当设置更改时,现有表会更改其行为。 - 对于每个表。 创建表时,指定相应的 [发动机设置](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table). 即使全局设置更改,具有此设置的现有表的行为也不会更改。 **可能的值** - 0 — Functionality is turned off. - 1 — Functionality is turned on. 如果 `use_minimalistic_part_header_in_zookeeper = 1`,然后 [复制](../../engines/table-engines/mergetree-family/replication.md) 表存储的数据部分的头紧凑使用一个单一的 `znode`. 如果表包含许多列,则此存储方法显着减少了Zookeeper中存储的数据量。 !!! attention "注意" 申请后 `use_minimalistic_part_header_in_zookeeper = 1`,您不能将ClickHouse服务器降级到不支持此设置的版本。 在集群中的服务器上升级ClickHouse时要小心。 不要一次升级所有服务器。 在测试环境中或在集群的几台服务器上测试ClickHouse的新版本更安全。 Data part headers already stored with this setting can't be restored to their previous (non-compact) representation. **默认值:** 0. ## disable\_internal\_dns\_cache {#server-settings-disable-internal-dns-cache} 禁用内部DNS缓存。 推荐用于在系统中运行ClickHouse 随着频繁变化的基础设施,如Kubernetes。 **默认值:** 0. ## dns\_cache\_update\_period {#server-settings-dns-cache-update-period} 更新存储在ClickHouse内部DNS缓存中的IP地址的周期(以秒为单位)。 更新是在一个单独的系统线程中异步执行的。 **默认值**: 15. [原始文章](https://clickhouse.tech/docs/en/operations/server_configuration_parameters/settings/)