Bewerten SQL Server Migrationsbereitschaft mit der Modernize CLI (Vorschau)

Verwenden Sie die Modernize CLI, um lokale oder lokale SQL Server Abhängigkeiten als Teil einer End-to-End-Anwendungs- und Datenbankmodernisierungsreise zu bewerten. Die Bewertung bewertet die Migrationsbereitschaft für Azure SQL-Datenbank Hyperscale und identifiziert Kompatibilitätsprobleme und den Aufwand für die Modernisierung der Workload.

Die CLI kann SQL Server Endpunkte aus der Anwendungskonfiguration ermitteln oder eine von Ihnen angegebene Instanz bewerten. Sie können auch Empfehlungen zur Größenanpassung aus vorhandenen Leistungsdaten anfordern.

Azure SQL Managed Instance und SQL Server auf virtuellen Azure-Computern bleiben alternative Migrationspfade, wenn Sie diese Ziele basierend auf Ihren Workloadanforderungen auswählen.

Important

SQL Server Bewertung in der Modernize CLI befindet sich in der öffentlichen Vorschau. Dieser Workflow bewertet die Bereitschaft; Datenbanken werden nicht migriert, Azure Ressourcen bereitgestellt oder neue Leistungsdaten gesammelt. Führen Sie sie lokal auf Windows aus, nicht über die Cloud-Agent-Delegierung.

Prerequisites

  • Die Modernize CLI und ihre GitHub-Authentifizierungsvoraussetzungen.
  • Ein auschecken einer lokalen Anwendung mit SQL Server Abhängigkeiten.
  • Ein Windows Computer, der die Quell-SQL Server erreichen kann.
  • PowerShell 7.
  • Azure CLI Version 2.75.0 oder höher, wobei die datamigration Erweiterung bereits installiert ist. Weitere Informationen finden Sie unter Installieren des Azure CLI.
  • Eine vorhandene Identitäts- oder geschützte Verbindungskonfiguration mit der Berechtigung zur Bewertung des Quell-SQL Server.

Die SQL Server Bewertungsfunktion lädt das SQL-Bewertungspaket herunter. Sie müssen es nicht separat herunterladen.

Bereiten Sie die anderen erforderlichen Tools, Erweiterungen, Anmeldeinformationen und Den Netzwerkzugriff vor dem Start vor. Die Bewertung meldet Sie nicht an. Linux und macOS werden für diesen SQL Server-Workflow nicht unterstützt, obwohl die Modernize CLI diese Plattformen für andere Szenarien unterstützt.

SQL Server-Abhängigkeiten der Anwendung bewerten

Die Datenbankbewertung wird als zusätzliche Bewertungskompetenz mit Full analysis ausgeführt. Die Standardeinstellung Issue only führt es nicht aus.

Interaktiver Modus (TUI)

  1. Führen Sie im Anwendungsverzeichnis den Modernisierungs-Agent aus:

    modernize
    
  2. Wählen Sie im Hauptmenü "Bewerten" aus.

  3. Wählen Sie "Aktueller Ordner" aus, um Ihre Anwendung zu bewerten, oder "Manuelle Eingabe" aus, um einen lokalen Anwendungspfad einzugeben.

  4. Wählen Sie die für Ihre Anwendung relevanten Bewertungsdomänen aus, und fahren Sie mit der Bewertungskonfiguration fort.

  5. Wählen Sie unter "Allgemein/Analyseabdeckung" die Option "Vollständige Analyse" und dann " Weiter" aus.

  6. Wählen Sie "Lokal bewerten" aus. SQL Server Bewertung erfordert einen Windows Computer mit Zugriff auf die Quell-SQL Server.

  7. Geben Sie einen Ausgabepfad ein, oder akzeptieren Sie die Standardeinstellung, und starten Sie die Bewertung.

Die CLI verwendet Repository-Nachweise, um anwendbare Datenbankbewertungsfunktionen auszuwählen. Weitere Informationen zu den interaktiven Bildschirmen finden Sie unter Batchbewertung: Interaktiver Modus.

Headless-Modus

Erstellen Sie eine Bewertungskonfigurationsdatei, z. B. C:\configs\database-assessment.yml, mit der folgenden Einstellung:

analysisCoverage: full

