使用 Modernize CLI(預覽版)評估 SQL Server 遷移準備度

使用 Modernize CLI 評估本地或本地 SQL Server 相依性,作為端到端應用程式與資料庫現代化旅程的一部分。 該評估評估 Azure SQL Database Hyperscale 的遷移準備度,並指出相容性問題及現代化工作負載所需的努力。

CLI 可以從應用程式設定中發現 SQL Server 端點,或評估您指定的實例。 您也可以從現有效能資料中請求容量規劃建議。

當您根據工作負載需求選擇 Azure SQL 受控執行個體 與 Azure 虛擬機器上的 SQL Server 時,這些路徑仍是替代移轉路徑。

Important

Modernize CLI 中的 SQL Server 評估目前處於公開預覽階段。 此工作流程評估準備狀況;它不會遷移資料庫、配置 Azure 資源,也不會收集新的效能資料。 請在 Windows 本地執行,不要透過雲端代理委派。

Prerequisites

  • Modernize CLI 及其 GitHub 驗證的先決條件。
  • 具有 SQL Server 相依性的本機應用程式工作複本。
  • 一台能存取來源 SQL Server 的 Windows 電腦。
  • PowerShell 7
  • Azure CLI 2.75.0 或更新版本,且已安裝 datamigration 擴充功能。 請參見 安裝 Azure CLI。
  • 現有的身分識別或受保護連線設定,並具備評估來源 SQL Server 的權限。

SQL Server 評估技能會下載 SQL 評估套件;您不需要另外下載。

在開始之前,請先準備好其他所需的工具、擴充功能、憑證及網路存取。 評估不會讓你登入。 Linux 和 macOS 不支援此 SQL Server 工作流程,儘管 Modernize CLI 在其他情境下支援這些平台。

評估應用程式 SQL Server 相依性

資料庫評估會在使用 完整分析 時,作為額外的評估項目執行。 預設 的「僅問題」 設定不會執行它。

互動模式(TUI)

  1. 從您的應用程式目錄執行現代化代理程式:

    modernize
    
  2. 從主選單選擇 評估 。

  3. 選擇「目前資料夾」以評估您的應用程式,或選擇「手動輸入」以輸入本機應用程式的路徑。

  4. 選擇與您的應用程式相關的評估領域,然後繼續前往評估設定。

  5. 在 「一般/分析覆蓋範圍」 下,選擇 「完整分析」,然後選擇 「繼續」。

  6. 選擇 「本地評估」。 SQL Server 評估需要一台具備原始 SQL Server 存取權限的 Windows 電腦。

  7. 輸入輸出路徑或接受預設值,然後開始評估。

CLI 會使用儲存庫證據來選擇適用的資料庫評估技能。 如需有關互動式畫面的更多資訊,請參閱 「批次評估:互動模式」。

無頭模式

建立一個評估設定檔,例如 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 會從儲存庫證據及此選用上下文中選擇適用技能;單僅在 README 中提及 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.'

請以來源 SQL Server 資料來源替換localhost,如有需要,並包含其命名的實例或連接埠。 明確指定的 instanceName 會限制評估目標;它不是 連接字串,也不是 Azure Arc 資源 ID。

instanceName、 authMode,以及本文中的其他選擇器是評估上下文,而非新的 CLI 標記。 不要使用像 --instanceName. 這樣的旗標。

選擇現有的驗證來源

對於明確選取的實例,省略兩者authModeconfigFilePath,當需要新的評估時,會使用目前的 Windows 身份。 您也可以在以下情境中提供以下驗證選項之一:

驗證方式 額外非機密內容 先決行件
authMode=Windows 無 目前的 Windows 身分具有 SQL Server 存取權限。
authMode=EntraDefault 無 由已安裝的評估工具支援的可運作的非互動式 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.mdindex.html與您要求的格式相符。

檢視 Azure SQL Database 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 移除新的資料收集請求。 在進行容量估算時,請提供同一實例的已完成效能資料。

若連線或驗證失敗,請在評估之外驗證可達性及所選身份。 不要在提示字元中放置憑證來規避失敗。