get-migration-assessment

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Get 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
references/arg-queries.md
when retrieving server-level data.
获取服务器级数据时,根据
references/arg-queries.md
构建并执行实例查询。

Step 3: Query Database Data

第 3 步:查询数据库数据

When retrieving database-level data, build and execute the database query from
references/arg-queries.md
for every returned instance.
获取数据库级数据时,针对每个返回的实例,根据
references/arg-queries.md
构建并执行数据库查询。

Step 4: Interpret Results

第 4 步:解读结果

Use
references/response-schema.md
when interpreting results. For every
NotReady
target, identify the server or database blocker. If blocker details are unavailable, report a data gap.
If assessment data or
assessmentUploadTime
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.
解读结果时使用
references/response-schema.md
。对于每个
NotReady
目标,确定服务器或数据库阻碍项。如果无法获取阻碍项详情,则报告数据缺口。
如果缺少评估数据或
assessmentUploadTime
,请说明当前没有可用的迁移评估数据,并指出可能原因:尚未启用或运行评估、结果尚未上传、agent 未配置,或者权限不足。

Step 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
    NotReady
    result has a cause or data-gap note.
  • 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
    curl
    adapter in
    references/arg-queries.md
    whenever requesting ARG data.
  • Exclude
    master
    ,
    model
    ,
    msdb
    , and
    tempdb
    .
  • Show subscription display name with its ID.
  • Follow the output template exactly.
  • 使用 ARG 作为评估数据读取传输机制。
  • 请求 ARG 数据时,始终通过
    references/arg-queries.md
    中的
    curl
    adapter 执行查询。
  • 排除
    master
    、
    model
    、
    msdb
    和
    tempdb
    。
  • 同时显示订阅名称及其 ID。
  • 严格遵循输出模板。

Error Handling

错误处理

  • 401/403 -> verify Azure CLI login and read permission on the target scope.
  • 429 -> honor
    Retry-After
    ; report persistent throttling.
  • 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
    references/arg-queries.md
    before executing instance or database queries.
  • Open
    references/response-schema.md
    when interpreting ARG results.
  • ARM resource identification
  • Assessment output
  • 执行实例或数据库查询前,打开
    references/arg-queries.md
    。
  • 解读 ARG 结果时,打开
    references/response-schema.md
    。
  • ARM 资源标识
  • 评估输出