tencent cloud

文档反馈

参数配置

最后更新时间:2024-01-19 16:45:30

    功能介绍

    为方便不同用户角色的使用习惯,ClickHouse 集群的配置管理功能提供了 KV 模式和基于 XML 模式修改集群关键配置参数,并将修改后的配置文件内容以集群维度推送到集群节点中。本文将为您介绍如何通过控制台对配置参数进行操作。

    功能说明

    2021年8月前创建的存量集群通过 KV 模式的参数管理配置,2021年8月后新集群将默认使用 XML 配置管理功能。存量集群如需使用XML 配置管理,可通过 [售后支持](https://www.tencentcloud.com/contact-us) 联系技术支持开通使用。
    注意:
    目前集群参数配置呈现可 KV 模式和 XML 模式二选一。新建集群默认支持 KV 模式,可切换启用 XML 模式参数配置,而已启用 XML 模式参数配置不支持切回 KV 模式参数配置。
    如果集群在之前通过工单的方式由技术支持维护或调整过集群配置,建议在使用以下功能时,先与技术支持确认当前的配置文件的内容。

    操作步骤

    1. 登录 云数据仓库 控制台,在【集群列表】中选择对应的集群,单击集群【名称/ID】进入集群详情页,在集群详情页单击【参数配置】。
    2. 存量集群“参数配置”页面以 KV 模式配置参数,支持的参数来自 config.xml 文件。按需调整参数后,单击【应用到集群】,修改后的参数即可生效。
    
    3. 新建集群或存量集群使用 XML 模式配置管理后,在“参数配置”页面会显示 XML 模式的参数配置。目前 XML 模式参数支持包括 config.xml、metrika.xml、users.xml 三个配置文件的当前内容的查看和编辑。下图显示了配置文件的当前内容。
    
    可直接对配置文件的内容进行编辑,修改后可单击【保存配置】。
    
    可以通过【对比详情】查看修改情况。
    
    确定修改无误后,可单击【保存并下发】将新配置提交到集群节点上。
    4. 配置下发提交成功后,集群状态会进入“状态变更中”,并且修改的配置文件会提示“配置发生变化,请重启”。请根据具体配置修改的内容判断是否需要重启。如需重启,则单击右上角的【重启】,进行集群节点重启。
    
    4.1
    提交配置修改后,可以在【修改历史】中查看配置文件的修改历史,以及每次修改的对比详情。

    注意事项

    不建议用户在配置文件增加 Clickhouse 内核本身不支持的配置项,防止启动失败或其他问题。Clickhouse 支持的配置信息详情请参考 Clickhouse 官方文档
    目前该 XML 配置管理对 metrika.xml 支持的信息是有限的,目前只支持以下配置项和对应内容的修改。
    <yandex>
    <clickhouse_remote_servers>
    <default_cluster>
    <shard>
    <internal_replication></internal_replication>
    <replica>
    <host></host>
    <second_host></second_host>
    <port></port>
    <user></user>
    <password></password>
    </replica>
    </shard>
    </default_cluster>
    <new_cluster_1>
    <shard>
    <internal_replication></internal_replication>
    <replica>
    <host></host>
    <second_host></second_host>
    <port></port>
    <user></user>
    <password></password>
    </replica>
    </shard>
    </new_cluster_1>
    </clickhouse_remote_servers>
    <zookeeper-servers>
    <node>
    <host></host>
    <port></port>
    </node>
    </zookeeper-servers>
    </yandex>
    其中,new_cluster_1 表示支持新的 cluster 的名称,second_host 为 ClickHouse 对内核一个改进功能参数,目前只在 Clickhouse 内核版本20.8.7.15中支持。
    不支持 port 的修改,不支持 host 的 IP 设置为其他 IP 或其他集群的 IP。默认生成的 metrika.xml 中的 host 的 IP 与【基本信息】>【网络信息】中看到的 IP 是同一节点的两个 IP,前者用于后台管理,后者用于用户访问,metrika.xml 中的 IP 要使用非用户 VPC 的 IP 进行配置。
    建议 metrika.xml 只用于维护以上与 cluster 和 zookeeper 相关的信息,如果在 metrika.xml 中增加了其他不支持的配置项,虽然提交修改成功,但是有不生效或丢失的风险。metrika.xml 后续会逐渐完善对更多配置项的支持后,会同步文档说明。
    另外在 config.xml 中,与 ClickHouse 管控相关的一些信息,例如端口号、日志路径等不建议修改,可能会导致 ClickHouse 运行与管理的异常。建议只对 ClickHouse 运行配置进行调整,例如性能、压缩算法、MergeTree 等内容进行调整,不建议修改的配置项包括:
    <yandex>
    <logger>
    <level>trace</level>
    <log>/data/clickhouse/clickhouse-server/logs/clickhouse-server.log</log>
    <errorlog>/data/clickhouse/clickhouse-server/logs/clickhouse-server.err.log</errorlog>
    <size>1000M</size>
    <count>10</count>
    </logger>
    <http_port>8123</http_port>
    <tcp_port>9000</tcp_port>
    <mysql_port>9004</mysql_port>
    <interserver_http_port>9009</interserver_http_port>
    <path>/data/clickhouse/clickhouse-server/</path>
    <tmp_path>/data/clickhouse/clickhouse-server/tmp/</tmp_path>
    <user_files_path>/data/clickhouse/clickhouse-server/user_files/</user_files_path>
    <users_config>users.xml</users_config>
    <timezone>Asia/Shanghai</timezone>
    <mlock_executable>true</mlock_executable>
    <remote_servers incl="clickhouse_remote_servers" />
    <zookeeper incl="zookeeper-servers" optional="true" />
    <macros incl="macros" optional="true" />
    <prometheus>
    <endpoint>/metrics</endpoint>
    <port>9363</port>
    <metrics>true</metrics>
    <events>true</events>
    <asynchronous_metrics>true</asynchronous_metrics>
    </prometheus>
    <query_log>
    <database>system</database>
    <table>query_log</table>
    <partition_by>toYYYYMM(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
    </query_log>
    <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_thread_log>
    <database>system</database>
    <table>query_thread_log</table>
    <partition_by>toYYYYMM(event_date)</partition_by>
    <flush_interval_milliseconds>7500</flush_interval_milliseconds>
    </query_thread_log>
    <compression incl="clickhouse_compression">
    </compression>
    <distributed_ddl>
    <path>/clickhouse/task_queue/ddl</path>
    </distributed_ddl>
    <listen_host>0.0.0.0</listen_host>
    <zookeeper incl="zookeeper-servers" optional="true" />
    <macros incl="macros" optional="true" />
    <include_from>/etc/clickhouse-server/metrika.xml</include_from>
    </yandex>
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持