Data Migration Assistant uitvoeren vanaf de opdrachtprompt
Belangrijk
Data Migration Assistant (DMA) is afgeschaft. Zie de migratieopties voor SQL Server naar Azure SQLvoor migratieopties van SQL Server naar Azure SQL.
Vanaf versie 2.1 en later worden, wanneer u de Data Migration Assistant installeert, ook dmacmd.exe in %ProgramFiles%\Microsoft Data Migration Assistantgeïnstalleerd. Gebruik DMACMD- om uw databases in een modus zonder toezicht te evalueren en het resultaat uit te voeren naar het JSON- of CSV-bestand. Deze methode is vooral handig bij het beoordelen van verschillende databases of grote databases.
DMACMD- ondersteunt alleen het uitvoeren van evaluaties. Migraties worden momenteel niet ondersteund.
Evaluaties met behulp van de opdrachtregelinterface (CLI)
dmacmd.exe /AssessmentName="string"
/AssessmentDatabases="connectionString1" ["connectionString2"]
[/AssessmentSourcePlatform="SourcePlatform"]
[/AssessmentTargetPlatform="TargetPlatform"]
/AssessmentEvaluateFeatureParity|/AssessmentEvaluateCompatibilityIssues
[/AssessmentOverwriteResult]
/AssessmentResultJson="file"|/AssessmentResultCsv="file"
| Argument | Beschrijving | Vereist (J/N) |
|---|---|---|
/help or /? |
Hoe help-tekst dmacmd.exe te gebruiken | N |
/AssessmentName |
Naam van het evaluatieproject | Y |
/AssessmentDatabases |
Door spaties gescheiden lijst met verbindingsreeksen. Databasenaam (initiële catalogus) is hoofdlettergevoelig. | Y |
/AssessmentSourcePlatform |
Bronplatform voor de evaluatie: Ondersteunde waarden voor evaluatie: SqlOnPrem, RdsSqlServer (standaard)Ondersteunde waarden voor evaluatie van doelgereedheid: SqlOnPrem, RdsSqlServer (standaard), Cassandra (preview) |
N |
/AssessmentTargetPlatform |
Doelplatform voor de evaluatie: Ondersteunde waarden voor evaluatie: AzureSqlDatabase, ManagedSqlServer, SqlServer2012, SqlServer2014, SqlServer2016, SqlServerLinux2017en SqlServerWindows2017 (standaard)Ondersteunde waarden voor evaluatie van doelgereedheid: ManagedSqlServer (standaard), CosmosDB (preview) |
N |
/AssessmentEvaluateFeatureParity |
Functiepariteitsregels uitvoeren. Als het bronplatform RdsSqlServer is, wordt de functiepariteitsevaluatie niet ondersteund voor het doelplatform van AzureSqlDatabase | Y (AssessmentEvaluateCompatibilityIssues ofwel AssessmentEvaluateFeatureParity is vereist.) |
/AssessmentEvaluateCompatibilityIssues |
Compatibiliteitsregels uitvoeren | Y ( AssessmentEvaluateCompatibilityIssues of AssessmentEvaluateFeatureParity is vereist.) |
/AssessmentOverwriteResult |
Het resultaatbestand overschrijven | N |
/AssessmentResultJson |
Volledig pad naar het JSON-resultaatbestand | Y ( AssessmentResultJson of AssessmentResultCsv is nodig) |
/AssessmentResultCsv |
Volledig pad naar het CSV-resultaatbestand | Y ( AssessmentResultJson of AssessmentResultCsv is vereist) |
/AssessmentResultDma |
Volledig pad naar het .dma resultaatbestand |
N |
/Action |
Gebruik SkuRecommendation om SKU-aanbevelingen te krijgen.Gebruik AssessTargetReadiness om een evaluatie van de doelgereedheid uit te voeren.Gebruik AzureMigrateUpload om alle DMA-evaluatiebestanden in de AssessmentResultInputFolder bulk te uploaden naar Azure Migrate.
Action gebruik van type /Action=AzureMigrateUpload |
N |
/SourceConnections |
Door spaties gescheiden lijst met verbindingsreeksen. Databasenaam (initiële catalogus) is optioneel. Als er geen databasenaam is opgegeven, worden alle databases op de bron beoordeeld. | Y (Vereist als Action is AssessTargetReadiness) |
/TargetReadinessConfiguration |
Volledig pad naar het XML-bestand met een beschrijving van waarden voor de naam, bronverbindingen en resultaatbestand. | Y (Er is een keuze vereist tussen TargetReadinessConfiguration of SourceConnections) |
/FeatureDiscoveryReportJson |
Pad naar het JSON-rapport voor functiedetectie. Als dit bestand wordt gegenereerd, kan het worden gebruikt om de evaluatie van de doelgereedheid opnieuw uit te voeren zonder verbinding te maken met de bron. | N |
/ImportFeatureDiscoveryReportJson |
Pad naar het JSON-rapport voor functiedetectie dat u eerder hebt gemaakt. In plaats van bronverbindingen wordt dit bestand gebruikt. | N |
/EnableAssessmentUploadToAzureMigrate |
Hiermee kunt u evaluatieresultaten uploaden en publiceren naar Azure Migrate | N |
/AzureCloudEnvironment |
Hiermee selecteert u de Azure-cloudomgeving waarmee u verbinding wilt maken. De standaardinstelling is openbare Azure-cloud. Ondersteunde waarden: Azure (standaard), AzureChina, AzureGermany, AzureUSGovernment. |
N |
/SubscriptionId |
Azure-abonnements-id. | Y (Vereist als EnableAssessmentUploadToAzureMigrate argument is opgegeven) |
/AzureMigrateProjectName |
De naam van het Azure Migrate-project om evaluatieresultaten te uploaden naar. | Y (Vereist als EnableAssessmentUploadToAzureMigrate argument is opgegeven) |
/ResourceGroupName |
Azure Migrate-resourcegroepnaam. | Y (Vereist wanneer het EnableAssessmentUploadToAzureMigrate-argument is opgegeven) |
/AssessmentResultInputFolder |
Het pad naar de invoermap met .dma evaluatiebestanden die u wilt uploaden naar Azure Migrate. |
Y (Vereist als Action is AzureMigrateUpload) |
Voorbeelden van evaluaties met behulp van de CLI
DMACMD
dmacmd.exe /?
Of:
dmacmd.exe /help`
evaluatie van één database met windows-verificatie en het uitvoeren van compatibiliteitsregels
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentEvaluateCompatibilityIssues /AssessmentOverwriteResult
/AssessmentResultJson="C:\\temp\\Results\\AssessmentReport.json"
evaluatie van één database met behulp van SQL Server-verificatie en het uitvoeren van functiepariteit
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;User Id=myUsername;Password=myPassword;"
/AssessmentEvaluateFeatureParity /AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"
Één-database-evaluatie voor het doelplatform SQL Server 2012, waarbij de resultaten worden opgeslagen in de bestanden .json en .csv bestand
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"
Evaluatie van één database voor het doelplatform Azure SQL Database; sla de resultaten op in de bestanden .json en .csv bestand.
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"
evaluatie van meerdere databases
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"
evaluatie van de doelgereedheid voor één database met windows-verificatie
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Initial Catalog=DatabaseName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
evaluatie van de doelgereedheid voor één database met behulp van SQL Server-verificatie
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"
Evaluatie van één database voor doelplatform Azure SQL Database, sla de resultaten op in de bestanden .json en .csv bestand
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"
evaluatie van de doelgereedheid voor meerdere databases
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 en /AssessmentTargetPlatform zijn optioneel.)
Evaluatie van doelgereedheid voor alle databases op een server met behulp van Windows-verificatie
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Beoordeling van gereedheid voor het doel door het eerder gemaakte functiedetectierapport te importeren
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/ImportFeatureDiscoveryReportJson="c:\temp\feature_report.json"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Beoordeling van de gereedheid van het doel met behulp van een configuratiebestand
dmacmd.exe /Action=AssessTargetReadiness
/TargetReadinessConfiguration=.\Config.xml
Inhoud van configuratiebestand bij gebruik van bronverbindingen:
<?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>
Inhoud van configuratiebestand bij het importeren van functiedetectierapport:
<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>
Evalueren en uploaden naar Azure Migrate in de openbare Azure-cloud (standaard)
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
Batch DMA-evaluatiebestanden uploaden naar Azure Migrate in Azure Public Cloud (standaard)
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 op Azure VM SKU-aanbevelingen met behulp van de CLI
Vanaf versie 5.4 en latere versies installeert u bij het installeren van Data Migration Assistant ook SqlAssessment.exe in %ProgramFiles%\Microsoft Data Migration Assistant\SQLAssessmentConsole. Gebruik SqlAssessment.exe om prestatiegegevens voor uw SQL-exemplaar gedurende een langere periode te verzamelen en het resultaat uit te voeren naar het JSON- of CSV-bestand.
Deze opdrachten ondersteunen aanbevelingen voor zowel azure SQL Database-individuele database, Azure SQL Managed Instance als SQL Server op Azure VM-implementatieopties.
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
| Argument | Beschrijving | Vereist (J/N) |
|---|---|---|
PerfDataCollection |
Begint met het verzamelen van prestatiegegevens. | Y |
GetSkuRecommendation |
Hiermee voert u aggregatie en analyse van de verzamelde prestatiegegevens uit en bepaalt u SKU-aanbevelingen. | Y |
GetMetadata |
Voert een metagegevensverzameling uit van de doel-SQL-exemplaren, waaronder het aantal en de eigenschappen van serverexemplaren, databases en databasebestanden, door de gebruiker gedefinieerde objecten, enzovoort. Er wordt een volledig rapport geëxporteerd naar MetadataReport.json. |
Y |
--outputFolder |
Map waarin prestatiegegevens, rapporten en logboeken worden geschreven en gelezen. | N (Standaard: huidige directory) |
--sqlConnectionStrings |
Formele verbindingsreeksen tussen aanhalingstekens voor de doel-SQL-exemplaren. | Y |
--overwrite |
Of u bestaande evaluatie- of SKU-aanbevelingenrapporten al dan niet wilt overschrijven. | N (Standaard: true) |
--perfQueryIntervalInSec |
Interval voor het uitvoeren van query's op prestatiegegevens, in seconden. | N (Specifiek voor de PerfDataCollection-actie. Standaard 30) |
--staticQueryIntervalInSec |
Interval voor het opvragen en behouden van statische configuratiegegevens, in seconden. | N (Specifiek voor PerfDataCollection handeling. Standaard 30) |
--numberOfIterations |
Het aantal iteraties van het verzamelen van prestatiegegevens dat moet worden uitgevoerd voordat het bestand wordt bewaard. | N (Specifiek voor PerfDataCollection actie. Standaard 20) |
--perfQueryIntervalInSec |
Interval waarmee query's op prestatiegegevens zijn uitgevoerd, in seconden. | N (Specifiek voor GetSkuRecommendation actie. Dit moet overeenkomen met de waarde die oorspronkelijk is gebruikt tijdens het verzamelen van prestatiegegevens. Standaard: 30) |
--targetPlatform |
Doelplatform voor SKU-aanbeveling: AzureSqlDatabase, AzureSqlManagedInstance, AzureSqlVirtualMachineof Any. |
N (Specifiek voor GetSkuRecommendation actie. Standaard: Any) |
--targetSqlInstance |
Naam van het SQL-exemplaar waarop de SKU-aanbeveling is gericht. | N (Specifiek voor GetSkuRecommendation actie) |
--targetPercentile |
Percentiel van gegevenspunten die moeten worden gebruikt tijdens het samenvoegen van de prestatiegegevens. | N Specifiek voor actie GetSkuRecommendation. Alleen gebruikt voor de basislijnstrategie (niet-elastisch). Standaard: 95) |
--scalingFactor |
Schaalfactor (comfort) die wordt gebruikt tijdens de SKU-aanbeveling. | N (Specifiek voor GetSkuRecommendation actie. Standaard: 100) |
--startTime |
UTC-begintijd van prestatiegegevenspunten die tijdens de aggregatie moeten worden overwogen, in "YYYY-MM-DD HH:MM" indeling. |
N Specifiek voor de GetSkuRecommendation-actie. Alleen gebruikt voor de basislijnstrategie (niet-elastische strategie) |
--endTime |
UTC-eindtijd van prestatiegegevenspunten die tijdens de aggregatie moeten worden overwogen, in "YYYY-MM-DD HH:MM"-indeling |
N (Specifiek voor de GetSkuRecommendation-actie) Alleen gebruikt voor de basislijn (niet-elastische) strategie. |
--elasticStrategy |
Of u de elastische strategie voor SKU-aanbevelingen al dan niet wilt gebruiken op basis van profilering van statistisch resourcegebruik. Elastische strategie is momenteel beschikbaar voor Azure SQL Databases en SQL Managed Instance, nog niet beschikbaar voor SQL Server op Azure VM-doel. | N (Specifiek voor GetSkuRecommendation actie. Standaard: false) |
--databaseAllowList |
Door ruimte gescheiden lijst met namen van databases die moeten worden opgenomen voor SKU-aanbevelingen | N (Specifiek voor GetSkuRecommendation actie. Standaard: null) |
--databaseDenyList |
Door ruimte gescheiden lijst met namen van databases die moeten worden uitgesloten voor SKU-aanbevelingen. Stel slechts een van de volgende of beide in: databaseAllowList, databaseDenyList |
N (Specifiek voor GetSkuRecommendation actie. Standaard: null) |
--displayResult |
Of de SKU-aanbevelingsresultaten al dan niet naar de console moeten worden afgedrukt. Stel slechts een van de volgende of beide in: databaseAllowList, databaseDenyList |
N (Specifiek voor GetSkuRecommendation actie. Standaard: true) |
Voorbeelden van SKU-evaluaties met behulp van de CLI
SqlAssessment.exe
SqlAssessment.exe --help
het proces voor het verzamelen van gegevens starten voor on-premises SQL Server-exemplaren
.\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 op Azure VM SKU-aanbevelingen
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform Any
Azure SQL Managed Instance SKU-aanbevelingen met een specifiek aggregatiepercentage voor gegevenspunten en aangepaste schaalfactor
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
--targetPercentile 90
--scalingFactor 80
SQL Server op Azure VM SKU-aanbevelingen met aangepaste tijdlijn voor aggregatie
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlVirtualMachine
--startTime "2021-06-05 00:00"
--endTime "2021-06-07 00:00"