SuperAPI AI 工具集

write-script-duckdb

通用与其它

查看项目

更新于 10-16 14:37

技能介绍

用途:在 Windmill 项目里编写 DuckDB 查询或脚本时使用,帮助区分本地迭代与已部署版本的运行方式,并在改动后同步元数据。

主要能力:DuckDB 参数用注释声明、以 $name 引用;支持 ATTACH 'ducklake' 或 ATTACH 'ducklake://my_lake' 挂载 Ducklake 数据湖;可通过 ATTACH '$res:path/to/resource' AS db (TYPE postgres) 连接外部数据库资源;支持 read_csv、read_parquet、read_json 读取 S3 文件,s3:///path 为默认存储、s3://storage_name/path 为命名存储;参数类型可声明为 (s3object),Windmill 会渲染文件选择器并绑定 s3://storage/key URI;结果可用 COPY ... TO 's3:///exports/users.parquet' (FORMAT PARQUET) 写回 S3。

使用方式:脚本放在文件夹中。本地迭代用 wmill script preview <script_path>(不部署);仅当用户明确要测已部署版本时用 wmill script run <path>;编辑脚本(增删 import 或改动 main 参数)后运行 wmill generate-metadata 以刷新 .script.yaml、.lock 与 wmill-lock.yaml 哈希;磁盘文件已正确、只需刷新哈希时用 wmill generate-metadata rehash;不确定影响范围时先加 --dry-run;可用路径参数或 --strict-folder-boundaries 收窄。可用 wmill resource-type list --schema 查看资源类型。

适用场景:Windmill 工作区中的 DuckDB 数据查询、数据湖与外部库读取、S3 数据读写以及本地验证。

限制:preview 不部署但会执行代码并可能产生副作用;generate-metadata 只写本地文件,却会重新解析依赖、可能提升未固定版本,运行后需对比 .lock 变更并告知用户,必要时在代码中固定版本。部署(git push 或 wmill sync push)只在用户明确要求时执行,仅在测试或迭代时不要推送。DuckDB 不支持其他 SQL 方言的 -- s3 流式指令。收费、价格与其他未提及细节暂未提供。