使用 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)
從您的應用程式目錄執行現代化代理程式:
modernize從主選單選擇 評估 。
選擇「目前資料夾」以評估您的應用程式,或選擇「手動輸入」以輸入本機應用程式的路徑。
選擇與您的應用程式相關的評估領域,然後繼續前往評估設定。
在 「一般/分析覆蓋範圍」 下,選擇 「完整分析」,然後選擇 「繼續」。
選擇 「本地評估」。 SQL Server 評估需要一台具備原始 SQL Server 存取權限的 Windows 電腦。
輸入輸出路徑或接受預設值,然後開始評估。
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 |
移除新的資料收集請求。 在進行容量估算時,請提供同一實例的已完成效能資料。 |
若連線或驗證失敗,請在評估之外驗證可達性及所選身份。 不要在提示字元中放置憑證來規避失敗。