Führen Sie diese Einstellung mit einer vorhandenen Konfiguration zusammen, anstatt andere Bewertungseinstellungen zu ersetzen. Übergeben Sie die Datei wie --assess-config im folgenden Befehl dargestellt, und ersetzen Sie die Quell-, Konfigurations- und Ausgabepfade durch Ihre eigenen:

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.'

Alternativ können Sie eine vorhandene assessment-config.yaml-Datei auf Benutzerebene unter %USERPROFILE%\.modernize\assessment-config.yaml aktualisieren, indem Sie analysisCoverage: full festlegen. Wenn Sie diese Datei verwenden, lassen Sie --assess-config im Befehl weg. Ein expliziter --assess-config Pfad hat Vorrang vor der Datei auf Benutzerebene.

Note

Das optionale --prompt stellt Kontext für zusätzliche Datenbankbewertungskompetenzen bereit. Die integrierte KI-Analyse von Modernize CLI ändert sich nicht. Die CLI wählt die anwendbaren Fähigkeiten auf Grundlage von Repository-Nachweisen und diesem optionalen Kontext aus; die bloße Erwähnung von SQL Server in einer README allein begründet keine Anwendbarkeit.

Zielerkennung für SQL Server

Wenn Sie keine Instanz bereitstellen, ermittelt die SQL-Bewertung konkrete Endpunkte aus unterstützten Anwendungseinstellungen, einschließlich Verbindungseinstellungen und referenzierter Umgebungsvariablen. Der Anwendungscode wird nicht ausgeführt, um dynamische Einstellungen aufzulösen. Er bewertet jeden eindeutigen aufgelösten Endpunkt und nicht nur den ersten Endpunkt.

Verfügbare Anwendungsanmeldeinformationen werden innerhalb des lokalen Ausführungsprozesses aufgelöst. Wenn keine unterstützten Anmeldeinformationen verfügbar sind, verwendet der Workflow die aktuelle Windows Identität. Fehlerhafte angegebene Anmeldeinformationen lösen keinen Wiederholungsversuch mit einer anderen Authentifizierungsmethode aus.

Wenn die Ermittlung einen Endpunkt nicht auflösen kann, geben Sie eine Instanz explizit an.

Angeben einer SQL Server Instanz

Verwenden Sie nicht geheime Selektoren im Bewertungskontext:

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.'

Ersetzen Sie localhost bei Bedarf durch die Quelle SQL Server Datenquelle, einschließlich der benannten Instanz oder des Portes. Ein explizites instanceName Einschränken des Bewertungsziels; es handelt sich nicht um eine Verbindungszeichenfolge oder eine Azure Arc Ressourcen-ID.

instanceName, authModeund die anderen Selektoren in diesem Artikel sind Bewertungskontext, nicht neue CLI-Flags. Verwenden Sie keine Flags wie --instanceNamez. B. .

Auswählen einer vorhandenen Authentifizierungsquelle

Für eine explizit ausgewählte Instanz wird die authMode aktuelle Windows Identität weggelassen und configFilePath verwendet, wenn eine neue Bewertung erforderlich ist. Sie können stattdessen eine dieser Authentifizierungsauswahlen im Kontext bereitstellen:

Authentifizierungsauswahl Zusätzlicher nicht geheimer Kontext Voraussetzung
authMode=Windows None Aktuelle Windows Identität hat SQL Server Zugriff.
authMode=EntraDefault None Eine funktionierende, nicht interaktive Microsoft Entra Anmeldeinformationskette, die vom installierten Bewertungstool unterstützt wird.
authMode=ConfigFile configFilePath Ein absoluter Pfad zu einer vorhandenen Konfigurationsdatei für geschützte Bewertungen.
authMode=KeyVault sqlUserName, keyVaultName und secretName Eine vorhandene Azure Sitzung, die zum Lesen des SQL-Kennwortschlüssels autorisiert ist.
authMode=CredentialManager credentialTarget Das erforderliche Anmeldeinformationsmodul und ein vorhandener Eintrag, der den SQL-Benutzernamen und das Kennwort enthält.

Explizite Authentifizierungsselektoren haben Vorrang vor ermittelten Anwendungsanmeldeinformationen. Fehlende oder widersprüchliche Selektoren beenden den Workflow, anstatt stillschweigend einen anderen Modus auszuwählen.

Important

Fügen Sie keine Kennwörter, Token oder Verbindungszeichenfolgen in --prompt, Befehlsargumente oder quellgesteuerte Bewertungskonfiguration ein. Verwenden Sie eine vorhandene geschützte Anmeldeinformationsquelle. Azure Anmeldung ist nicht erforderlich, um Windows-integrierte SQL-Authentifizierung zu verwenden.

