SuperAPI AI 工具集

schema-e2e-validation

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:在提交前验证 YAML schema 变更,确认 schema 与线上 ClickHouse Cloud 一致,并重新生成 Python 类型、DDL 和文档,或运行完整 schema 工作流验证。

主要能力:通过 Earthly 目标执行生成与校验流程。+test-schema-generate 无需密钥,生成 types/blocks.py、types/init.py、ddl/ethereum_mainnet.sql、docs/ethereum_mainnet.md;+test-schema-validate 与 +test-schema-e2e 需要 Doppler 密钥,后者产出 e2e/types、e2e/ddl、e2e/docs。+all 运行全部非密钥目标。

使用方式:需 Docker 运行时,先执行 colima start,并用 docker ps 确认;安装 Earthly 用 brew install earthly。生成命令:cd ~/eon/gapless-network-data 后执行 earthly +test-schema-generate。完整 E2E:./scripts/earthly-with-doppler.sh +test-schema-e2e。Doppler 需配置 token 并 setup 到 gapless-network-data/prd。校验目标需要 CLICKHOUSE_HOST_READONLY、CLICKHOUSE_USER_READONLY、CLICKHOUSE_PASSWORD_READONLY。

限制与注意:本技能只验证 schema,不做设计,设计需先用 quality-tools:clickhouse-architect。常见问题包括 Docker 未启动、密钥参数应使用 --secret-file-path 而非 --secret-file、密钥值不能带引号、容器内需复制 README.md、Doppler 未配置或密钥缺失;可用 earthly --no-cache 强制重建。资料未提供更多平台或收费信息。