用途:在 MotherDuck 中创建数据模型、表、设计架构、选择数据类型、定义表间关系,或为分析型负载重构数据。
主要能力:当用户提出“构建数据模型”“为数据建模”“创建转换层”等需求时,默认输出基于文件的项目脚手架,而非直接在仓库中执行 SQL。脚手架包含按生命周期阶段(raw/、staging/、analytics/)组织的 SQL 文件,以及 model_manifest.yml,用于定义 DAG:模型名称、依赖、物化策略和目标数据库。
使用方式:前置条件包括通过 connect 建立 MotherDuck 连接、通过 explore 了解现有源结构、通过 duckdb-sql 获取 DuckDB SQL 语法。工作流为:先检查源表与实际列类型,再为每个建模表选择目标阶段与粒度并映射依赖,创建目录结构与 SQL 文件,逐个编写模型(显式类型、可空性、注释、全限定名),填写 manifest 元数据,最后运行模型并验证粒度与行数。
默认原则:面向分析读取而非事务写入,偏好宽反规范化表与预聚合服务表;使用全限定名并添加注释;积极使用 NOT NULL,不假设主键或外键被强制;非平凡项目分离 raw、staging、analytics 阶段;始终产出 SQL 文件与 manifest。
适用场景:多表、多阶段、带依赖的建模工作。若用户明确要求单表、快速 DDL 或临时探索查询,则直接产出 SQL,跳过脚手架。
限制:资料未提供具体收费、价格、平台支持范围或效果数据。