Utvärdera SQL Server migreringsberedskap med Modernize CLI (förhandsversion)

Använd Modernize CLI för att bedöma lokala eller lokalt installerade SQL Server-beroenden som en del av en heltäckande moderniseringsresa för program och databaser. Utvärderingen utvärderar migreringsberedskap för Azure SQL Database Hyperscale och identifierar kompatibilitetsproblem och den ansträngning som krävs för att modernisera arbetsbelastningen.

CLI kan identifiera SQL Server slutpunkter från programkonfigurationen eller utvärdera en instans som du anger. Du kan också begära storleksrekommendationer från befintliga prestandadata.

Azure SQL Managed Instance och SQL Server på Azure Virtual Machines förblir alternativa migreringsvägar när du väljer dessa mål baserat på dina arbetsbelastningskrav.

Important

SQL Server utvärdering i Modernize CLI finns i offentlig förhandsversion. Det här arbetsflödet utvärderar beredskapen. Det migrerar inte databaser, etablerar Azure resurser eller samlar in nya prestandadata. Kör den lokalt på Windows, inte via molnagentdelegering.

Prerequisites

  • Modernisera CLI och dess GitHub autentiseringskrav.
  • En lokal programutcheckning med SQL Server beroenden.
  • En Windows dator som kan nå källan SQL Server.
  • PowerShell 7.
  • Azure CLI version 2.75.0 eller senare, med datamigration tillägget redan installerat. Se även Installera Azure CLI.
  • En befintlig identitets- eller skyddad anslutningskonfiguration med behörighet att utvärdera källans SQL Server.

Den SQL Server utvärderingsfärdigheten laddar ned SQL-utvärderingspaketet. Du behöver inte ladda ned det separat.

Förbered de andra nödvändiga verktygen, tilläggen, autentiseringsuppgifterna och nätverksåtkomsten innan du börjar. Utvärderingen loggar inte in dig. Linux och macOS stöds inte för det här SQL Server arbetsflödet, även om Modernize CLI stöder dessa plattformar för andra scenarier.

Utvärdera programs SQL Server-beroenden

Databasutvärdering körs som ytterligare en utvärderingsfunktion med fullständig analys. Standardinställningen Problem endast körs den inte.

Interaktivt läge (TUI)

  1. Kör moderniseringsagenten från applikationskatalogen:

    modernize
    
  2. Välj Utvärdera på huvudmenyn.

  3. Välj Aktuell mapp för att utvärdera ditt program eller Manuell inmatning för att ange en lokal programsökväg.

  4. Välj de utvärderingsdomäner som är relevanta för ditt program och fortsätt till utvärderingskonfigurationen.

  5. Under Allmän/Analystäckning väljer du Fullständig analys och sedan Fortsätt.

  6. Välj Utvärdera lokalt. SQL Server utvärdering kräver en Windows dator med åtkomst till käll-SQL Server.

  7. Ange en utdatasökväg eller acceptera standardinställningen och starta utvärderingen.

CLI använder lagringsplatsbevis för att välja tillämpliga databasutvärderingsfunktioner. Mer information om de interaktiva skärmarna finns i Batch-utvärdering: Interaktivt läge.

headless-läge

Skapa en utvärderingskonfigurationsfil, till exempel C:\configs\database-assessment.yml, med följande inställning:

analysisCoverage: full

Sammanfoga den här inställningen med en befintlig konfiguration i stället för att ersätta andra utvärderingsinställningar. Skicka filen till --assess-config enligt följande kommando och ersätt käll-, konfigurations- och utdatasökvägarna med dina egna:

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

Du kan också uppdatera en befintlig assessment-config.yaml-fil på användarnivå på %USERPROFILE%\.modernize\assessment-config.yaml genom att ange analysisCoverage: full. Om du använder den filen utelämnar du --assess-config från kommandot. En explicit --assess-config sökväg har företräde framför filen på användarnivå.

Note

Den valfria --prompt tillhandahåller kontext till ytterligare färdigheter för databasbedömning. Det ändrar inte Modernize CLI:s inbyggda AI-analys. CLI väljer tillämpliga kunskaper utifrån belägg från repot och den här valfria kontexten. Ett SQL Server-omnämnande enbart i en README räcker inte ensamt för att fastställa tillämplighet.

SQL Server målidentifiering

När du inte anger någon instans löser SQL-utvärderingen konkreta slutpunkter från programinställningar som stöds, inklusive anslutningsinställningar och refererade miljövariabler. Den kör inte programkod för att lösa dynamiska inställningar. Den utvärderar varje distinkt upplöst slutpunkt i stället för bara den första.

Tillgängliga programautentiseringsuppgifter identifieras i den lokala körningsprocessen. Om inga autentiseringsuppgifter som stöds är tillgängliga använder arbetsflödet den aktuella Windows identiteten. En misslyckad angiven autentiseringsuppgift utlöser inte ett nytt försök med en annan autentiseringsmetod.

Om upptäckten inte kan fastställa en slutpunkt, anger du en instans explicit.

Ange en SQL Server instans

Använd icke-hemliga selektorer i utvärderingskontexten:

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

