SuperAPI AI 工具集

motherduck-model-data

数据与分析

查看项目

更新于 10-16 01:20

技能介绍

用途:在 MotherDuck 中设计或实现分析型 schema 与转换模型,关注粒度、数据类型和物化方式。

主要能力:多模型工作可将转换保留在可审查的 SQL 文件中,沿用项目已有的 dbt、SQLMesh 或本地约定;若不存在,则使用 stage 目录和 model_manifest.yml 记录依赖、物化与目标数据库。单表请求只需提供所请求的 SQL 或变更。

使用方式:先检查源表与实际列类型,再设计新模型;为每个建模表选择目标生命周期阶段和粒度,映射模型间依赖;将 SQL 放入现有项目,或为新多模型项目使用脚手架参考;每个模型写成独立 SQL 文件,使用显式类型、可空性、注释和完全限定名;根据新鲜度与成本在表、CTAS 重建或视图之间选择;在项目框架或轻量清单中记录依赖与物化,不要两者都记。实现时运行范围内模型并验证粒度与行数;MCP DDL 和 CTAS 需要 query_rw。若只需答案、审查或计划,则返回所请求的解释或 SQL,不创建项目或改动仓库。

适用场景:分析读取建模、宽反规范化表、预聚合服务表、非平凡项目的 raw/staging/analytics 分层。

限制:默认面向分析读取而非事务写入;不假设主键或外键被强制,应积极使用 NOT NULL;需先发现缺失的类型、粒度和连接键;规划可使用提供的 schema 而无需实时连接。相关技能包括 motherduck-duckdb-sql、motherduck-query、motherduck-explore、motherduck-load-data、motherduck-manage-guides。