本文介绍如何修改ByteHouse企业版集群config.xml、user.xml配置文件参数的方法。
ByteHouse 企业版集群有若干参数，参数默认值通常配置在config.xml和user.xml，您可以修改参数进行实例优化，其中：
- user.xml配置文件：您可以通过 集群管理 -> 用户参数 可视化修改相关参数值，修改后无需重启集群，详情请参见用户参数修改。
- config.xml配置文件：您可以通过控制台修改相关参数值，请参见本文提示进行修改。
- config.xml修改的参数需要重启生效的参数，完成参数修改后，需要手动重启集群。请先确认重启目标集群不会对业务产生影响。
在ByteHouse企业版中，config.xml用来管理集群级别的参数设置，当您需要为ByteHouse集群配置级别参数时，可以通过修改config.xml来进行设置。
操作步骤
- 登录ByteHouse管理控制台。
- 在页面左上角，选择目标集群所在的地域。
- 在集群列表页面，单击目标集群名称。
- 在左侧对应集群，单击查看集群参数/修改集群参数。
- 进入参数编辑状态，您可以通过 视觉化配置 或 XML设置修改 参数值，并点击保存配置下发，完成集群参数修改。
- 请您确认重启目标集群不会对业务产生影响，提交集群重启让参数生效。
参数说明
参数名称 | 默认值 | 参数描述 |
|---|---|---|
builtin_dictionaries_reload_interval | 3600 s | |
compiled_expression_cache_size | 134,217,728 bytes | |
default_session_timeout | 3600 s | |
keep_alive_timeout | 10 s | 在关闭连接之前等待传入请求的秒数 |
max_session_timeout | 3600 s | |
mark_cache_size | 4,294,967,296 bytes | |
max_concurrent_queries | 200 | |
max_connections | 4096 | 最大连接数 |
max_open_files | 0 | |
max_partition_size_to_drop | 0 bytes | drop part的大小限制 |
max_server_memory_usage_to_ram_ratio | 0.9 | |
max_table_size_to_drop | 0 bytes | drop表的大小限制 |
uncompressed_cache_size | 4,294,967,296 bytes | 使用的未压缩数据的缓存大小，默认 4GB |
timezone | UTC | 集群时区 |
在ByteHouse企业版中，user.xml用来管理用户级别的参数设置以及用户信息、权限信息等，当您需要为ByteHouse集群配置用户级别参数时，可以通过修改user.xml来进行设置。
操作步骤
- 登录ByteHouse管理控制台。
- 在页面左上角，选择目标集群所在的地域。
- 在集群管理 -> 集群列表 。
- 选择目标集群中的查看用户参数
- 选择您想修改的用户参数，例如Default Profile
- 点击右上角的修改配置，与集群参数类似，用户参数同样分为可视化设置和XML设置，您可以现在可视化设置中搜索您要修改的配置，如果没有则可以在XML设置中通过编辑XML文件的方式修改
- 修改完成后点击左下角的保存并下发即可完成配置修改
- 用户参数不需要重启，修改完成后秒级即可生效
参数说明
参数名称 | 默认值 | 参数描述 |
|---|---|---|
| CLICKHOUSE | SQL 方言。可选 CLICKHOUSE / ANSI / MYSQL |
| 0 | 查询是否在节点内先计算出结果再联合多节点结果，当可以确保查询的 JOIN KEY = GROUP BY KEY = SHARDING KEY 时设置为 1，查询性能将大幅提升。其余情况需要设置为 0，不然查询结果会错误 |
| 1（True） | 在 JSONEachRow/TSKV 等格式导入时，是否忽略未知列（1 为忽略，0 为报错）。 |
| 300 s | 单条 SQL 查询的最大超时时间（单位：秒）。 |
| 1,048,576 行 | 单个 INSERT 操作中生成一个数据块（Part）的最大行数。 |
| 0 bytes（不限制） | 单个 INSERT 操作中生成一个数据块（Part）的最大字节数（预估值）。 |
| 9,771,050,598 bytes（约 9.1 GB） | 单次查询允许使用的最大内存。 |
| 9,771,050,598 bytes（约 9.1 GB） | 同一用户所有并发查询允许使用的最大内存总和。 |
| 9,771,050,598 bytes（约 9.1 GB） | 同一时刻所有用户查询允许使用的最大内存总和。 |
| 1,000 | 单个 INSERT 操作中数据最多分布的分区数，用于避免生成过多小文件。 |
| 1,048,576 bytes（约 1 MB） | SQL 语句的最大长度限制。 |
| 8 | 查询处理线程的最大数量（不包括从远程服务器检索数据的线程）。 |