Anfordern der Dimensionierung aus vorhandenen Leistungsdaten

Um SKU-Empfehlungen zusammen mit der Einsatzbereitschaft anzufordern, fügen Sie performanceDataPath und einen absoluten skuRecommendation=true für abgeschlossene Leistungsdaten aus derselben Instanz hinzu:

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.'

Der unterstützende Größenworkflow verwendet vorhandene instanzspezifische Leistungs-CSVs. Es stellt keine Verbindung mit SQL Server her oder sammelt keine neuen Messungen. Anforderungen zum Starten der Auflistung oder Angeben einer Sammlungsdauer werden nicht unterstützt.

Verwenden Sie Markdown , wenn Sie Bereitschaft und die vollständigen angeforderten SKU-Empfehlungen im veröffentlichten Bericht benötigen. Die HTML-Publikation behält das native Readiness-HTML bei und enthält keine separat generierten SKU-Ergebnisse. Unterstützende SKU-Artefakte verbleiben im Aufrufverzeichnis, anstatt in den veröffentlichten Bericht kopiert zu werden.

Ergebnisse überprüfen

Öffnen Sie den generierten Anwendungsbewertungsbericht, und folgen Sie dessen Datenbankbewertungslink. Der veröffentlichte SQL-Bericht befindet sich unter dem Verzeichnis externals\evaluate-offline-sql-migration-readiness des aktuellen Repositoryberichts, wobei index.md oder index.html dem angeforderten Format entsprechen.

Überprüfen Sie Kompatibilitätsergebnisse für Azure SQL-Datenbank Hyperscale. Wenn Sie Azure SQL Managed Instance oder SQL Server auf virtuellen Azure-Computern als Alternative in Betracht ziehen, überprüfen Sie die relevanten zielspezifischen Ergebnisse, bevor Sie einen Migrationsansatz auswählen. Bereitschaftsergebnisse stellen keinen Nachweis dafür bereit, dass die Migrations- oder Produktionsüberprüfung abgeschlossen ist.

Der Workflow kann übereinstimmende Ergebnisse im Ausgabeverzeichnis des aktuellen Aufrufs wiederverwenden und die Generierungszeit anzeigen. Wenn Sie eine neue Bewertung benötigen, fordern Sie explizit eine neue Bewertung an oder aktualisieren Sie im Kontext. Nicht lesbare oder mehrdeutige Ergebnisse werden nicht als Berechtigung zum Überschreiben behandelt.

Bei mehreren ermittelten Instanzen enthält der veröffentlichte Bericht ergebnisse erst nach Abschluss jedes Ziels. Wenn das angeforderte Sizing fehlschlägt, wird die kombinierte Bereitschafts- und Sizinganforderung nicht als abgeschlossen veröffentlicht, auch wenn Bereitschaftsartefakte vorhanden sind.

Fehlersuche und Analyse

Diagnostic Action
UNSUPPORTED_HOST Lokal auf einem Windows Computer ausführen, der SQL Server erreichen kann.
PREREQUISITE_REQUIRED Bereiten Sie das fehlende Tool, die Erweiterung, das Paket oder den erforderlichen Ausführungskontext außerhalb der Bewertung vor, und führen Sie dann erneut aus.
MISSING_PARAMETERS Geben Sie einen konkreten instanceName an, wenn die Ermittlung kein Ziel auflösen kann, oder vervollständigen Sie die explizit ausgewählten Authentifizierungseingaben.
UNSUPPORTED_SCOPE Verwenden Sie eine lokale oder On-Premises-SQL Server-Quelle. Dieser Workflow bewertet keine vorhandenen Azure SQL Endpunkte oder leitet lokale Verbindungen von Arc-Ressourcennamen ab.
COLLECTION_NOT_SUPPORTED Entfernen Sie neue Datensammlungsanforderungen. Geben Sie für die Größenanpassung abgeschlossene Leistungsdaten aus derselben Instanz an.

Überprüfen Sie bei Verbindungs- oder Authentifizierungsfehlern die Erreichbarkeit und die ausgewählte Identität außerhalb der Überprüfung. Umgehen Sie Fehler nicht, indem Sie Anmeldeinformationen im Prompt platzieren.