motherduck-create-flight

该技能用于创建、运行、调度或调试 MotherDuck Flights，即运行在 MotherDuck 计算上的单文件 Python 作业，适用于摄取、转换刷新、导出告警或管理自动化。交互式分析或一次性查询应使用 motherduck-query，不需要 Flight。\n\n使用方式：当 MotherDuck MCP 可用时，必须先调用 get_flight_guide，再调用 create_flight、update_flight 或 edit_flight_source；该指南给出当前编写约定、运行限制与工具语义。无 MCP 时，对应 SQL 函数（如 MD_CREATE_FLIGHT、MD_RUN_FLIGHT、MD_LIST_FLIGHTS()）在 MotherDuck 连接上服务端执行。默认姿态：一个 Flight 对应一个含 def main() 的单文件脚本，无命令行参数，配置来自环境变量或 TYPE flights 密钥；用 duckdb.connect("md:") 连接，运行时自动注入 MOTHERDUCK_TOKEN，不要在源码、配置或依赖中硬编码令牌。依赖须在 requirements_txt 中固定版本，新建前按 duckdb-versions.json 选择受支持的 DuckDB 版本。批量加载而非逐行：先落 /tmp/ 再用 read_csv_auto/read_json_auto/read_parquet，或一次 CTAS / INSERT ... SELECT，避免对 MotherDuck 使用 executemany()。保证幂等：CREATE OR REPLACE TABLE 全量刷新、分区 DELETE+INSERT，或 dlt 的 write_disposition="merge" 加主键。标识符须用 [A-Za-z_][A-Za-z0-9_]* 校验后再拼入 DDL，数据值用 ? 绑定。先无调度创建，手动运行一次并查看日志，再附加 5 字段 cron（UTC）。可按需设置并校验 max_runtime_sec，生产使用服务账号令牌与最小权限。限制：Flight 适合编排与轻量处理，不宜在 Python 内存中处理大表，重计算应下推 SQL；疑难的运行时容量、版本与平台细节需查阅官方文档，资料中暂未提供具体数值与价格。