运行时依赖
安装命令
点击复制技能文档
⚠️ 关键输出完整性要求:使用此技能时,必须输出完整的脚本结果,不得进行任何截断、省略或总结。脚本输出每个任务行的全部内容——您的模型响应必须做同样的事情。绝不能使用“...”占位符或总结任务数量。必须完全显示所有行,如下所示。
DTS 任务状态查询:使用 Alibaba Cloud CLI 查询 DTS 任务状态。输出结果为中文。
前提条件: 关键:启用 AI 模式和插件设置。在使用此技能之前,您必须配置 AI 模式并更新插件: # 启用插件基于 API 调用的 AI 模式 aliyun configure ai-mode enable # 设置用户代理以确保插件兼容性 aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-dts-task-query" # 更新所有插件到最新版本 aliyun plugin update --all # 验证 DTS 插件是否安装 aliyun plugin list # 如果需要,可以通过以下命令禁用 AI 模式 aliyun configure ai-mode disable 注意:此技能使用插件模式命令(aliyun dts describe-dts-jobs)。必须启用 AI 模式才能正确执行这些命令。
所需 RAM 权限:请参阅 references/ram-policies.md 中的详细 RAM 策略要求。
支持的区域:如果未指定区域,则会自动查询所有 27 个公共云区域。
使用方法: python scripts/query_dts_tasks.py [--region ] [--instance-id ] [--job-name ] [--workers ]
⚠️ 强制模型响应规则: 始终输出完整数据:显示每个任务行,没有任何省略 绝不截断:没有“...”占位符,没有“显示前 N 个任务”,没有总结 始终列出所有任务:每个任务在迁移/同步/订阅组中必须逐行显示 脚本输出 100%:脚本保证完整输出——您的响应必须匹配 100% 记住:当脚本有 23 个任务时,您必须输出所有 23 行。没有例外。
性能优化: --workers:并发 API 调用的数量(默认:8)。推荐值: 8:默认,稳定的性能(~10 秒全扫描) 12-16:适用于高带宽网络(~6-8 秒全扫描) >16:可能会遇到 API 限速或本地资源约束
可靠性功能(v12): API 重试逻辑:最多重试 3 次,具有指数退避,以确保一致的结果 解决问题:消除了由暂时性 API 故障和超时引起的计数变化 影响:脚本现在始终返回相同的任务数量(例如,始终 34 个任务,而不是 32-34 个)
v12.1:增加超时时间到 10 秒,并添加指数退避(0.2 秒,0.4 秒),以提高可靠性 线程安全集合:使用 Lock 以防止并行数据收集期间的竞争条件 严格的响应验证:仅接受具有有效“DtsJobList”字段的响应 详细的错误日志:区分超时错误和其他异常,以便于调试 已验证:经过 50+ 次连续运行测试——所有结果均相同
执行规则(强制): 完整轮询:必须迭代所有 27 个区域和 3 种作业类型(MIGRATION、SYNC、SUBSCRIBE),除非指定了特定区域。 区域注入:脚本必须在查询阶段将 _QueryRegion 字段注入每个任务对象中。 海外区域端点:对于海外区域,脚本必须添加 --endpoint 参数以成功查询任务。 PayType 过滤:读取临时文件后,严格过滤任务以仅包括 PayType 为 PrePaid 或 PostPaid 的任务。
中文输出:所有输出(摘要和表头)必须为中文。JobType 必须映射(例如,migration -> 迁移)。 分组输出:任务按类型(迁移/同步/订阅)分组,每组按 CreateTime 排序(最新的第一)。 并行执行:脚本必须使用 ThreadPoolExecutor 进行并行查询(v11+)。默认 8 个工作者,可以通过 --workers 配置。 API 重试:脚本最多重试 3 次以确保可靠性(v12+)。 线程安全:脚本使用 Lock 以防止线程不安全的数据收集(v12+)。 参数严格性:必须使用用户输入中提供的确切区域 ID 和过滤关键字。不要替换区域(例如,cn-shanghai),即使用户输入似乎模糊。 过滤执行:如果提供 --job-name,则必须将其传递给脚本而不省略。
输出格式:
- 统计摘要
- 任务明细