SuperAPI AI 工具集

monte-carlo-validation-notebook

通用与其它

查看项目

更新于 10-16 04:34

技能介绍

用途:当用户希望用 Monte Carlo SQL Notebook 查询验证 dbt 模型或快照变更时使用,支持来自 GitHub PR 或本地 dbt 仓库。

主要能力:生成包含验证查询的 SQL Notebook,输出为可直接在笔记本界面打开的导入 URL:<MC_BASE_URL>/notebooks/import#<base64-encoded-yaml>。支持数据库参数(prod_db 和 dev_db)、按模型自动推断 schema、单表验证查询与前后对比查询。

用法:参数中第一个为必填目标(GitHub PR URL 或本地 dbt 仓库路径);可选 --mc-base-url <URL>(默认 https://getmontecarlo.com);可选 --models <model1,model2,...> 指定模型文件名(不含 .sql),默认包含所有变更模型,最多 10 个。目标含 :// 或 github.com 时进入 PR 模式,否则为本地模式。

前置条件:PR 模式需已认证的 gh(GitHub CLI);需 python3;需安装 pyyaml(pip3 install pyyaml)。技能包含两个辅助脚本:resolve_dbt_schema.py 和 generate_notebook_url.py。生成的 SQL 使用 ANSI 兼容语法,适用于 Snowflake、BigQuery、Redshift 和 Athena,特定仓库可能需微调。

限制:仅在任务明确匹配上述范围时使用;输出不能替代环境特定验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。建议配合 Sonnet 使用,可先运行 /model sonnet。