使用新式化 CLI 评估SQL Server迁移准备情况(预览版)

使用现代化 CLI 评估本地或本地部署的 SQL Server 依赖项,作为端到端应用程序和数据库现代化旅程的一部分。 评估评估Azure SQL 数据库超大规模迁移准备情况,并确定兼容性问题和实现工作负荷现代化所需的工作量。

CLI 可以从应用程序配置发现SQL Server终结点,或评估指定的实例。 还可以根据现有性能数据请求容量建议。

根据工作负荷要求选择这些目标时,Azure SQL 托管实例和Azure 虚拟机中的 SQL Server保持备用迁移路径。

Important

Modernize CLI 中的 SQL Server 评估功能现处于公开预览阶段。 此工作流评估就绪情况;它不会迁移数据库、预配Azure资源或收集新的性能数据。 在Windows本地运行它,而不是通过云代理委派运行它。

Prerequisites

  • 现代化 CLI 及其GitHub身份验证先决条件。
  • 具有 SQL Server 依赖项的本地应用程序检出副本。
  • 可以访问源SQL Server的Windows计算机。
  • PowerShell 7。
  • Azure CLI版本 2.75.0 或更高版本,并且已安装datamigration扩展。 请参阅安装 Azure CLI。
  • 具有评估源SQL Server的权限的现有标识或受保护的连接配置。

SQL Server评估技能下载 SQL 评估包;无需单独下载它。

在开始之前准备其他必需的工具、扩展、凭据和网络访问。 该评估不会让你登录。 此 SQL Server 工作流不支持 Linux 和 macOS,尽管 Modernize CLI 在其他场景中支持这些平台。

评估应用程序对 SQL Server 的依赖项

使用 完整分析作为附加评估技能运行数据库评估。 默认的“仅问题”设置不会运行它。

交互模式(TUI)

  1. 在应用程序目录中,运行现代化代理:

    modernize
    
  2. 从主菜单中选择 “评估 ”。

  3. 选择 当前文件夹 以评估应用程序,或 手动输入 以输入本地应用程序路径。

  4. 选择与应用程序相关的评估域,然后继续执行评估配置。

  5. 在 “常规/分析覆盖范围” 下,选择 “完全分析”,然后选择 “继续”。

  6. 选择“ 在本地评估”。 SQL Server评估需要具有源SQL Server访问权限的Windows计算机。

  7. 输入输出路径或接受默认值,然后启动评估。

CLI 使用存储库证据来选择适用的数据库评估技能。 有关交互式屏幕的详细信息,请参阅 Batch 评估:交互式模式。

无头模式

创建一个评估配置文件,例如 C:\configs\database-assessment.yml,并使用以下设置:

analysisCoverage: full

将此设置与任何现有配置合并,而不是替换其他评估设置。 将文件传递到 --assess-config 以下命令中所示,并将源、配置和输出路径替换为你自己的路径:

modernize assess `
  --source C:\src\sql-app `
  --assess-config C:\configs\database-assessment.yml `
  --output-path C:\reports\sql-app `
  --format markdown `
  --delegate local `
  --no-tty `
  --prompt 'Assess local or on-premises SQL Server dependencies for migration readiness to Azure SQL.'

或者,通过设置 %USERPROFILE%\.modernize\assessment-config.yaml 更新位于 assessment-config.yaml 的现有用户级 analysisCoverage: full 文件。 如果使用该文件,请从命令中省略 --assess-config 。 显式 --assess-config 路径优先于用户级文件。

Note

可选的 --prompt 为其他数据库评估技能提供上下文。 它不会更改 Modernize CLI 的内置 AI 分析。 CLI 从存储库证据和此可选上下文中选择适用的技能;仅在自述文件中提及SQL Server并不能确定适用性。

SQL Server目标发现

如果未提供实例,SQL 评估将从支持的应用程序设置(包括连接设置和引用的环境变量)解析具体终结点。 它不执行应用程序代码来解析动态设置。 它评估每个不同的已解析终结点,而不仅仅是第一个终结点。

在本地执行过程中解析可用的应用程序凭据。 如果没有受支持的凭据可用,工作流将使用当前的Windows标识。 提供的凭据验证失败不会触发使用不同身份验证方法的重试。

如果发现无法解析终结点,请显式指定实例。

指定SQL Server实例

在评估上下文中使用非机密选择器:

modernize assess `
  --source C:\src\sql-app `
  --assess-config C:\configs\database-assessment.yml `
  --output-path C:\reports\sql-app `
  --format markdown `
  --delegate local `
  --no-tty `
  --prompt 'Assess local SQL Server migration readiness. instanceName=localhost; authMode=Windows.'

