A Data Migration Assistant futtatása a parancssorból
Fontos
A Data Migration Assistant (DMA) meg lett szüntetve. Az SQL Serverről az Azure SQL-be való migrálási lehetőségeket a SQL Server azure SQL-re való áttelepítési lehetőségek című cikkében találhatja meg.
A 2.1-es és az újabb verziókban, amikor telepíti a Data Migration Assistant-ot, a telepítés részeként dmacmd.exe
is települ a %ProgramFiles%\Microsoft Data Migration Assistant
-ben. A DMACMD használatával felügyelet nélküli módban értékelheti az adatbázisokat, és az eredményt JSON- vagy CSV-fájlba kimenetelheti. Ez a módszer különösen hasznos több adatbázis vagy hatalmas adatbázis értékelésekor.
DMACMD csak az értékelések futtatását támogatja. A migrálások jelenleg nem támogatottak.
Értékelések a parancssori felület (CLI) használatával
dmacmd.exe /AssessmentName="string"
/AssessmentDatabases="connectionString1" ["connectionString2"]
[/AssessmentSourcePlatform="SourcePlatform"]
[/AssessmentTargetPlatform="TargetPlatform"]
/AssessmentEvaluateFeatureParity|/AssessmentEvaluateCompatibilityIssues
[/AssessmentOverwriteResult]
/AssessmentResultJson="file"|/AssessmentResultCsv="file"
Érv | Leírás | Kötelező (Y/N) |
---|---|---|
/help or /? |
Hogyan kell használni a dmacmd.exe súgószöveget | N |
/AssessmentName |
Az értékelési projekt neve | Y |
/AssessmentDatabases |
A kapcsolati karakterláncok szóközzel tagolt listája. Az adatbázis neve (Initial Catalog) kis- és nagybetűérzékeny. | Y |
/AssessmentSourcePlatform |
Az értékelés forrásplatformja: Az Értékelés támogatott értékei: SqlOnPrem , RdsSqlServer (alapértelmezett)A Target Readiness Assessment támogatott értékei: SqlOnPrem , RdsSqlServer (alapértelmezett), Cassandra (előzetes verzió) |
N |
/AssessmentTargetPlatform |
Az értékelés célplatformja: Az értékelés támogatott értékei: AzureSqlDatabase , ManagedSqlServer , SqlServer2012 , SqlServer2014 , SqlServer2016 , SqlServerLinux2017 és SqlServerWindows2017 (alapértelmezett)A Target Readiness Assessment támogatott értékei: ManagedSqlServer (alapértelmezett), CosmosDB (előzetes verzió) |
N |
/AssessmentEvaluateFeatureParity |
Szolgáltatásparitási szabályok futtatása. Ha a forrásplatform RdsSqlServer, a szolgáltatás paritásának kiértékelése nem támogatott az AzureSqlDatabase célplatform esetében | Y (Az AssessmentEvaluateCompatibilityIssues vagy AssessmentEvaluateFeatureParity kötelező.) |
/AssessmentEvaluateCompatibilityIssues |
Kompatibilitási szabályok futtatása | Y ( AssessmentEvaluateCompatibilityIssues vagy AssessmentEvaluateFeatureParity szükséges.) |
/AssessmentOverwriteResult |
Az eredményfájl felülírása | N |
/AssessmentResultJson |
A JSON-eredményfájl teljes elérési útja | Y ( AssessmentResultJson vagy AssessmentResultCsv szükséges) |
/AssessmentResultCsv |
A CSV-eredményfájl teljes elérési útja | Y ( AssessmentResultJson vagy AssessmentResultCsv szükséges) |
/AssessmentResultDma |
A .dma eredményfájl teljes elérési útja |
N |
/Action |
A SkuRecommendation használatával kap SKU-javaslatokat.A AssessTargetReadiness használatával végezze el a célkészség-felmérést.A AzureMigrateUpload használatával feltöltheti a AssessmentResultInputFolder összes DMA-kiértékelőfájlt az Azure Migrate-be való tömeges feltöltéshez.
Action típus használat /Action=AzureMigrateUpload |
N |
/SourceConnections |
A kapcsolati karakterláncok szóközzel tagolt listája. Az adatbázis neve (kezdeti katalógus) megadása nem kötelező. Ha nincs megadva adatbázisnév, akkor a rendszer kiértékeli a forrás összes adatbázisát. | Y (Kötelező, ha Action is AssessTargetReadiness ) |
/TargetReadinessConfiguration |
Az XML-fájl teljes elérési útja, amely a név, a forráskapcsolatok és az eredményfájl értékeit írja le. | Y ( TargetReadinessConfiguration vagy SourceConnections szükséges) |
/FeatureDiscoveryReportJson |
A szolgáltatásfelderítés JSON-jelentésének elérési útja. Ha ez a fájl létrejön, akkor a forráshoz való csatlakozás nélkül újra futtatható a célkészség-felmérés. | N |
/ImportFeatureDiscoveryReportJson |
A korábban létrehozott szolgáltatásfelderítési JSON-jelentés elérési útja. Forráskapcsolatok helyett ezt a fájlt használja a rendszer. | N |
/EnableAssessmentUploadToAzureMigrate |
Lehetővé teszi az értékelési eredmények feltöltését és közzétételét az Azure Migrate-ben | N |
/AzureCloudEnvironment |
Kiválasztja azt az Azure-felhőkörnyezetet, amelyhez csatlakozni szeretne, az alapértelmezett az Azure Public Cloud. Támogatott értékek: Azure (alapértelmezett), AzureChina , AzureGermany , AzureUSGovernment . |
N |
/SubscriptionId |
Azure-előfizetés azonosítója. | Y ( EnableAssessmentUploadToAzureMigrate argumentum megadása esetén kötelező) |
/AzureMigrateProjectName |
Az Azure Migrate-projekt neve az értékelési eredmények feltöltéséhez. | Y ( EnableAssessmentUploadToAzureMigrate argumentum megadása esetén kötelező) |
/ResourceGroupName |
Azure Migrate-erőforráscsoport neve. | Y ( EnableAssessmentUploadToAzureMigrate argumentum megadása esetén kötelező) |
/AssessmentResultInputFolder |
Az Azure Migrate-be feltöltendő .dma értékelési fájlokat tartalmazó bemeneti mappa elérési útja. |
Y (Kötelező, ha Action egyenlő AzureMigrateUpload ) |
Példák a parancssori felület használatával végzett értékelésekre
DMACMD
dmacmd.exe /?
Vagy:
dmacmd.exe /help`
Egyadatbázis-felmérés Windows-hitelesítéssel és kompatibilitási szabályok futtatásával
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;Integrated Security=true"
/AssessmentEvaluateCompatibilityIssues /AssessmentOverwriteResult
/AssessmentResultJson="C:\\temp\\Results\\AssessmentReport.json"
egyadatbázis-felmérés SQL Server-hitelesítéssel és a szolgáltatás paritásának futtatásával
dmacmd.exe /AssessmentName="TestAssessment"
/AssessmentDatabases="Server=SQLServerInstanceName;Initial
Catalog=DatabaseName;User Id=myUsername;Password=myPassword;"
/AssessmentEvaluateFeatureParity /AssessmentOverwriteResult
/AssessmentResultCsv="C:\\temp\\Results\\AssessmentReport.csv"
Egyadatbázisos értékelés a SQL Server 2012 célplatformra, eredmények mentése .json és .csv fájl(ok)
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"
Egy adatbázisú értékelés az Azure SQL Database célplatformhoz, az eredmények mentése a .json és .csv fájlba
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"
Több adatbázisú felmérés
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"
egyadatbázisos célkészség felmérése Windows-hitelesítéssel
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Initial Catalog=DatabaseName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
egyadatbázisos célkészség felmérése SQL Server-hitelesítéssel
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"
Azure SQL Database célplatform egyadatbázisos felmérése, mentse el az eredményeket a(z) .json és .csv fájlba
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"
Többadatbázisú célra való felkészültség felmérése
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
és /AssessmentTargetPlatform
nem kötelező.)
Célkészenléti felmérés a kiszolgálón lévő összes adatbázis számára Windows-hitelesítéssel
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/SourceConnections="Server=SQLServerInstanceName;Integrated Security=true"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
Célkészség-felmérés a korábban létrehozott funkciófelderítési jelentés importálásával
dmacmd.exe /Action=AssessTargetReadiness
/AssessmentName="TestAssessment"
/ImportFeatureDiscoveryReportJson="c:\temp\feature_report.json"
/AssessmentOverwriteResult
/AssessmentResultJson="C:\temp\Results\AssessmentReport.json"
A célkészség felmérése konfigurációs fájl nyújtásával
dmacmd.exe /Action=AssessTargetReadiness
/TargetReadinessConfiguration=.\Config.xml
Konfigurációs fájl tartalma forráskapcsolatok használatakor:
<?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>
Konfigurációs fájl tartalma a funkciófelderítési jelentés importálásakor:
<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>
Az Azure Migrate felmérése és feltöltése az Azure Public Cloudban (alapértelmezett)
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-kiértékelési fájlokat tölt fel az Azure Migrate-be az Azure Public Cloudban (alapértelmezett)
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/Felügyelt Azure SQL-példány/SQL Server azure-beli virtuálisgép-termékváltozatra vonatkozó javaslatok a parancssori felület használatával
Az 5.4-es és újabb verziók esetén, amikor telepíti a Data Migration Assistantot, a SqlAssessment.exe
és a %ProgramFiles%\Microsoft Data Migration Assistant\SQLAssessmentConsole
is telepítésre kerül. A SqlAssessment.exe használatával hosszabb időn keresztül gyűjtse össze az SQL-példány teljesítményadatait, és az eredményt JSON- vagy CSV-fájlba adja ki.
Ezek a parancsok támogatják az önálló Azure SQL Database-adatbázisra, a felügyelt Azure SQL-példányra és az Azure-beli virtuális gépek üzembe helyezésére vonatkozó SQL Serverre vonatkozó javaslatokat.
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
Érvelés | Leírás | Kötelező (Y/N) |
---|---|---|
PerfDataCollection |
Megkezdi a teljesítményadatok gyűjtését. | Y |
GetSkuRecommendation |
Elvégzi az összegyűjtött teljesítményadatok összesítését és elemzését, és meghatározza a termékváltozatra vonatkozó javaslatokat. | Y |
GetMetadata |
Metaadat-gyűjteményt végez a cél SQL-példányokról, beleértve a kiszolgálópéldányok, adatbázisok és adatbázisfájlok, felhasználó által definiált objektumok stb. számát és tulajdonságait. A teljes jelentést a MetadataReport.json exportálja. |
Y |
--outputFolder |
Az a mappa, amelybe a teljesítményadatokat, a jelentéseket és a naplókat a rendszer beírja vagy beolvassa. | N (Alapértelmezett: aktuális könyvtár) |
--sqlConnectionStrings |
Idézőjelbe foglalt formális kapcsolati láncok a cél SQL-példányokhoz. | Y |
--overwrite |
Akár felülír egy meglévő értékelési vagy termékváltozat-javaslatjelentést, akár nem. | N (Alapértelmezett: true ) |
--perfQueryIntervalInSec |
A teljesítményadatok lekérdezésének időköze másodpercben. | N (A PerfDataCollection műveletre jellemző. Alapértelmezett 30 ) |
--staticQueryIntervalInSec |
A statikus konfigurációs adatok lekérdezésének és megőrzésének időköze másodpercben. | N (A PerfDataCollection műveletre jellemző. Alapértelmezett 30 ) |
--numberOfIterations |
A fájlban való megőrzése előtt végrehajtandó teljesítményadat-gyűjtemény iterációinak száma. | N (A PerfDataCollection műveletre jellemző. Alapértelmezett 20 ) |
--perfQueryIntervalInSec |
A teljesítményadatok lekérdezési időköze másodpercben. | N ( GetSkuRecommendation műveletre jellemző. Ennek meg kell egyeznie az eredetileg a teljesítményadat-adatgyűjtés során használt értékkel. Alapértelmezett: 30 ) |
--targetPlatform |
Termékváltozat-javaslat célplatformja: AzureSqlDatabase , AzureSqlManagedInstance , AzureSqlVirtualMachine vagy Any . |
N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: Any ) |
--targetSqlInstance |
Annak az SQL-példánynak a neve, amelyet az SKU-javaslat megcélzott. | N ( GetSkuRecommendation műveletre jellemző) |
--targetPercentile |
A teljesítményadatok összesítése során használandó adatpontok percentilise. | N A GetSkuRecommendation műveletre specifikus. Csak alapértelmezett (nem rugalmas) stratégiához használatos. Alapértelmezett: 95 ) |
--scalingFactor |
Az SKU-javaslat során használt skálázási (kényelmi) tényező. | N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: 100 ) |
--startTime |
Az összesítés során figyelembe veendő teljesítményadatok UTC szerinti kezdési időpontja "YYYY-MM-DD HH:MM" formátumban. |
N (Kifejezetten a GetSkuRecommendation művelethez kapcsolódóan. Csak alapszintű (nem rugalmas) stratégia esetén használatos. |
--endTime |
Az összesítés során figyelembe veendő teljesítményadatok UTC-záró időpontja "YYYY-MM-DD HH:MM" formátumban |
N ( GetSkuRecommendation műveletre jellemző. Csak alap (nem rugalmas) stratégiához használatos. |
--elasticStrategy |
A statisztikai erőforrás-használati profilkészítésen alapuló termékváltozat-javaslatok rugalmas stratégiájának használata. A rugalmas stratégia jelenleg elérhető az Azure SQL Database-ekhez és a felügyelt SQL-példányokhoz, és még nem érhető el az Azure-beli virtuálisgép-célon futó SQL Serverhez. | N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: false ) |
--databaseAllowList |
Az SKU-javaslatokhoz mellékelendő adatbázisok nevének szóközzel elválasztott listája | N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: null ) |
--databaseDenyList |
Az SKU-javaslatokhoz kizárandó adatbázisok neveinek szóközzel elválasztott listája. Csak az alábbiak egyikét állítsa be, vagy egyiket sem: databaseAllowList , databaseDenyList |
N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: null ) |
--displayResult |
Az, hogy a SKU-javaslat eredményeit kinyomtassuk-e a konzolra. Csak az alábbiak egyikét állítsa be, vagy egyiket sem: databaseAllowList , databaseDenyList |
N ( GetSkuRecommendation műveletre jellemző. Alapértelmezett: true ) |
Példák termékváltozat-értékelésekre a parancssori felület használatával
SqlAssessment.exe
SqlAssessment.exe --help
Helyszíni SQL Server-példányok adatgyűjtési folyamatának indítása
.\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/Felügyelt Azure SQL-példány/SQL Server azure-beli virtuálisgép-termékváltozatra vonatkozó javaslatok
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform Any
Azure SQL Kezelt Példány SKU javaslatok meghatározott összesítési százalékkal az adatpontokhoz és egyéni skálázási tényezővel
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
--targetPercentile 90
--scalingFactor 80
AZURE-beli virtuálisgép-termékváltozatra vonatkozó SQL Server-javaslatok egyéni összesítési ütemtervvel
.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlVirtualMachine
--startTime "2021-06-05 00:00"
--endTime "2021-06-07 00:00"