Eseguire Data Migration Assistant dalla riga di comando

  • Articolo

Importante

Data Migration Assistant (DMA) è deprecato. Per opzioni per la migrazione dei dati da SQL Server ad Azure SQL, vedere opzioni per la migrazione da SQL Server ad Azure SQL.

Con la versione 2.1 e le versioni successive, quando si installa Data Migration Assistant, viene installato dmacmd.exe in %ProgramFiles%\Microsoft Data Migration Assistant. Usare DMACMD per valutare i database in modalità automatica e restituire il risultato in un file JSON o CSV. Questo metodo è particolarmente utile quando si valutano diversi database o database enormi.

DMACMD supporta solo l'esecuzione di valutazioni. Le migrazioni non sono attualmente supportate.

Valutazioni che usano l'interfaccia della riga di comando

dmacmd.exe /AssessmentName="string"
/AssessmentDatabases="connectionString1" ["connectionString2"]
[/AssessmentSourcePlatform="SourcePlatform"]
[/AssessmentTargetPlatform="TargetPlatform"]
/AssessmentEvaluateFeatureParity|/AssessmentEvaluateCompatibilityIssues
[/AssessmentOverwriteResult]
/AssessmentResultJson="file"|/AssessmentResultCsv="file"
Argomento Descrizione Obbligatorio (S/N)
/help or /? Come usare il testo della guida di dmacmd.exe N
/AssessmentName Nome del progetto di valutazione Y
/AssessmentDatabases Elenco di stringhe di connessione delimitato da spazio. Per il nome del database (catalogo iniziale) viene applicata la distinzione tra maiuscole e minuscole. Y
/AssessmentSourcePlatform Piattaforma di origine per la valutazione:
Valori supportati per La valutazione: SqlOnPrem, RdsSqlServer (impostazione predefinita)
Valori supportati per la valutazione dell'idoneità della destinazione: SqlOnPrem, RdsSqlServer (impostazione predefinita), Cassandra (anteprima)		 N
/AssessmentTargetPlatform Piattaforma di destinazione per la valutazione:
Valori supportati per Valutazione: AzureSqlDatabase, ManagedSqlServer, SqlServer2012, SqlServer2014, SqlServer2016, SqlServerLinux2017 e SqlServerWindows2017 (impostazione predefinita)
Valori supportati per la valutazione dell'idoneità della destinazione: ManagedSqlServer, (impostazione predefinita), CosmosDB (anteprima)		 N
/AssessmentEvaluateFeatureParity Eseguire regole di parità delle funzionalità. Se la piattaforma di origine è RdsSqlServer, la valutazione della parità delle funzionalità non è supportata per la piattaforma di destinazione AzureSqlDatabase Y
(È obbligatorio specificare AssessmentEvaluateCompatibilityIssues o AssessmentEvaluateFeatureParity.)
/AssessmentEvaluateCompatibilityIssues Eseguire regole di compatibilità Y
(È obbligatorio specificare AssessmentEvaluateCompatibilityIssues o AssessmentEvaluateFeatureParity.)
/AssessmentOverwriteResult Sovrascrivere il file di risultati N
/AssessmentResultJson Percorso completo del file di risultati JSON Y
(È obbligatorio specificare AssessmentResultJson o AssessmentResultCsv)
/AssessmentResultCsv Percorso completo del file di risultati CSV Y
(È obbligatorio specificare AssessmentResultJson o AssessmentResultCsv)
/AssessmentResultDma Percorso completo del file di risultati .dma N
/Action Usare SkuRecommendation per ottenere raccomandazioni sullo SKU.
Usare AssessTargetReadiness per eseguire la valutazione dell'idoneità della destinazione.
Usare AzureMigrateUpload per caricare tutti i file di valutazione DMA nel AssessmentResultInputFolder per eseguire il caricamento bulk ad Azure Migrate. Utilizzo di tipo Action /Action=AzureMigrateUpload		 N
/SourceConnections Elenco di stringhe di connessione delimitato da spazio. Il nome del database (catalogo iniziale) è facoltativo. Se non viene specificato alcun nome di database, verranno valutati tutti i database nell'origine. Y
(Richiesto se Action è AssessTargetReadiness)
/TargetReadinessConfiguration Percorso completo del file XML che descrive i valori per il nome, le connessioni di origine e il file di risultato. Y
(È obbligatorio specificare TargetReadinessConfiguration o SourceConnections)
/FeatureDiscoveryReportJson Percorso del report JSON di individuazione delle funzionalità. Se questo file viene generato, può essere usato per eseguire nuovamente la valutazione dell'idoneità della destinazione senza connettersi all'origine. N
/ImportFeatureDiscoveryReportJson Percorso del report JSON di individuazione delle funzionalità creato in precedenza. Viene usato questo file invece delle connessioni di origine. N
/EnableAssessmentUploadToAzureMigrate Abilita il caricamento e la pubblicazione dei risultati della valutazione in Azure Migrate N
/AzureCloudEnvironment Seleziona l'ambiente cloud di Azure a cui connettersi. Il valore predefinito è Cloud pubblico di Azure. Valori supportati: Azure (impostazione predefinita), AzureChina, AzureGermany, AzureUSGovernment. N
/SubscriptionId ID sottoscrizione di Azure. Y
(Obbligatorio se l’argomento EnableAssessmentUploadToAzureMigrate è specificato)
/AzureMigrateProjectName Nome del progetto di Azure Migrate in cui caricare i risultati della valutazione. Y
(Obbligatorio se l’argomento EnableAssessmentUploadToAzureMigrate è specificato)
/ResourceGroupName Nome del gruppo di risorse di Azure Migrate. Y
(Obbligatorio se l’argomento EnableAssessmentUploadToAzureMigrate è specificato)
/AssessmentResultInputFolder Percorso della cartella di input contenente i file di valutazione .dmada caricare in Azure Migrate. Y
(Richiesto se Action è AzureMigrateUpload)

