用途:面向阿里云 DataWorks 语义分析作业,使用 aliyun dataworks-public 插件暴露的公开 OpenAPI,完成创建可复用语义分析作业、提交或停止运行、监控执行、下载生成的结果文件。
前置检查:先安装或更新插件,再探测产品 API 命令。
aliyun version aliyun plugin install --names dataworks-public aliyun plugin update
CLI 缺失或低于 3.3.3 时,引导用户查阅官方安装文档。凭据检查仅允许 aliyun configure list,禁止 configure set。
会话与标识:每个会话开始时生成一次 32 位小写十六进制 session-id,并在所有 CLI、SDK、Terraform 操作(含重试、轮询、下载)中复用。每个产品 API 命令须带 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-dataworks-semantic/${SEMANTIC_SESSION_ID}" --read-timeout 60 --connect-timeout 10。
主要能力:create-semantic-job、run-semantic-job、list-semantic-job-runs、download-semantic-results,以及停止用的 kill-semantic-job 和诊断用的 get-semantic-job-detail、get-semantic-job-log。
核心流程:按精确区分大小写的 Name 解析作业;创建前先列出作业避免重复,源类型支持 maxcompute、holo、starrocks、singleTableFile;运行后保存 JobRunId 与 ExecutorJobId,用 get-semantic-job-detail 的 Data.Statuses 判断状态(1=WAITING、2=RUNNING、3=FINISH、4=ERROR、6=KILLED);仅在明确要求停止该次运行时调用 kill-semantic-job;仅在运行成功终止后调用 download-semantic-results,且只调用一次并重定向到受限临时文件。
限制:不调用更新、删除、归档、发布或结果文件变更操作;运行消耗算力,不得为查询状态而提交;预签名 URL 视为凭据不得打印;当前公开插件不暴露稳定的语义模型/版本资源,列出已发布模型、发布版本或按 ModelId 与 VersionNo 获取模型均超出公开契约。