Kör Data Migration Assistant från kommandoraden
Viktig
Data Migration Assistant (DMA) är inaktuell. Information om migreringsalternativ från SQL Server till Azure SQL finns i migreringsalternativ för SQL Server till Azure SQL.
När du installerar Data Migration Assistant med version 2.1 och senare installeras även dmacmd.exe i %ProgramFiles%\Microsoft Data Migration Assistant. Använd DMACMD- för att utvärdera dina databaser i ett obevakat läge och mata ut resultatet till JSON- eller CSV-filen. Den här metoden är särskilt användbar när du utvärderar flera databaser eller stora databaser.
DMACMD stöder endast att köra utvärderingar. Migreringar stöds inte just nu.
Utvärderingar med hjälp av kommandoradsgränssnittet (CLI)
dmacmd.exe /AssessmentName="string"
/AssessmentDatabases="connectionString1" ["connectionString2"]
[/AssessmentSourcePlatform="SourcePlatform"]
[/AssessmentTargetPlatform="TargetPlatform"]
/AssessmentEvaluateFeatureParity|/AssessmentEvaluateCompatibilityIssues
[/AssessmentOverwriteResult]
/AssessmentResultJson="file"|/AssessmentResultCsv="file"
| Argument | Beskrivning | Obligatoriskt (Y/N) |
|---|---|---|
/help or /? |
Så här använder du dmacmd.exe:s hjälptext | N |
/AssessmentName |
Namnet på utvärderingsprojektet | Y |
/AssessmentDatabases |
Utrymmesavgränsad lista över anslutningssträngar. Databasnamnet (Initial Catalog) är skiftlägeskänsligt. | Y |
/AssessmentSourcePlatform |
Källplattform för utvärderingen: Värden som stöds för Utvärdering: SqlOnPrem, RdsSqlServer (standard)Värden som stöds för utvärdering av målberedskap: SqlOnPrem, RdsSqlServer (standard), Cassandra (förhandsversion) |
N |
/AssessmentTargetPlatform |
Målplattform för utvärderingen: Värden som stöds för Utvärdering: AzureSqlDatabase, ManagedSqlServer, SqlServer2012, SqlServer2014, SqlServer2016, SqlServerLinux2017och SqlServerWindows2017 (standard)Värden som stöds för utvärdering av målberedskap: ManagedSqlServer (standard), CosmosDB (förhandsversion) |
N |
/AssessmentEvaluateFeatureParity |
Kör funktionsparitetsregler. Om källplattformen är RdsSqlServer stöds inte utvärdering av funktionsparitet för målplattformen AzureSqlDatabase | Y (Antingen AssessmentEvaluateCompatibilityIssues eller AssessmentEvaluateFeatureParity krävs.) |
/AssessmentEvaluateCompatibilityIssues |
Kör kompatibilitetsregler | Y (Antingen krävs AssessmentEvaluateCompatibilityIssues eller AssessmentEvaluateFeatureParity.) |
/AssessmentOverwriteResult |
Skriv över resultatfilen | N |
/AssessmentResultJson |
Fullständig sökväg till JSON-resultatfilen | Y (Antingen AssessmentResultJson eller AssessmentResultCsv krävs) |
/AssessmentResultCsv |
Fullständig sökväg till CSV-resultatfilen | Y (Antingen AssessmentResultJson eller AssessmentResultCsv krävs) |
/AssessmentResultDma |
Fullständig sökväg till .dma resultatfilen |
N |
/Action |
Använd SkuRecommendation för att få SKU-rekommendationer.Använd AssessTargetReadiness för att utföra utvärdering av målberedskap.Använd AzureMigrateUpload för att ladda upp alla DMA-utvärderingsfiler i AssessmentResultInputFolder för massuppladdning till Azure Migrate.
Action typanvändning /Action=AzureMigrateUpload |
N |
/SourceConnections |
Utrymmesavgränsad lista över anslutningssträngar. Databasnamn (inledande katalog) är valfritt. Om inget databasnamn anges utvärderas alla databaser på källan. | Y (Krävs om Action är AssessTargetReadiness) |
/TargetReadinessConfiguration |
Fullständig sökväg till XML-filen som beskriver värden för namn, källanslutningar och resultatfil. | Y (Antingen TargetReadinessConfiguration eller SourceConnections krävs) |
/FeatureDiscoveryReportJson |
Sökväg till JSON-rapporten för funktionsidentifiering. Om den här filen genereras kan den användas för att köra målberedskapsutvärderingen igen utan att ansluta till källan. | N |
/ImportFeatureDiscoveryReportJson |
Sökväg till JSON-rapporten för funktionsidentifiering som skapades tidigare. I stället för källanslutningar används den här filen. | N |
/EnableAssessmentUploadToAzureMigrate |
Aktiverar överföring och publicering av utvärderingsresultat till Azure Migrate | N |
/AzureCloudEnvironment |
Väljer den Azure-molnmiljö som du vill ansluta till, standardvärdet är Azure Public Cloud. Värden som stöds: Azure (standard), AzureChina, AzureGermany, AzureUSGovernment. |
N |
/SubscriptionId |
Azure-prenumerations-ID. | Y (Krävs om EnableAssessmentUploadToAzureMigrate argument anges) |
/AzureMigrateProjectName |
Namnet på Azure Migrate-projektet som utvärderingsresultat ska laddas upp till. | Y (Krävs om EnableAssessmentUploadToAzureMigrate argument anges) |
/ResourceGroupName |
Namn på Azure Migrate-resursgrupp. | Y (Krävs om EnableAssessmentUploadToAzureMigrate argument anges) |
/AssessmentResultInputFolder |
Sökvägen till källmappen som innehåller .dma bedömningsfiler som ska laddas upp till Azure Migrate. |
Y (Krävs om Action är AzureMigrateUpload) |
Exempel på utvärderingar som använder CLI
DMACMD
dmacmd.exe /?
Eller:
dmacmd.exe /help`
utvärdering av en databas med Windows-autentisering och körning av kompatibilitetsregler
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentEvaluateCompatibilityIssues /AssessmentOverwriteResult
/AssessmentResultJson="C:\\temp\\Results\\AssessmentReport.json"
Enkeldatabasutvärdering med SQL Server-autentisering och körning av funktionsparitet
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;User Id=myUsername;Password=myPassword;"
/AssessmentEvaluateFeatureParity /AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"
Enkel databasbedömning för målplattformen SQL Server 2012, spara resultaten i fil .json och .csv
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentTargetPlatform="SqlServer2012"
/AssessmentEvaluateFeatureParity /AssessmentOverwriteResult
/AssessmentResultJson="C:\\temp\\Results\\AssessmentReport.json"
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"
Utvärdering för enskild databas för målplattformen Azure SQL Database, spara resultaten till .json och .csv-filerna
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentTargetPlatform="AzureSqlDatabaseV12"
/AssessmentEvaluateCompatibilityIssues /AssessmentEvaluateFeatureParity
/AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\AssessmentReport.csv"
/AssessmentResultJson="C:\\temp\\AssessmentReport.json"
utvärdering av flera databaser
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName1;Initial
Catalog=DatabaseName1;Integrated Security=true"
"Server=SQLServerInstanceName1;Initial Catalog=DatabaseName2;Integrated
Security=true" "Server=SQLServerInstanceName2;Initial
Catalog=DatabaseName3;Integrated Security=true"
/AssessmentTargetPlatform="SqlServer2016"
/AssessmentEvaluateCompatibilityIssues /AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"
/AssessmentResultJson="C:\\Results\\test2016.json"
Bedömning av målberedskap för enkel databas med Windows-autentisering
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Initial Catalog=DatabaseName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Bedömning av målberedskap i en enkel databas via SQL Server-autentisering
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Initial Catalog=DatabaseName;User Id=myUsername;Password=myPassword;" /AssessmentEvaluateFeatureParity
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Enkeldatabas-utvärdering för målplattformen Azure SQL Database, spara resultat till .json- och .csv-fil
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentSourcePlatform="SqlOnPrem"
/AssessmentTargetPlatform="AzureSqlDatabase"
/AssessmentEvaluateCompatibilityIssues /AssessmentEvaluateFeatureParity
/AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\AssessmentReport.csv"
/AssessmentResultJson="C:\\temp\\AssessmentReport.json"
utvärdering av målberedskap för flera databaser
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/AssessmentSourcePlatform=SourcePlatform
/AssessmentTargetPlatform=TargetPlatform
/SourceConnections="Server=SQLServerInstanceName1;Initial Catalog=DatabaseName1;Integrated Security=true" "Server=SQLServerInstanceName1;Initial Catalog=DatabaseName2;Integrated Security=true" "Server=SQLServerInstanceName2;Initial Catalog=DatabaseName3;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\Results\test2016.json"
(/AssessmentSourcePlatform och /AssessmentTargetPlatform är valfria.)
Utvärdering av målberedskap för alla databaser på en server med Windows-autentisering
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Målberedskapsbedömning genom att importera funktionsupptäcktsrapport som har skapats tidigare
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/ImportFeatureDiscoveryReportJson="c:\temp\feature_report.json"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Utvärdering av målberedskap genom att tillhandahålla konfigurationsfil
dmacmd.exe /Action=AssessTargetReadiness
/TargetReadinessConfiguration=.\Config.xml
Konfigurationsfilinnehåll vid användning av källanslutningar:
<?xml version="1.0" encoding="utf-8" ?>
<TargetReadinessConfiguration xmlns="http://microsoft.com/schemas/SqlServer/Advisor/TargetReadinessConfiguration">
<AssessmentName>name</AssessmentName>
<SourcePlatform>Source Platform</SourcePlatform> <!-- Optional. The default is SqlOnPrem -->
<TargetPlatform>TargetPlatform</TargetPlatform> <!-- Optional. The default is ManagedSqlServer -->
<SourceConnections>
<SourceConnection>connection string 1</SourceConnection>
<SourceConnection>connection string 2</SourceConnection>
<!-- ... -->
<SourceConnection>connection string n</SourceConnection>
</SourceConnections>
<AssessmentResultJson>path\to\file.json</AssessmentResultJson>
<FeatureDiscoveryReportJson>path\to\featurediscoveryreport.json</FeatureDiscoveryReportJson>
<OverwriteResult>true</OverwriteResult> <!-- or false -->
</TargetReadinessConfiguration>
Konfigurationsfilinnehåll vid import av rapport för funktionsidentifiering:
<TargetReadinessConfiguration xmlns="http://microsoft.com/schemas/SqlServer/Advisor/TargetReadinessConfiguration">
<AssessmentName>name</AssessmentName>
<ImportFeatureDiscoveryReportJson>path\to\featurediscoveryfile.json</ImportFeatureDiscoveryReportJson>
<AssessmentResultJson>path\to\resultfile.json</AssessmentResultJson>
<OverwriteResult>true</OverwriteResult><!-- or false -->
</TargetReadinessConfiguration>
Utvärdera och ladda upp till Azure Migrate i Azure Public Cloud (standard)
dmacmd.exe
/Action="Assess"
/AssessmentSourcePlatform=SqlOnPrem
/AssessmentTargetPlatform=ManagedSqlServer
/AssessmentEvaluateCompatibilityIssues
/AssessmentEvaluateFeatureParity
/AssessmentOverwriteResult
/AssessmentName="assess-myDatabase"
/AssessmentDatabases="Server=myServer;Initial Catalog=myDatabase;Integrated Security=true"
/AssessmentResultDma="C:\assessments\results\assess-1.dma"
/SubscriptionId="Subscription Id"
/AzureMigrateProjectName="Azure Migrate project ame"
/ResourceGroupName="Resource Group name"
/AzureAuthenticationInteractiveAuthentication
/AzureAuthenticationTenantId="Azure Tenant Id"
/EnableAssessmentUploadToAzureMigrate
Batchuppladdning av DMA-utvärderingsfiler till Azure Migrate på Azure Public Cloud (standard)
dmacmd.exe
/Action="AzureMigrateUpload"
/AssessmentResultInputFolder="C:\assessments\results"
/SubscriptionId="Subscription Id"
/AzureMigrateProjectName="Azure Migrate project name"
/ResourceGroupName="Resource Group name"
/AzureAuthenticationInteractiveAuthentication
/AzureAuthenticationTenantId="Azure Tenant Id"
/EnableAssessmentUploadToAzureMigrate
Azure SQL Database/Azure SQL Managed Instance/SQL Server på Azure VM SKU-rekommendationer med CLI
Med version 5.4 och senare, när du installerar Data Migration Assistant, installeras även SqlAssessment.exe i %ProgramFiles%\Microsoft Data Migration Assistant\SQLAssessmentConsole. Använd SqlAssessment.exe för att samla in prestandadata för din SQL-instans under en längre tidsperiod och mata ut resultatet till JSON- eller CSV-filen.
Dessa kommandon stöder rekommendationer för både Azure SQL Database, Azure SQL Managed Instance och distributionsalternativ för SQL Server på virtuella Azure-datorer.
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
| Argument | Beskrivning | Obligatoriskt (Y/N) |
|---|---|---|
PerfDataCollection |
Startar insamling av prestandadata. | Y |
GetSkuRecommendation |
Utför aggregering och analys av insamlade prestandadata och fastställer SKU-rekommendationer. | Y |
GetMetadata |
Utför en metadatasamling av SQL-målinstanserna, inklusive antalet och egenskaperna för serverinstanser, databaser och databasfiler, användardefinierade objekt osv. En fullständig rapport exporteras till MetadataReport.json. |
Y |
--outputFolder |
Mapp som prestandadata, rapporter och loggar skrivs till/läss från. | N (Standard: aktuell katalog) |
--sqlConnectionStrings |
Citatomringade formella anslutningssträngar för SQL-målinstanserna. | Y |
--overwrite |
Oavsett om du vill skriva över några befintliga utvärderings- eller SKU-rekommendationsrapporter. | N (Standard: true) |
--perfQueryIntervalInSec |
Intervall för att hämta prestandadata, i sekunder. | N (Specifikt för åtgärd PerfDataCollection. Standardinställning 30) |
--staticQueryIntervalInSec |
Intervall där du kan fråga efter och spara statiska konfigurationsdata i sekunder. | N (Specifikt för PerfDataCollection åtgärden. Standard 30) |
--numberOfIterations |
Antal iterationer av insamling av prestandadata som ska utföras innan filen sparas. | N (Specifikt för åtgärd PerfDataCollection. Standard 20) |
--perfQueryIntervalInSec |
Intervall med vilket prestandadata efterfrågades i sekunder. | N (Specifikt för GetSkuRecommendation åtgärd. Detta måste matcha det värde som ursprungligen användes under insamlingen av prestandadata. Standard: 30) |
--targetPlatform |
Målplattform för SKU-rekommendation: antingen AzureSqlDatabase, AzureSqlManagedInstance, AzureSqlVirtualMachineeller Any. |
N (Specifikt för GetSkuRecommendation åtgärd. Standard: Any) |
--targetSqlInstance |
Namnet på den SQL-instans som SKU-rekommendationen riktar sig till. | N (Specifikt för GetSkuRecommendation åtgärd) |
--targetPercentile |
Percentil av datapunkter som ska användas under aggregering av prestandadata. | N (Specifikt för GetSkuRecommendation åtgärd. Används endast för baslinjestrategi (icke-elastisk). Standard: 95) |
--scalingFactor |
Skalningsfaktor (komfort) som används under SKU-rekommendationen. | N (Specifikt för GetSkuRecommendation åtgärd. Standard: 100) |
--startTime |
UTC-starttid för prestandadatapunkter att tänka på under aggregering, i "YYYY-MM-DD HH:MM" format. |
N (Specifikt för GetSkuRecommendation åtgärd. Används endast för baslinjestrategi (ingenlastik) |
--endTime |
UTC-sluttid för prestandadatapunkter att tänka på under aggregering, i "YYYY-MM-DD HH:MM" format |
N (Specifikt för GetSkuRecommendation åtgärd. Används endast för baslinjestrategi (ingenlastik) |
--elasticStrategy |
Huruvida man ska använda den elastiska strategin för SKU-rekommendationer baserat på statistisk resursanvändningsprofilering. Elastisk strategi är för närvarande tillgänglig för Azure SQL Databases och SQL Managed Instance, men ännu inte tillgänglig för SQL Server på Azure VM. | N (Specifikt för GetSkuRecommendation åtgärd. Standard: false) |
--databaseAllowList |
Mellanslagsseparerad lista över namn på databaser som ska inkluderas för SKU-rekommendationer | N (Specifikt för GetSkuRecommendation åtgärd. Standard: null) |
--databaseDenyList |
Blankstegsavgränsad lista över namn på databaser som ska undantas för SKU-rekommendationer. Ange endast något av följande eller inget av följande: databaseAllowList, databaseDenyList |
N (Specifikt för GetSkuRecommendation åtgärd. Standard: null) |
--displayResult |
Om du vill skriva ut SKU-rekommendationsresultatet till konsolen eller inte. Ange endast något av följande eller inget av följande: databaseAllowList, databaseDenyList |
N (Specifikt för GetSkuRecommendation åtgärd. Standard: true) |
Exempel på SKU-utvärderingar med hjälp av CLI
SqlAssessment.exe
SqlAssessment.exe --help
Starta datainsamlingsprocessen för lokala SQL Server-instanser
.\SqlAssessment.exe PerfDataCollection
--sqlConnectionStrings "Data Source=Server1;Initial Catalog=master;Integrated Security=True;" "Data Source=Server2;Initial Catalog=master;Integrated Security=True;"
--outputFolder C:\Output
Azure SQL Database/Azure SQL Managed Instance/SQL Server på Azure VM SKU-rekommendationer
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform Any
SKU-rekommendationer för Azure SQL Managed Instance med specifik aggregeringsprocent för datapunkter och anpassad skalningsfaktor
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
--targetPercentile 90
--scalingFactor 80
Rekommendationer för SQL Server SKU på Azure VM med anpassad aggregeringstidslinje
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlVirtualMachine
--startTime "2021-06-05 00:00"
--endTime "2021-06-07 00:00"