用途:在 Windmill 中编写 Microsoft SQL Server(MSSQL)脚本时使用,指导本地脚本的预览、运行、元数据同步与部署流程。
主要能力:MSSQL 脚本参数使用 @P1、@P2 等占位符,并在语句前用注释命名与标注类型,例如:-- @P1 name1 (varchar)、-- @P2 name2 (int) = 0。可将参数声明为 (s3object) 类型,Windmill 会显示 S3 文件选择器并下载文件,以 nvarchar(max) 的 JSON 文本绑定;Parquet/CSV 在服务端解码为 JSON 记录数组,JSON/JSONL 直接透传,配合 OPENJSON 消费。在脚本顶部添加 -- s3 指令可将结果集流式写入 S3 并返回其 S3Object,支持 prefix、storage、format(json 默认、parquet、csv)等可选键,适合大结果集。
使用方式:本地迭代用 wmill script preview <script_path>;仅当用户明确要测已部署版本时用 wmill script run <path>;改动脚本内容后运行 wmill generate-metadata 重新生成 .script.yaml、.lock 并刷新 wmill-lock.yaml 中的内容哈希,可用 --dry-run 查看受影响项,用 rehash 仅刷新哈希。部署仅在用户明确要求时执行,方式为 git push 或 wmill sync push。可用 wmill resource-type list --schema 查看资源类型。
限制:预览会实际执行脚本代码并可能产生副作用;generate-metadata 只写本地文件,但会重新解析依赖,可能升级未锁定版本。资料未提供具体价格、平台支持范围等信息。