SuperAPI AI 工具集

running-dbt-commands

测试与质量

查看项目

更新于 10-15 23:46

技能介绍

用途:该技能用于格式化并执行 dbt CLI 命令,帮助选择正确的 dbt 可执行文件并组织命令参数,适用于运行模型、测试、构建、编译以及预览数据等操作。

主要能力与建议:优先使用可用的 MCP 工具(如 dbt_build、dbt_run、dbt_show),它们会自动处理路径、超时与格式。倾向于使用 build 而非 run 或 test,因为 test 不会刷新模型,而 build 会按 DAG 顺序对每个节点(模型、种子、快照)执行 run 和 test。建议始终搭配 --quiet 与 --warn-error-options '{"error": ["NoNodesForSelectionCriteria"]}',以减少输出并捕获选择器拼写错误。始终使用 --select,未经用户明确批准不要运行整个项目。

用法要点:标准命令示例为 dbt build --select my_model --quiet --warn-error-options '{"error": ["NoNodesForSelectionCriteria"]}';预览用 dbt show --select my_model --limit 10;内联 SQL 用 dbt show --inline "select * from {{ ref('orders') }}" --limit 5。变量以字符串传入,多个变量用 JSON 格式,如 --vars '{"key": "value"}'。增量模型全量刷新用 --full-refresh。运行前可用 dbt list 预览选择结果。选择器支持图形操作符(model+、+model、+model+、model+N)、路径、FQN、联合与交集、排除以及 --resource-type 过滤。dbt show 应使用 --limit 参数而非 SQL LIMIT。

CLI 类型:存在三种 CLI——dbt Core(Python 虚拟环境)、dbt Fusion(~/.local/bin/dbt 或 dbtf)、dbt Cloud CLI(~/.local/bin/dbt)。不确定时应询问用户。运行结果可查看 target/run_results.json,关键字段包括 status、execution_time、compiled_code、adapter_response。可用 --defer --state 引用生产数据跳过上游构建,Fusion 独有静态分析开关。

限制:本资料未提供安装步骤、版本要求、收费信息及平台支持细节。