用途:把 Subsquid Pipes 索引器部署到 ClickHouse,本地用 Docker 做开发与测试,生产用 ClickHouse Cloud。触发场景包括用户提到 deploy、run locally、docker、ClickHouse Cloud 或生产部署。
主要能力:检测或创建本地 ClickHouse 容器、配置浏览器仪表盘所需的 CORS、创建数据库、清理 sync 表、写入 .env、启动索引器并做 30 秒数据校验;云端则校验连接、建库、配置 .env、启动并查询同步进度;还提供 MCP 配置与故障排查。
本地用法:先 docker ps | grep clickhouse 检查容器,无则用 docker run 创建(端口 8123/9000,挂载 clickhouse-data)。浏览器直连 HTTP 8123 时需挂载 cors.xml 并重启容器。随后验证容器、建库、按需 DROP TABLE IF EXISTS $DATABASE_NAME.sync、配置 CLICKHOUSE_URL=http://localhost:8123 等变量,再 npm run dev。
云端用法:需 SERVICE_URL、DATABASE_NAME、USERNAME、PASSWORD;先用 curl 校验连接,再建库、配置 .env、按需清理 sync 表、npm run dev。索引器进程可跑在本机、Railway、云主机或 Kubernetes。
限制与注意:每个索引器应使用独立数据库,否则会共用 {database}.sync 导致从错误位置续跑;密码约定在 docker-compose 与独立 docker run 间不一致,需核对;日志首行应为 Start indexing from X,出现 Resuming from X 需排查 sync 表;30 秒无数据需检查合约地址、起始块、事件名与 ABI。生产 CORS 不应使用 *。具体收费、价格与平台细节资料未提供。