get-migration-assessment
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseGet Migration Assessment
获取迁移评估
The bundled references define the Azure Resource Graph query contract, response schema,
and assessment output contract.
随附的参考文档定义了 Azure Resource Graph 查询契约、响应模式和评估输出契约。
When to Use
使用时机
Use for existing Azure SQL Server assessment, readiness, blocker, SKU, and
cost data. This skill does not trigger a new assessment.
用于获取现有 Azure SQL Server 评估、就绪状态、阻碍项、SKU 和成本数据。此 skill 不会触发新的评估。
Workflow
工作流
Step 1: Resolve Inputs
第 1 步:解析输入
Use ARM resource identification when inputs are missing. Reuse identifiers
already in context. Confirm a defaulted subscription by display name and ID.
缺少输入时,使用 ARM 资源标识。复用上下文中已有的标识符。通过显示名称和 ID 确认默认订阅。
Step 2: Query Instance Data
第 2 步:查询实例数据
Build and execute the instance query from when retrieving server-level data.
references/arg-queries.md获取服务器级数据时,根据 构建并执行实例查询。
references/arg-queries.mdStep 3: Query Database Data
第 3 步:查询数据库数据
When retrieving database-level data, build and execute the database query from for every
returned instance.
references/arg-queries.md获取数据库级数据时,针对每个返回的实例,根据 构建并执行数据库查询。
references/arg-queries.mdStep 4: Interpret Results
第 4 步:解读结果
Use when interpreting results. For every target, identify the
server or database blocker. If blocker details are unavailable, report a data gap.
references/response-schema.mdNotReadyIf assessment data or is missing, state that no migration
assessment data is available and identify likely causes: it has not been enabled
or run, results have not uploaded, the agent is not configured, or permissions are
insufficient.
assessmentUploadTime解读结果时使用 。对于每个 目标,确定服务器或数据库阻碍项。如果无法获取阻碍项详情,则报告数据缺口。
references/response-schema.mdNotReady如果缺少评估数据或 ,请说明当前没有可用的迁移评估数据,并指出可能原因:尚未启用或运行评估、结果尚未上传、agent 未配置,或者权限不足。
assessmentUploadTimeStep 5: Render Results
第 5 步:呈现结果
Use assessment output when rendering the combined
readiness and SKU recommendation.
- Multiple instances -> show a summary table, then render each instance.
For multiple instances, include aggregate readiness, cost, and common blocker
insights when the returned data supports them.
呈现综合就绪状态和 SKU 建议时,使用 评估输出。
- 存在多个实例 -> 先显示汇总表,然后呈现每个实例。
对于多个实例,当返回的数据支持时,提供汇总的就绪状态、成本和常见阻碍项洞察。
Check it worked
检查是否成功
- Both query phases completed for every instance.
- Pagination completed.
- Every result has a cause or data-gap note.
NotReady - Missing settings or readiness are stated explicitly.
- Cleanup verification: Clear the in-memory ARM token and confirm no temporary request body or response file remains unless the user asked to retain it.
- 已为每个实例完成两个查询阶段。
- 已完成分页。
- 每个 结果都有原因说明或数据缺口说明。
NotReady - 已明确说明缺失的设置或就绪状态。
- 清理验证: 清除内存中的 ARM token,并确认没有遗留临时请求正文或响应文件,除非用户要求保留。
Notes
注意事项
- Use ARG as the assessment read transport.
- Execute queries through the adapter in
curlwhenever requesting ARG data.references/arg-queries.md - Exclude ,
master,model, andmsdb.tempdb - Show subscription display name with its ID.
- Follow the output template exactly.
- 使用 ARG 作为评估数据读取传输机制。
- 请求 ARG 数据时,始终通过 中的
references/arg-queries.mdadapter 执行查询。curl - 排除 、
master、model和msdb。tempdb - 同时显示订阅名称及其 ID。
- 严格遵循输出模板。
Error Handling
错误处理
- 401/403 -> verify Azure CLI login and read permission on the target scope.
- 429 -> honor ; report persistent throttling.
Retry-After - Invalid resource URI -> show the expected Azure SQL Server instance resource-ID format.
- Empty result -> show the subscription display name/ID and resource group that were searched.
- 401/403 -> 验证 Azure CLI 登录状态以及目标作用域的读取权限。
- 429 -> 遵循 ;如果持续受到限流,请报告该情况。
Retry-After - 资源 URI 无效 -> 显示预期的 Azure SQL Server 实例 resource-ID 格式。
- 结果为空 -> 显示已搜索的订阅名称/ID 和资源组。
References
参考文档
- Open before executing instance or database queries.
references/arg-queries.md - Open when interpreting ARG results.
references/response-schema.md - ARM resource identification
- Assessment output
- 执行实例或数据库查询前,打开 。
references/arg-queries.md - 解读 ARG 结果时,打开 。
references/response-schema.md - ARM 资源标识
- 评估输出