用途:该技能面向 DuckDB SQL 语法查询与修复,并核实 MotherDuck 专有命令和功能是否受支持。
主要能力:以当前 DuckDB SQL 文档为语言特性与函数语义的权威来源;MotherDuck 独有命令(如 shares、secrets、snapshots、Dive 操作)以 MotherDuck SQL 文档为准。默认写 DuckDB SQL 而非 PostgreSQL SQL,即使通过 Postgres 端点连接。当涉及多个数据库或 share 时,使用完全限定的 "database"."schema"."table" 名称。优先使用 DuckDB 原生构造简化查询,如 GROUP BY ALL、QUALIFY、UNION BY NAME、arg_max、EXCLUDE、REPLACE。从其他引擎移植 SQL 时,需显式转换函数、日期运算、标识符引用和类型转换。
使用方式:先确认连接路径,判断问题属于语法、功能支持还是具体报错;先用 DuckDB SQL 编写或修复语句;再对照当前文档核实 MotherDuck 专有命令或服务器模式限制。需要精确语法或函数细节时查阅 references/SYNTAX_REFERENCE.md,仅阅读当前任务所需章节。
限制与注意:MotherDuck 客户端兼容性可能滞后于上游 DuckDB 版本,承诺新语法或类型前需查版本生命周期文档。依赖本地文件、扩展安装加载、临时表行为等客户端专属特性时,需先确认在 MotherDuck 中是否可用。snapshot、restore、UNDROP DATABASE 属运维类 SQL,有套餐相关保留行为。INCLUDE_PATTERN 是 Share 的整表/视图过滤,非行级或列级安全。物理导入与零拷贝克隆来源需区分,过滤后的 share 不可作为克隆来源。相关技能:motherduck-query、motherduck-connect、motherduck-explore。