clickhouse-配置解释
详细内容看官网文档
一、全局服务配置
1.配置详解
| 名称 | 含义 | 默认值 |
|---|---|---|
| allow_use_jemalloc_memory | 允许使用 jemalloc 内存 | 1（布尔） |
| asynchronous_heavy_metrics_update_period_s | 更新异步指标的时间段（以秒为单位） | 120 |
| asynchronous_metrics_update_period_s | 更新异步指标的时间段（以秒为单位） | 1 |
| background_buffer_flush_schedule_pool_size | 将用于在后台对缓冲区引擎表执行刷新操作的最大线程数 | 16 |
| background_common_pool_size | 将用于在后台对 *MergeTree 引擎表执行各种操作（主要是垃圾回收）的最大线程数 | 8 |
| background_distributed_schedule_pool_size | 将用于执行分布式发送的最大线程数 | 16 |
| background_fetches_pool_size | 将用于从后台 *MergeTree 引擎表的另一个副本获取数据部分的最大线程数 | 8 |
| background_merges_mutations_concurrency_ratio | 设置线程数与可以同时执行的后台合并和突变数之间的比率。 例如，如果比率等于2并且background_pool_size设置为16，那么ClickHouse可以同时执行32个后台合并。 这是可能的，因为后台操作可以暂停和推迟。 这是为小型合并提供更多执行优先级所必需的。 您只能在运行时增加此比率。 要降低它，您必须重新启动服务器。 与background_pool_size设置相同的background_merges_mutations_concurrency_ratio可以从默认配置文件中应用以实现向后兼容性。 | 2(float) |
| background_merges_mutations_scheduling_policy | 关于如何执行后台合并和突变调度的策略。 可能的值为：round_robin 和shortest_task_first round_robin — 每个并发合并和变异都按循环顺序执行，以确保无饥饿操作。 较小的合并比较大的合并完成得更快，因为它们需要合并的块较少。 shortest_task_first — 始终执行较小的合并或突变。 合并和突变根据其结果大小分配优先级。 较小尺寸的合并优先于较大尺寸的合并。 此策略可确保以最快的速度合并小部分，但可能会导致 INSERT 严重过载的分区中的大合并无限期匮乏。 |
round_robin |
| background_message_broker_schedule_pool_size | 将用于执行消息流的后台操作的最大线程数 | 16 |
| background_move_pool_size | 将用于将数据部分移动到后台 *MergeTree 引擎表的另一个磁盘或卷的最大线程数 | 8 |
| background_pool_size | 设置使用 MergeTree 引擎对表执行后台合并和突变的线程数。 您只能在运行时增加线程数。 要减少线程数，您必须重新启动服务器。 通过调整此设置，您可以管理 CPU 和磁盘负载。 较小的池大小使用较少的 CPU 和磁盘资源，但后台进程进展较慢，最终可能会影响查询性能。 在更改之前，还请查看相关的 MergeTree 设置，例如 number_of_free_entries_in_pool_to_lower_max_size_of_merge 和 number_of_free_entries_in_pool_to_execute_mutation。 |
16 |
| background_schedule_pool_size | 将用于不断对复制表、Kafka 流式处理和 DNS 缓存更新执行某些轻量级定期操作的最大线程数。 | 128 |
| backup_threads | 执行备份请求的最大线程数 | 16 |
| backups_io_thread_pool_queue_size | 备份 IO 线程池上可以调度的最大作业数。 由于当前的 S3 备份逻辑，建议保持此队列不受限制 (0)。 | 0 |
| cache_size_to_ram_max_ratio | 将缓存大小设置为 RAM 最大比率。允许降低低内存系统上的缓存大小 | 0.5 |
| concurrent_threads_soft_limit_num | 允许运行所有查询的最大查询处理线程数（不包括用于从远程服务器检索数据的线程）。 这不是硬性限制。 万一达到限制，查询仍将至少有一个线程运行。 如果有更多线程可用，查询可以在执行期间扩展到所需的线程数。 | 0 |
| concurrent_threads_soft_limit_ratio_to_cores | 与 concurrent_threads_soft_limit_num 相同，但具有与核心的比率。 | 0 |
| default_database | 默认数据库名称 | default |
| disable_internal_dns_cache | 禁用内部 DNS 缓存。 建议在基础设施经常变化的系统（例如 Kubernetes）中运行 ClickHouse。 | 0（布尔） |
| dns_cache_update_period | 内部 DNS 缓存更新周期（以秒为单位） | 15 |
| dns_max_consecutive_failures | 从 ClickHouse DNS 缓存中删除主机之前的最大连续解析失败次数 | 1024 |
| index_mark_cache_size | 索引标记的缓存大小。零表示禁用 此设置可以在运行时修改，并将立即生效。 |
0 |
| index_uncompressed_cache_size | 合并树索引的未压缩块的缓存大小。零表示禁用 此设置可以在运行时修改，并将立即生效 |
0 |
| io_thread_pool_queue_size | IO 线程池的队列大小。零表示无限制。 | 10000 |
| mark_cache_policy | 标记缓存策略名称 | SLRU |
| mark_cache_size | 标记的缓存大小（合并树系列表的索引） 此设置可以在运行时修改，并将立即生效 |
5368709120 |
| max_backup_bandwidth_for_server | 服务器上所有备份的最大读取速度（以字节/秒为单位）。零表示无限制 | 0 |
| max_backups_io_thread_pool_free_size | 如果Backups IO Thread池中的空闲线程数量超过max_backup_io_thread_pool_free_size，ClickHouse将释放空闲线程占用的资源并减小池大小。 如果需要，可以再次创建线程。 | 0 |
| max_backups_io_thread_pool_size | 用于备份查询的 IO 操作的最大线程数 | 1000 |
| max_concurrent_queries | 并发执行查询总数的限制。 零意味着无限。 请注意，还必须考虑对插入和选择查询以及用户最大查询数的限制。 另请参见 max_concurrent_insert_queries、max_concurrent_select_queries、max_concurrent_queries_for_all_users。 零意味着无限。 此设置可以在运行时修改，并将立即生效。已在运行的查询将保持不变。 |
0 |
| max_concurrent_insert_queries | 并发插入查询总数的限制。零表示无限制 此设置可以在运行时修改，并将立即生效。已在运行的查询将保持不变 |
0 |
| max_concurrent_select_queries | 限制并发选择查询的总数。零表示无限制。 此设置可以在运行时修改，并将立即生效。已在运行的查询将保持不变 |
0 |
| max_connections | 最大服务器连接数 | 1024 |
| max_io_thread_pool_free_size | IO 线程池的最大可用大小 | 0 |
| max_io_thread_pool_size | 将用于 IO 操作的最大线程数 | 100 |
| max_local_read_bandwidth_for_server | 本地读取的最大速度（以字节/秒为单位）。零表示无限制 | 0 |
| max_local_write_bandwidth_for_server | 本地写入的最大速度（以字节/秒为单位）。零表示无限制 | 0 |
| max_partition_size_to_drop | 限制删除分区。如果 MergeTree 表的大小超过 max_partition_size_to_drop （以字节为单位），则无法使用 DROP PARTITION 查询删除分区。 此设置不需要重新启动 Clickhouse 服务器即可应用。 禁用限制的另一种方法是创建 /flags/force_drop_table 文件。 值 0 表示您可以不受任何限制地删除分区。 | 50GB |
| max_remote_read_network_bandwidth_for_server | 通过网络进行数据交换的最大速度，以字节/秒为单位进行读取。零表示无限制 | 0 |
| max_remote_write_network_bandwidth_for_server | 通过网络进行写入的数据交换的最大速度（以字节/秒为单位）。零表示无限制 | 0 |
| max_server_memory_usage | 总内存使用量限制。 零意味着无限。默认 max_server_memory_usage 值的计算方式为：memory_amount * max_server_memory_usage_to_ram_ratio。 | 0 |
| max_table_size_to_drop | 删除表的大小限制 | 50GB |
| max_temporary_data_on_disk_size | 可用于外部聚合、联接或排序的最大存储量。 超过此限制的查询将失败并出现异常。 零意味着无限。 另请参阅 max_temporary_data_on_disk_size_for_user 和 max_temporary_data_on_disk_size_for_query。 |
0 |
| max_thread_pool_free_size | 如果全局线程池中的空闲线程数大于 max_thread_pool_free_size，则 ClickHouse 会释放部分线程占用的资源，并减小池大小。 如果需要的话可以再次创建线程 | 1000 |
| max_thread_pool_size | 可以从操作系统分配并用于查询执行和后台操作的最大线程数 | 10000 |
| mmap_cache_size | 设置映射文件的缓存大小（以字节为单位）。 此设置可以避免频繁的打开/关闭调用（由于随之而来的页面错误，这非常昂贵），并可以重用来自多个线程和查询的映射。 设置值为映射区域的数量（通常等于映射文件的数量）。 可以使用 MMappedFiles 和 MMappedFileBytes 指标在表 system.metrics 和 system.metric_log 中监视映射文件中的数据量。 此外，在 system.asynchronous_metrics 和 system.asynchronous_metrics_log 中通过 MMapCacheCells 指标，在 system.events、system.processes、system.query_log、system.query_thread_log、system.query_views_log 中通过 CreatedReadBufferMMap、CreatedReadBufferMMapFailed、MMappedFileCacheHits、MMappedFileCacheMisses 事件。 请注意，映射文件中的数据量不会直接消耗内存，并且不会计入查询或服务器内存使用量中，因为该内存可以像操作系统页面缓存一样被丢弃。 在删除 MergeTree 系列表中的旧部分时，缓存会自动删除（文件被关闭），也可以通过 SYSTEM DROP MMAP CACHE 查询手动删除。 此设置可以在运行时修改 |
1000 |
| restore_threads | 执行还原请求的最大线程数 | 16 |
| show_addresses_in_stack_traces | 如果设置为 true，将在堆栈跟踪中显示地址 | 1(布尔) |
| shutdown_wait_unfinished_queries | 如果设置为 true，ClickHouse 将等待运行查询完成，然后再关闭。 | 0（布尔） |
| temporary_data_in_cache | 使用此选项，临时数据将存储在特定磁盘的缓存中。 在本节中，您应该指定具有类型缓存的磁盘名称。 在这种情况下，缓存和临时数据将共享相同的空间，并且可以逐出磁盘缓存以创建临时数据。 只能使用一个选项来配置临时数据存储：tmp_path、tmp_policy、temporary_data_in_cache。 |
|
| thread_pool_queue_size | 全局线程池上可以调度的最大作业数。 增加队列大小会导致更大的内存使用量。 建议将此值保持等于 max_thread_pool_size。 零意味着无限。 | 10000 |
| tmp_policy | 包含临时数据的存储策略 只能使用一个选项来配置临时数据存储：tmp_path、tmp_policy、temporary_data_in_cache。 move_factor、keep_free_space_bytes、max_data_part_size_bytes 和 被忽略。 策略应该只有一个带有本地磁盘的卷。 |
|
| uncompressed_cache_policy | 未压缩的缓存策略名称 | SLRU |
| uncompressed_cache_size | 合并树系列中的表引擎使用的未压缩数据的高速缓存大小（以字节为单位）。零表示禁用。服务器有一个共享缓存。内存按需分配。如果启用了选项 use_uncompressed_cache，则使用缓存。在个别情况下，未压缩的缓存对于非常短的查询是有利的。 此设置可以在运行时修改，并将立即生效 |
0 |
| builtin_dictionaries_reload_interval | 重新加载内置词典之前的间隔（以秒为单位）。ClickHouse每x秒重新加载一次内置词典。这样就可以“动态”编辑词典，而无需重新启动服务器 | 3600 |
| compression | 合并树引擎表的数据压缩设置,如果您刚刚开始使用ClickHouse，请不要使用它。 case内容如下： min_part_size – 数据部分的最小大小。 min_part_size_ratio – 数据部分大小与表大小的比率。 method——压缩方法。 可接受的值：lz4、lz4hc、zstd、deflate_qpl。 level – 压缩级别。 |
|
| encryption | 配置命令以获取加密编解码器使用的密钥。 密钥（或多个密钥）应写入环境变量或在配置文件中设置。密钥可以是十六进制或长度等于 16 字节的字符串。 | |
| custom_settings_prefixes | 自定义设置的前缀列表。前缀必须用逗号分隔。 | |
| core_dump | 配置核心转储文件大小的软限制 | 1073741824 (1 GB) |
| database_atomic_delay_before_drop_table_sec | 设置删除表数据之前的延迟（以秒为单位）。 如果查询具有 SYNC 修饰符，则忽略此设置。 | 480 (8 minute) |
| database_catalog_unused_dir_hide_timeout_sec | 从 store/ 目录清理垃圾的任务的参数。 如果某些子目录未被 clickhouse-server 使用，并且该目录在最后的 database_catalog_unused_dir_hide_timeout_sec 秒内没有被修改，则该任务将通过删除所有访问权限来“隐藏”该目录。 它也适用于 clickhouse-server 不希望在 store/ 中看到的目录。 零意味着“立即”。 | 3600 (1 hour) |
| database_catalog_unused_dir_rm_timeout_sec | 从 store/ 目录清理垃圾的任务的参数。 如果某些子目录未被 clickhouse-server 使用并且之前已“隐藏”（请参阅database_catalog_unused_dir_hide_timeout_sec），并且在最后的database_catalog_unused_dir_rm_timeout_sec 秒内未修改此目录，则任务将删除此目录。 它也适用于 clickhouse-server 不希望在 store/ 中看到的目录。 零意味着“从不”。 | 2592000 (30 days) |
| database_catalog_unused_dir_cleanup_period_sec | 从 store/ 目录清理垃圾的任务的参数。 设置任务的调度周期。 零意味着“从不”。 | 86400 (1 day) |
| default_profile | 设置配置文件位于参数 user_config 中指定的文件中。 | |
| default_replica_name | ZooKeeper 中的副本名称 | |
| dictionaries_config | 字典配置文件的路径，路径可以包含通配符 * 和 ？ | |
| user_defined_executable_functions_config | 可执行的用户定义函数的配置文件的路径，路径可以包含通配符 * 和 ？ | |
| dictionaries_lazy_load | 字典的延迟加载。如果为 true，则每个字典都会在第一次使用时创建。 如果字典创建失败，则使用该字典的函数将引发异常。如果为 false，则在服务器启动时创建所有字典，如果创建的字典太长或创建时出现错误，则服务器启动时不会创建这些字典，并继续尝试创建这些字典。 | true |
| format_schema_path | 包含输入数据方案的目录路径，例如 CapnProto 格式的方案。 | |
| graphite | 发送监控数据给graphite的配置 | |
| graphite_rollup | graphite细化数据的设置 | |
| http_port/https_port | 用于通过 HTTP 连接到服务器的端口 | |
| http_server_default_response | 访问 ClickHouse HTTP(s) 服务器时默认显示的页面。 默认值为“OK”。 （末尾有换行符） | |
| hsts_max_age | HSTS 的过期时间（以秒为单位）。 默认值为 0 表示 clickhouse 禁用 HSTS。 如果您设置一个正数，则 HSTS 将启用，并且 max-age 是您设置的数字。 | 0 |
| include_from | 包含替换的文件的路径。 | |
| interserver_listen_host | 对可以在 ClickHouse 服务器之间交换数据的主机的限制。 如果使用Keeper，不同Keeper实例之间的通信也会受到同样的限制。 默认值等于listen_host设置。 | |
| interserver_http_port | 用于在 ClickHouse 服务器之间交换数据的端口 | |
| interserver_http_host | 其他服务器可以用来访问该服务器的主机名。如果省略，则其定义方式与 hostname -f 命令相同。对于脱离特定的网络接口很有用。 | |
| interserver_https_port | 通过 HTTPS 在 ClickHouse 服务器之间交换数据的端口 | |
| interserver_https_host | 与 interserver_http_host 类似，不同之处在于该主机名可以被其他服务器用来通过 HTTPS 访问该服务器。 | |
| interserver_http_credentials | 用于在复制期间连接到其他服务器的用户名和密码。 服务器还使用这些凭据对其他副本进行身份验证。 因此，集群中所有副本的 interserver_http_credentials 必须相同。 默认情况下，如果省略 interserver_http_credentials 部分，则在复制期间不使用身份验证。 user——用户名。 password——密码。 allow_empty — 如果为 true，则即使设置了凭据，也允许其他副本无需身份验证即可连接。 如果为 false，则拒绝未经身份验证的连接。默认值：false。 old — 包含凭证轮换期间使用的旧用户和密码。 可以指定几个旧部分。 |
|
| keep_alive_timeout | ClickHouse 在关闭连接之前等待传入请求的秒数 | 10秒 |
| listen_host | 对请求可以来自的主机的限制。 如果您希望服务器回答所有请求，请指定::。 | |
| listen_backlog | 侦听套接字的积压（待处理连接的队列大小）。侦听套接字的积压（待处理连接的队列大小）。通常不需要更改该值，因为：默认值足够大，并且为了接受客户端的连接，服务器有单独的线程。因此，即使您的 TcpExtListenOverflows（来自 nstat）非零并且该计数器随着 ClickHouse 服务器的增加而增加，也不意味着该值需要增加 | 4096 |
| logger | 日志设置 level – 日志记录级别。 可接受的值：跟踪、调试、信息、警告、错误。 log——日志文件。 包含按级别排列的所有条目。 errorlog – 错误日志文件。 size – 文件的大小。 适用于日志和错误日志。 一旦文件达到大小，ClickHouse 就会对其进行归档并重命名，并在其位置创建一个新的日志文件。 count – ClickHouse 存储的归档日志文件的数量。 console – 将日志和错误日志发送到控制台而不是文件。 要启用，请设置为 1 或 true。 Stream_compress – 使用 lz4 流压缩来压缩日志和错误日志。 要启用，请设置为 1 或 true。 |
|
| send_crash_reports | 向clickhouse开发团队发送崩溃报考 | |
| macros | 复制表的参数替换 | |
| max_open_files | 打开文件的最大数量 | |
| merges_mutations_memory_usage_soft_limit | 设置允许使用多少 RAM 来执行merge（合并）和mutation(更新)操作。 零意味着无限。 如果 ClickHouse 达到此限制，它不会安排任何新的后台合并或突变操作，但会继续执行已安排的任务。 | |
| merges_mutations_memory_usage_to_ram_ratio | 默认的 merges_mutations_memory_usage_soft_limit 值的计算方式为：memory_amount * merges_mutations_memory_usage_to_ram_ratio。 | 0.5 |
| merge_tree | 对MergeTree中的表进行微调 | |
| metric_log | 默认情况下，它处于启用状态。如果不是，您可以手动执行此操作,如果要禁用则需要创建这个文件 /etc/clickhouse-server/config.d/disable_metric_log.xml，内容如下 |
|
| replicated_merge_tree | 对ReplicatedMergeTree中的表进行微调 | |
| openSSL | 加密链接配置，不做详细介绍 | |
| part_log | 记录与 MergeTree 关联的事件。 例如，添加或合并数据。 您可以使用日志来模拟合并算法并比较它们的特性。 您可以可视化合并过程。使用以下参数来配置日志记录： database – 数据库的名称。 table – 系统表的名称。 partition_by — 系统表的自定义分区键。 如果引擎已定义则无法用。 order_by - 系统表的自定义排序键。 如果引擎已定义则无法使用。 engine - 系统表的 MergeTree 引擎定义。 如果定义了partition_by或order_by则不能使用。 lush_interval_milliseconds – 将数据从内存缓冲区刷新到表的时间间隔。 max_size_rows – 日志的最大大小（以行为单位）。 当未刷新的日志量达到max_size时，日志转储到磁盘。 默认值：1048576。 served_size_rows – 为日志预先分配的内存大小（以行为单位）。 默认值：8192。 buffer_size_rows_flush_threshold – 行数阈值，达到该阈值会在后台将日志刷新到磁盘。 默认值：max_size_rows / 2。 lush_on_crash - 指示在发生崩溃时是否应将日志转储到磁盘。 默认值：false。 storage_policy – 用于表的存储策略的名称（可选） settings - 控制 MergeTree 行为的附加参数（可选）。 |
|
| path | 包含数据的目录的路径 | |
| Prometheus | 指定接受指标数据的prometheus | |
| query_log | 用于记录通过 log_queries=1 设置接收到的查询的设置。查询记录在 system.query_log 表中，而不是单独的文件中。 您可以在表参数中更改表的名称（见下文）。使用以下参数来配置日志记录：(参数与part_log表一致)如果该表不存在，ClickHouse 将创建它。 如果ClickHouse服务器更新时查询日志的结构发生变化，旧结构的表将被重命名，并自动创建新表。 | |
| query_cache | 查询缓存允许仅计算查询一次，并直接从缓存中为同一查询的进一步执行提供服务。 根据查询的类型，这可以显着减少 ClickHouse 服务器select的延迟和资源消耗。 max_size_in_bytes：最大缓存大小（以字节为单位）。 0 表示查询缓存已禁用。 默认值：1073741824 (1 GiB)。 max_entries：缓存中存储的SELECT查询结果的最大数量。 默认值：1024。 max_entry_size_in_bytes：SELECT 查询结果可能必须保存在缓存中的最大大小（以字节为单位）。 默认值：1048576 (1 MiB)。 max_entry_size_in_rows：SELECT 查询结果可能要保存在缓存中的最大行数。 默认值：30000000（3000 万）。 更改立即生效 查询缓存的数据分配在 DRAM 中。 如果内存不足，请确保为 max_size_in_bytes 设置一个较小的值或完全禁用查询缓存。 |
|
| query_thread_log | 用于记录通过 log_query_threads=1 设置接收的查询线程的设置。查询记录在 system.query_thread_log 表中。 | |
| query_views_log | 记录视图（实时、具体化等）的设置取决于使用 log_query_views=1 设置接收到的查询。查询记录在 system.query_views_log 表中，而不是单独的文件中。 | |
| text_log | 用于记录文本消息的text_log 系统表的设置。 多出的字段：level — 将存储在表中的最大消息级别（默认为Trace）。 |
|
| trace_log | Trace_log系统表操作的设置。 | |
| asynchronous_insert_log | 用于记录异步插入的 asynchronous_insert_log 系统表的设置。 | |
| crash_log | crash_log系统表的设置 | |
| query_masking_rules | 基于正则表达式的规则，将应用于查询所有日志消息，然后将它们存储在服务器日志、system.query_log、system.text_log、system.processes 表以及发送到客户端的日志中。 这样可以防止敏感数据从 SQL 查询（如姓名、电子邮件、个人标识符或信用卡号）泄漏到日志中。配置字段： name - 规则的名称（可选） regexp - RE2 兼容的正则表达式（强制） replace - 敏感数据的替换字符串（可选，默认情况下 - 六个星号） 屏蔽规则应用于整个查询（以防止由于格式错误/不可解析的查询而泄漏敏感数据）。system.events 表有计数器 QueryMaskingRulesMatch，它具有查询屏蔽规则匹配的总数。对于分布式查询，每个服务器必须单独配置，否则，传递到其他节点的子查询将不加掩码地存储。 |
|
| remote_servers | 分布式表引擎和簇表功能使用的簇的配置。 | |
| timezone | 时区 | |
| tcp_port | 通过 TCP 协议与客户端通信的端口。 | |
| tcp_port_secure | 用于与客户端安全通信的 TCP 端口。 将其与 OpenSSL 设置一起使用。 | 9440 |
| mysql_port | 通过mysql协议与客户端通信的端口 | |
| postgresql_port | 通过postgresql协议与客户端通信的端口 | |
| tmp_path | 本地文件系统上用于存储处理大型查询的临时数据的路径。只能使用一个选项来配置临时数据存储：tmp_path、tmp_policy、temporary_data_in_cache。尾部斜杠是强制性的。例如 |
|
| user_files_path | 包含用户文件的目录，规定了使用file()函数的路径 | |
| user_scripts_path | 包含用户脚本文件的目录。 用于可执行的用户定义函数 | |
| user_defined_path | 包含用户定义文件的目录。 用于 SQL 用户定义函数 | |
| users_config | 包含以下内容的文件的路径：用户配置。访问权。设置配置文件。配额设置。 | |
| zookeeper | 包含允许 ClickHouse 与 ZooKeeper 集群交互的设置。当使用复制表时，ClickHouse 使用 ZooKeeper 来存储副本的元数据。 如果不使用复制表，这部分参数可以省略。该部分包含以下参数： 节点 — ZooKeeper 端点。 您可以设置多个端点。 session_timeout_ms — 客户端会话的最大超时时间（以毫秒为单位）。 operation_timeout_ms — 一项操作的最大超时时间（以毫秒为单位）。 root — 用作 ClickHouse 服务器使用的 znode 的根的 znode。 选修的。 fallback_session_lifetime.min - 如果通过zookeeper_load_balancing策略解析的第一个zookeeper主机不可用，则将zookeeper会话的生命周期限制到后备节点。 这样做是为了负载平衡的目的，以避免其中一台 Zookeeper 主机负载过重。 此设置设置回退会话的最短持续时间。 以秒为单位设置。 选修的。 默认为 3 小时。 fallback_session_lifetime.max - 如果通过zookeeper_load_balancing策略解析的第一个zookeeper主机不可用，则将zookeeper会话的生命周期限制到后备节点。 这样做是为了负载平衡的目的，以避免其中一台 Zookeeper 主机负载过重。 此设置设置回退会话的最大持续时间。 以秒为单位设置。 选修的。 默认值为 6 小时。 identity — ZooKeeper 可能需要用户和密码来授予对所请求的 znode 的访问权限。 选修的。 Zookeeper_load_balancing - 指定 ZooKeeper 节点选择的算法,有以下几种算法。 random - 随机选择 ZooKeeper 节点之一。 in_order - 选择第一个 ZooKeeper 节点，如果不可用则选择第二个，依此类推。 nearest_hostname - 选择主机名与服务器主机名最相似的 ZooKeeper 节点。 first_or_random - 选择第一个 ZooKeeper 节点，如果它不可用，则随机选择剩余的 ZooKeeper 节点之一。 round_robin - 选择第一个 ZooKeeper 节点，如果发生重新连接，则选择下一个。 |
|
| use_minimalistic_part_header_in_zookeeper | 此设置仅适用于 MergeTree 系列。 可以指定：全局位于 config.xml 文件的 merge_tree 部分。ClickHouse 使用服务器上所有表的设置。 您可以随时更改设置。 当设置更改时，现有表会更改其行为。对于每张表。创建表时，指定相应的引擎设置。 即使全局设置发生更改，具有此设置的现有表的行为也不会更改。可能的值0 — 功能已关闭。1 — 功能已打开。如果 use_minimalistic_part_header_in_zookeeper = 1，则复制表使用单个 znode 紧凑地存储数据部分的标头。 如果表包含很多列，这种存储方式会显着减少Zookeeper中存储的数据量。注意：应用use_minimalistic_part_header_in_zookeeper = 1 后，您无法将 ClickHouse 服务器降级到不支持此设置的版本。 在集群中的服务器上升级 ClickHouse 时要小心。 不要一次升级所有服务器。 在测试环境中或仅在集群的几台服务器上测试 ClickHouse 的新版本会更安全。已使用此设置存储的数据部分标头无法恢复为其之前的（非紧凑）表示形式。 | 0 |
| distributed_ddl | 管理在集群上执行分布式 ddl 查询（CREATE、DROP、ALTER、RENAME）。 仅当启用 ZooKeeper 时才有效。 path：DDL查询的task_queue在Keeper中的路径 profile：用于执行DDL查询的配置文件 pool_size：可以同时运行多少个 ON CLUSTER 查询 max_tasks_in_queue：队列中可以容纳的最大任务数。 默认值为 1,000 task_max_lifetime：如果节点的年龄大于此值，则删除节点。 默认为 7 * 24 * 60 * 60（一周以秒为单位） cleanup_delay_period：如果上次清理没有早于 cleanup_delay_period 秒前进行，则在收到新节点事件后开始清理。 默认值为 60 秒 |
|
| access_control_path | ClickHouse 服务器存储 SQL 命令创建的用户和角色配置的文件夹路径 | /var/lib/clickhouse/access/ |
| user_directories | 包含设置的配置文件部分：具有预定义用户的配置文件的路径。存储由 SQL 命令创建的用户的文件夹路径。ZooKeeper 节点路径，其中存储和复制由 SQL 命令创建的用户（实验）。如果指定此部分，则不会使用 users_config 和 access_control_path 中的路径。user_directories 部分可以包含任意数量的项目，项目的顺序意味着它们的优先级（项目越高优先级越高）。 | |
| total_memory_profiler_step | 设置每个峰值分配步骤的堆栈跟踪的内存大小（以字节为单位）。 query_id等于空字符串的话数据存储在system.trace_log系统表中， | 4194304 |
| total_memory_tracker_sample_probability | 允许收集随机分配和释放，并将它们写入 system.trace_log 系统表中，trace_type 等于具有指定概率的 MemorySample。 概率针对每次分配或取消分配，无论分配的大小如何。 请注意，仅当未跟踪内存量超过未跟踪内存限制（默认值为 4 MiB）时才会进行采样。 如果降低total_memory_profiler_step，则可以降低它。 您可以将total_memory_profiler_step设置为等于1以进行更细粒度的采样。0 — 禁止在 system.trace_log 系统表中写入随机分配和释放。 | 0 |
| compiled_expression_cache_size | 设置编译表达式的缓存大小（以字节为单位）。 | 134217728 |
| compiled_expression_cache_elements_size | 设置编译表达式的缓存大小（以元素为单位）。 | 10000 |
| display_secrets_in_show_and_select | 启用或禁用在表、数据库、表函数和字典的 SHOW 和 SELECT 查询中显示机密。希望查看机密的用户还必须打开 format_display_secrets_in_show_and_select 格式设置并具有 displaySecretsInShowAndSelect 权限。0禁用，1启用 | 0 |
2.配置示例
2.1 interserver_http_credentials的示例与详解：
ClickHouse 支持动态服务器间凭证轮换，无需同时停止所有副本来更新其配置。 可以通过几个步骤更改凭据。
要启用身份验证，请将 interserver_http_credentials.allow_empty 设置为 true 并添加凭据。 这允许有身份验证和无身份验证的连接。
<interserver_http_credentials>
<user>adminuser>
<password>111password>
<allow_empty>trueallow_empty>
interserver_http_credentials>
配置所有副本后，将allow_empty 设置为 false 或删除此设置。 它强制使用新凭据进行身份验证。
要更改现有凭据，请将用户名和密码移至 interserver_http_credentials.old 部分，并使用新值更新用户和密码。 此时，服务器使用新凭据连接到其他副本，并接受使用新或旧凭据的连接。
<interserver_http_credentials>
<user>adminuser>
<password>222password>
<old>
<user>adminuser>
<password>111password>
old>
<old>
<user>tempuser>
<password>000password>
old>
interserver_http_credentials>
将新凭据应用于所有副本时，可能会删除旧凭据
2.2 zookeeper配置模版
<zookeeper>
<node>
<host>example1host>
<port>2181port>
node>
<node>
<host>example2host>
<port>2181port>
node>
<session_timeout_ms>30000session_timeout_ms>
<operation_timeout_ms>10000operation_timeout_ms>
<root>/path/to/zookeeper/noderoot>
<identity>user:passwordidentity>
<zookeeper_load_balancing>randomzookeeper_load_balancing>
zookeeper>
2.3 distributed_ddl的设置
<distributed_ddl>
<path>/clickhouse/task_queue/ddlpath>
<profile>defaultprofile>
<pool_size>1pool_size>
<task_max_lifetime>604800task_max_lifetime>
<cleanup_delay_period>60cleanup_delay_period>
<max_tasks_in_queue>1000max_tasks_in_queue>
distributed_ddl>
2.4 user_directories配置的示例和解释
<user_directories>
<users_xml>
<path>/etc/clickhouse-server/users.xmlpath>
users_xml>
<local_directory>
<path>/var/lib/clickhouse/access/path>
local_directory>
user_directories>
Users, roles, row policies, quotas, and profiles 也可以存储在 ZooKeeper 中：
<user_directories>
<users_xml>
<path>/etc/clickhouse-server/users.xmlpath>
users_xml>
<replicated>
<zookeeper_path>/clickhouse/access/zookeeper_path>
replicated>
user_directories>
您还可以定义部分内存 - 表示仅将信息存储在内存中，而不写入磁盘，而 ldap - 表示将信息存储在 LDAP 服务器上。
要将 LDAP 服务器添加为本地未定义的用户的远程用户目录，请使用以下参数定义单个 ldap 部分：
- server — ldap_servers 配置部分中定义的 LDAP 服务器名称之一。 该参数为必填项，不能为空。
- roles — 包含本地定义的角色列表的部分，这些角色将分配给从 LDAP 服务器检索到的每个用户。 如果未指定角色，用户在身份验证后将无法执行任何操作。 如果在身份验证时未在本地定义任何列出的角色，则身份验证尝试将失败，就像提供的密码不正确一样。
<ldap>
<server>my_ldap_serverserver>
<roles>
<my_local_role1 />
<my_local_role2 />
roles>
ldap>
二、query-level的变量配置
1.配置和查询方法
有多种方法可以设置 ClickHouse 查询级别设置。 设置按层进行配置，每个后续层都会重新定义设置的先前值。
定义设置的优先级顺序是：
- 直接或在设置配置文件中将设置应用于用户
- SQL（推荐）
- 将一个或多个 XML 或 YAML 文件添加到 /etc/clickhouse-server/users.d
- 会话设置
- 从 ClickHouse Cloud SQL 控制台或 clickhouse 客户端以交互模式发送 SET setting=value。 同样，您可以在 HTTP 协议中使用 ClickHouse 会话。 为此，您需要指定 session_id HTTP 参数。
- 查询设置
- 非交互方式启动clickhouse客户端时，设置启动参数–setting=value。
- 使用 HTTP API 时，传递 CGI 参数（URL?setting_1=value&setting_2=value…）。
- 在 SELECT 查询的 SETTINGS 子句中定义设置。 设置值仅应用于该查询，并在执行查询后重置为默认值或之前的值。
1.1 创建用户时候直接设置
# 设置方法
CREATE USER ingester
IDENTIFIED WITH sha256_hash BY '7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3'
SETTINGS async_insert = 1
# 查看方法
SHOW ACCESS
# 也可以通过设置profile来配置
CREATE
SETTINGS PROFILE log_ingest SETTINGS async_insert = 0
CREATE USER ingester
IDENTIFIED WITH sha256_hash BY '7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3'
SETTINGS PROFILE log_ingest
1.2 通过配置文件制定
<clickhouse>
<profiles>
<log_ingest>
<async_insert>1async_insert>
log_ingest>
profiles>
<users>
<ingester>
<password_sha256_hex>7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3password_sha256_hex>
<profile>log_ingestprofile>
ingester>
<default replace="true">
<password_sha256_hex>7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3password_sha256_hex>
<access_management>1access_management>
<named_collection_control>1named_collection_control>
default>
users>
clickhouse>
1.3 设置session变量
# 这只是session级别变量
SET async_insert =1;
SELECT value FROM system.settings where name='async_insert';
# 也可以设置变量为默认值，这样就会取这个变量的默认值来设置变量async_insert的默认值为0
SET async_insert = DEFAULT;
1.4 在查询中直接制定变量
INSERT INTO YourTable
SETTINGS async_insert=1
VALUES (...)
1.5 自定义变量的设置和查询
SET custom_a = 123;
# 这个查询可以查看query-level的value为true或者false的变量，具体值的变量无法查看
SELECT getSetting('custom_a');
2.具体配置
具体配置可看官方文档，后续会逐渐补充一些用到的配置