Ersätt localhost med SQL Server-datakällan för källan, inklusive dess instansnamn eller port om det behövs. Ett explicit instanceName begränsar målet för utvärderingen; det är inte ett reťazec pripojenia eller ett Azure Arc-resurs-ID.

instanceName, authMode, och de andra väljarna i den här artikeln är utvärderingskontext, inte nya CLI-flaggor. Använd inte flaggor som --instanceName.

Välj en befintlig autentiseringskälla

För en uttryckligen vald instans utelämnar authMode och configFilePath använder den aktuella Windows identiteten när en ny utvärdering behövs. Du kan i stället ange något av följande autentiseringsval i kontexten:

Autentiseringsval Ytterligare icke-hemlig kontext Förutsättning
authMode=Windows None Den aktuella Windows identiteten har SQL Server åtkomst.
authMode=EntraDefault None En fungerande icke-interaktiv Microsoft Entra autentiseringskedja som stöds av det installerade utvärderingsverktyget.
authMode=ConfigFile configFilePath En absolut sökväg till en befintlig konfigurationsfil för skyddad utvärdering.
authMode=KeyVault sqlUserName, keyVaultName, och secretName En befintlig Azure session som har behörighet att läsa SQL-lösenordshemligheten.
authMode=CredentialManager credentialTarget Den nödvändiga autentiseringsmodulen och en befintlig post som innehåller SQL-användarnamnet och lösenordet.

Explicita autentiseringsväljare har företräde framför identifierade autentiseringsuppgifter för programmet. Väljare som saknas eller är i konflikt stoppar arbetsflödet i stället för att tyst välja ett annat läge.

Important

Placera inte lösenord, token eller anslutningssträngar i --promptkommandoargument eller källkontrollerad utvärderingskonfiguration. Använd en befintlig skyddad källa för autentiseringsuppgifter. Azure-inloggning krävs inte för att använda Windows-integrerad SQL-autentisering.

Begära dimensionering från befintliga prestandadata

Om du vill begära SKU-rekommendationer tillsammans med beredskap lägger du till skuRecommendation=true och en absolut performanceDataPath-sökväg för slutförda prestandadata från samma instans:

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

Det stödande storleksarbetsflödet använder befintliga instansspecifika prestanda-CSV:er. Den ansluter inte till SQL Server eller samlar in nya mätvärden. Begäranden om att starta insamlingen eller ange en varaktighet för insamlingen stöds inte.

Använd Markdown när du behöver beredskapsstatus och de fullständiga begärda SKU-rekommendationerna i den publicerade rapporten. HTML-publikationen bevarar det ursprungliga readiness-HTML-innehållet och innehåller inte separat genererade SKU-resultat. SKU-stödartefakter finns kvar i anropskatalogen i stället för att kopieras till den publicerade rapporten.

Granska resultat

Öppna den genererade programutvärderingsrapporten och följ dess databasutvärderingslänk. Den publicerade SQL-rapporten finns under den aktuella lagerrapportens externals\evaluate-offline-sql-migration-readiness-katalog, där index.md eller index.html motsvarar det begärda formatet.

Granska kompatibilitetsresultat för Azure SQL Database Hyperscale. Om du överväger Azure SQL Managed Instance eller SQL Server på Azure Virtual Machines som ett alternativ kan du granska relevanta målspecifika resultat innan du väljer en migreringsmetod. Readiness-resultat är inte ett bevis på att migreringen eller produktionsverifieringen är klar.

Arbetsflödet kan återanvända matchande resultat i den aktuella anropets utdatakatalog och visa deras generationstid. Om du behöver en ny utvärdering begär du uttryckligen en ny utvärdering eller uppdatera i kontexten. Oläsliga eller tvetydiga resultat behandlas inte som behörighet att skriva över dem.

När flera instanser identifieras innehåller den publicerade rapporten resultat först efter att alla mål har slutförts. Om den begärda storleksbestämningen misslyckas publiceras inte den kombinerade begäran om beredskap och storleksändring som slutförd, även när beredskapsartefakter finns.

Felsöka utvärdering

Diagnostic Action
UNSUPPORTED_HOST Kör lokalt på en Windows dator som kan nå SQL Server.
PREREQUISITE_REQUIRED Förbered det saknade verktyget, tillägget, paketet eller den nödvändiga körningskontexten utanför utvärderingen och kör sedan igen.
MISSING_PARAMETERS Ange en konkret instanceName när identifiering inte kan fastställa ett mål, eller fyll i de uttryckligen valda autentiseringsindata.
UNSUPPORTED_SCOPE Använd en lokal eller lokalt installerad SQL Server-källa. Det här arbetsflödet utvärderar inte befintliga Azure SQL slutpunkter eller härleder lokala anslutningar från Arc-resursnamn.
COLLECTION_NOT_SUPPORTED Ta bort begäranden om ny datainsamling. För dimensionering anger du slutförda prestandadata från samma instans.

För anslutnings- eller autentiseringsfel kontrollerar du nåbarheten och den valda identiteten utanför bedömningsverktyget. Försök inte kringgå fel genom att placera autentiseringsuppgifter i prompten.