将 localhost 替换为源 SQL Server 数据源,必要时包括其命名实例或端口。 显式instanceName限制评估目标;它不是连接字符串或Azure Arc资源 ID。

instanceName、authMode以及本文中的其他选择器是评估上下文,而不是新的 CLI 标志。 请勿使用诸如 --instanceName 之类的标志。

选择现有的身份验证源

对于显式选择的实例,在需要新评估时,同时省略 authMode 和 configFilePath 这两者时,将使用当前 Windows 标识。 可以改为在上下文中提供以下身份验证选择之一:

身份验证选择 其他非机密上下文 先决条件
authMode=Windows None 当前Windows标识具有SQL Server访问权限。
authMode=EntraDefault None 已安装的评估工具支持的可用的非交互式 Microsoft Entra 凭据链。
authMode=ConfigFile configFilePath 现有受保护评估配置文件的绝对路径。
authMode=KeyVault sqlUserName、keyVaultName 和 secretName 授权读取 SQL 密码机密的现有Azure会话。
authMode=CredentialManager credentialTarget 所需项包括凭据模块以及包含 SQL 用户名和密码的现有条目。

显式身份验证选择器优先于发现的应用程序凭据。 缺少或冲突的选择器会停止工作流,而不是以无提示方式选择另一种模式。

Important

不要将密码、令牌或连接字符串放入 --prompt、命令参数或源代码控制的评估配置中。 使用现有的受保护凭据源。 仅使用 Windows 集成的 SQL 身份验证时,不需要 Azure 登录。

根据现有性能数据请求容量评估

若要请求 SKU 建议以及就绪情况,请添加 skuRecommendation=true 和来自同一实例的已完成性能数据的绝对 performanceDataPath 值:

modernize assess `
  --source C:\src\sql-app `
  --assess-config C:\configs\database-assessment.yml `
  --output-path C:\reports\sql-app `
  --format markdown `
  --delegate local `
  --no-tty `
  --prompt 'Assess local SQL Server migration readiness. instanceName=localhost; authMode=Windows; skuRecommendation=true; performanceDataPath=C:\sql-performance.'

支持大小调整工作流使用现有的特定于实例的性能 CSV。 它不连接到SQL Server或收集新的度量值。 不支持启动收集或指定收集持续时间的请求。

如果需要就绪情况以及已发布报表中请求的完整 SKU 建议,请使用 Markdown 。 HTML 发布内容会保留原生就绪性 HTML,不包括单独生成的 SKU 结果。 支持 SKU 工件保留在调用目录中,而不是复制到已发布的报表中。

查看结果

打开生成的应用程序评估报告,然后单击其中的数据库评估链接。 已发布的 SQL 报表位于当前存储库报表的 externals\evaluate-offline-sql-migration-readiness 目录下,其中包含 index.md 或 index.html 匹配请求的格式。

查看 Azure SQL 数据库 Hyperscale 的兼容性结果。 如果你正在考虑将 Azure SQL 托管实例 或 Azure 虚拟机中的 SQL Server 作为替代方案,请先查看与相应目标类型相关的评估结果,然后再选择迁移方法。 就绪性评估结果并不意味着迁移或生产验证已完成。

工作流可以在当前调用的输出目录中重复使用匹配结果并显示其生成时间。 如果需要新的评估,请在上下文中显式请求新的评估或刷新。 不可读或含义不明确的结果不应被视为允许覆盖这些结果的依据。

对于多个发现的实例,发布的报表仅在每个目标完成后才包含结果。 如果请求的定容失败,即使就绪性工件存在,合并的准备和定容请求也不会发布为已完成。

疑难解答评估

Diagnostic Action
UNSUPPORTED_HOST 在可以访问SQL Server的Windows计算机上本地运行。
PREREQUISITE_REQUIRED 在评估之外准备缺少的工具、扩展、包或所需的执行上下文,然后重新运行。
MISSING_PARAMETERS 当发现无法解析目标时,请提供具体的 instanceName;或者完成显式选择的身份验证输入。
UNSUPPORTED_SCOPE 使用本地或本地部署的 SQL Server 源。 此工作流不会评估现有Azure SQL终结点,也不会从 Arc 资源名称推断本地连接。
COLLECTION_NOT_SUPPORTED 删除新数据收集请求。 对于容量规划,请提供来自同一实例的完整性能数据。

对于连接或身份验证失败,请在评估之外验证可达性以及所选身份。 不要通过在提示中放置凭据来规避这些故障。