Esempi di valutazioni tramite l'interfaccia della riga di comando

DMACMD

dmacmd.exe /?

Oppure:

dmacmd.exe /help`

Valutazione database singolo con autenticazione di Windows ed esecuzione di regole di compatibilità

dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentEvaluateCompatibilityIssues /AssessmentOverwriteResult
/AssessmentResultJson="C:\\temp\\Results\\AssessmentReport.json"

Valutazione database singolo con autenticazione SQL Server ed esecuzione della parità delle funzionalità

dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;User Id=myUsername;Password=myPassword;"
/AssessmentEvaluateFeatureParity /AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"

Valutazione database singolo per la piattaforma di destinazione SQL Server 2012, con salvataggio dei risultati in file CSV e JSON

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"

Valutazione database singolo per la piattaforma di destinazione Database SQL di Azure, con salvataggio dei risultati in file CSV e JSON

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"

Valutazione di più database

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"

Valutazione dell'idoneità della destinazione per database singolo con autenticazione di Windows

dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Initial Catalog=DatabaseName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"

Valutazione dell'idoneità della destinazione per database singolo con autenticazione SQL Server

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"

Valutazione database singolo per la piattaforma di destinazione Database SQL di Azure, con salvataggio dei risultati in file CSV e JSON

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"

Valutazione dell'idoneità della destinazione per più database

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 e /AssessmentTargetPlatform sono facoltativi.)

Valutazione dell'idoneità della destinazione per tutti i database in un server con autenticazione di Windows

dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"

Valutazione dell'idoneità della destinazione mediante l'importazione del report di individuazione delle funzionalità creato in precedenza

dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/ImportFeatureDiscoveryReportJson="c:\temp\feature_report.json"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"

Valutazione dell'idoneità della destinazione specificando il file di configurazione

dmacmd.exe /Action=AssessTargetReadiness
/TargetReadinessConfiguration=.\Config.xml

Contenuti del file di configurazione quando si usano le connessioni di origine:

<?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>

Contenuti del file di configurazione durante l'importazione del report di individuazione delle funzionalità:

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

Eseguire la valutazione e il caricamento in Azure Migrate nel cloud pubblico di Azure (impostazione predefinita)

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

Caricare in batch i file di valutazione DMA in Azure Migrate nel cloud pubblico di Azure (impostazione predefinita)

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

Raccomandazioni per Database SQL di Azure/Istanza gestita di SQL di Azure/SQL Server negli SKU di Macchine virtuali di Azure usando l'interfaccia della riga di comando

Con la versione 5.4 e le versioni successive, quando si installa Data Migration Assistant, viene installato SqlAssessment.exe in %ProgramFiles%\Microsoft Data Migration Assistant\SQLAssessmentConsole. Usare SqlAssessment.exe per raccogliere dati sulle prestazioni per l'istanza di SQL per un lungo periodo di tempo e restituire il risultato in un file JSON o CSV.

Questi comandi supportano le raccomandazioni sia per Database SQL di Azure - Database singolo, Istanza gestita di SQL di Azure che SQL Server nelle opzioni di distribuzione delle macchine virtuali di Azure.

.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
Argomento Descrizione Obbligatorio (S/N)
PerfDataCollection Avvia la raccolta di dati sulle prestazioni. Y
GetSkuRecommendation Esegue l'aggregazione e l'analisi dei dati sulle prestazioni raccolti e determina le raccomandazioni relative allo SKU. Y
GetMetadata Esegue una raccolta di metadati di una o più istanze di SQL di destinazione, inclusi il numero e le proprietà delle istanze del server, dei database e dei file di database, degli oggetti definiti dall'utente e così via. Un report completo viene esportato in MetadataReport.json. Y
--outputFolder La cartella da cui verranno scritti/letti i dati sulle prestazioni, i report e i log. N
Impostazione predefinita: directory corrente
--sqlConnectionStrings Le stringhe di connessione formali racchiuse tra virgolette per le istanze SQL di destinazione. Y
--overwrite Indica se sovrascrivere o meno eventuali report esistenti relativi a valutazioni o raccomandazioni sullo SKU. N
Impostazione predefinita: true
--perfQueryIntervalInSec Intervallo in cui eseguire query sui dati sulle prestazioni, in secondi. N
Specifico per l'azione PerfDataCollection. Impostazione predefinita 30
--staticQueryIntervalInSec Intervallo in cui eseguire query e salvare in modo permanente i dati di configurazione statici, in secondi. N
Specifico per l'azione PerfDataCollection. Impostazione predefinita 30
--numberOfIterations Numero di iterazioni della raccolta di dati sulle prestazioni da eseguire prima di eseguire il salvataggio permanente in un file. N
Specifico per l'azione PerfDataCollection. Impostazione predefinita 20
--perfQueryIntervalInSec Intervallo in cui sono stati sottoposti a query i dati sulle prestazioni, in secondi. N
(Specifico per l'azione GetSkuRecommendation. Deve corrispondere al valore usato originariamente durante la raccolta dei dati sulle prestazioni. Impostazione predefinita: 30)
--targetPlatform Piattaforma di destinazione per la raccomandazione sullo SKU: AzureSqlDatabase, AzureSqlManagedInstance, AzureSqlVirtualMachine o Any. N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: Any)
--targetSqlInstance Nome dell'istanza di SQL a cui la raccomandazione SKU fa riferimento. N
(Specifico per l'azione GetSkuRecommendation)
--targetPercentile Percentile dei punti dati da usare durante l'aggregazione dei dati sulle prestazioni. N
(Specifico per l'azione GetSkuRecommendation. Usato solo per la strategia per la baseline (non elastica). Impostazione predefinita: 95
--scalingFactor Fattore di ridimensionamento (comfort) usato durante la raccomandazione dello SKU. N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: 100)
--startTime Ora di inizio UTC dei punti dati delle prestazioni da considerare durante l'aggregazione, in formato "YYYY-MM-DD HH:MM". N
(Specifico per l'azione GetSkuRecommendation. Usato solo per la strategia per la baseline (non elastica))
--endTime Ora di fine UTC dei punti dati delle prestazioni da considerare durante l'aggregazione, in formato "YYYY-MM-DD HH:MM" N
(Specifico per l'azione GetSkuRecommendation. Usato solo per la strategia per la baseline (non elastica))
--elasticStrategy Indica se usare o meno la strategia elastica per le raccomandazioni sullo SKU in base alla profilatura dell'utilizzo delle risorse statistiche. La strategia elastica è attualmente disponibile per Database SQL di Azure e Istanza gestita di SQL. Non è ancora disponibile per SQL Server nella destinazione della macchina virtuale di Azure. N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: false)
--databaseAllowList Elenco di nomi di database delimitato da spazi da includere per le raccomandazioni per gli SKU N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: null)
--databaseDenyList Elenco di nomi di database delimitato da spazi da escludere per le raccomandazioni per gli SKU. Impostare solo uno dei valori seguenti o nessuno dei due: databaseAllowList, databaseDenyList N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: null)
--displayResult Indica se stampare o meno i risultati della raccomandazione per lo SKU nella console. Impostare solo uno dei valori seguenti o nessuno dei due: databaseAllowList, databaseDenyList N
(Specifico per l'azione GetSkuRecommendation. Impostazione predefinita: true)

Esempi di valutazioni degli SKU tramite l'interfaccia della riga di comando

SqlAssessment.exe

SqlAssessment.exe --help

Avviare il processo di raccolta di dati per istanze di SQL Server locali

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

Raccomandazioni per Database SQL di Azure/Istanza gestita di SQL di Azure/SQL Server negli SKU di Macchine virtuali di Azure

.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform Any

Raccomandazioni per lo SKU di Istanza gestita di SQL di Azure con percentuale di aggregazione specifica per punti dati e fattore di ridimensionamento personalizzato

.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
--targetPercentile 90
--scalingFactor 80

Raccomandazioni per lo SKU di SQL Server in macchine virtuali di Azure con sequenza temporale di aggregazione personalizzata

.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlVirtualMachine
--startTime "2021-06-05 00:00"
--endTime "2021-06-07 00:00"

Contenuto correlato