SuperAPI AI 工具集

clickhouse-replicated

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:整理三台主机上运行复制版 ClickHouse、并在 clickhouse-server 内嵌 Keeper 的部署经验与故障排查索引,属于 Context Skill 性质,本身不附带实现文件(遵循 no-second-copy 规则)。

主要能力:按症状定位问题,包括服务器无法启动(systemctl 报 status=232/ADDRESS_FAMILIES、err.log 为空,只有 journalctl 显示 SAXParseException: Invalid token)、Code: 36 与 PARTITION BY/engine 冲突、各节点对端端口显示 CLOSED、BACKUP 显示 BACKUP_CREATED 但对象路径不符、还原副本与在线库并存、应用读还原库报 500、权限不足、副本间无法达到 3、system.query_log 不存在、converge 十分钟超时、S3 备份对象数与计数不一致、AWS 相关故障与 TLS/加密差异等。

使用方式:当出现上述症状之一时加载本技能,逐条查 references/failure-catalogue.md 的原文条目;XML 语法错误可用 python3 -c 'import xml.dom.minidom,sys; xml.dom.minidom.parse(sys.argv[1])' 离线复现。文中给出参考实现位置(getcolors/langfuse 包的 src/resources/io/github/getcolors/langfuse/tools/ 下 Ansible 与 XML 模板),本技能只解释其设计原因。

适用场景与限制:适用于单分片三副本、VPC 内网、原生备份至 R2 并做就地还原演练的 ClickHouse 层;结论基于 2026-09-03 Vultr 实测及 2026-09-10 AWS 评估。未实测行为、应用侧后果(属 langfuse-multi-node)和其它环境是否成立均未提供,不应外推;本资料未提供安装命令、收费或价格信息。