Поделиться через


Запуск Помощник по миграции данных из командной строки

Внимание

Помощник по миграции данных (DMA) не рекомендуется. Варианты миграции из SQL Server в SQL Azure см. в параметрах миграции SQL Server в Sql Azure.

При установке Помощник по миграции данных версии 2.1 и более поздних версий она также устанавливается dmacmd.exe в %ProgramFiles%\Microsoft Data Migration Assistant. Используйте DMACMD для оценки баз данных в автоматическом режиме и вывода результата в JSON или CSV-файл. Этот метод особенно полезен при оценке нескольких баз данных или огромных баз данных.

DMACMD поддерживает только выполнение оценок. Миграции в настоящее время не поддерживаются.

Оценки с помощью интерфейса командной строки (CLI)

dmacmd.exe /AssessmentName="string"
/AssessmentDatabases="connectionString1" ["connectionString2"]
[/AssessmentSourcePlatform="SourcePlatform"]
[/AssessmentTargetPlatform="TargetPlatform"]
/AssessmentEvaluateFeatureParity|/AssessmentEvaluateCompatibilityIssues
[/AssessmentOverwriteResult]
/AssessmentResultJson="file"|/AssessmentResultCsv="file"
Аргумент Description Обязательный (Y/N)
/help or /? Использование текста справки dmacmd.exe N
/AssessmentName Имя проекта оценки Y
/AssessmentDatabases Список строка подключения с разделителями пробелов. Имя базы данных (начальный каталог) учитывает регистр. Y
/AssessmentSourcePlatform Исходная платформа для оценки:
Поддерживаемые значения для оценки: SqlOnPrem( RdsSqlServer по умолчанию)
Поддерживаемые значения для оценки готовности целевого объекта: SqlOnPrem, RdsSqlServer (по умолчанию), Cassandra (предварительная версия)
N
/AssessmentTargetPlatform Целевая платформа для оценки:
Поддерживаемые значения для оценки: AzureSqlDatabase, ManagedSqlServer, SqlServer2012, SqlServer2014, SqlServerLinux2017SqlServer2016, и SqlServerWindows2017 (по умолчанию)
Поддерживаемые значения для оценки готовности целевого объекта: ManagedSqlServer (по умолчанию), CosmosDB (предварительная версия)
N
/AssessmentEvaluateFeatureParity Запустите правила четности функций. Если исходная платформа — RdsSqlServer, оценка четности функций не поддерживается для целевой платформы AzureSqlDatabase Y
(ОценкаEvaluateCompatibilityIssues или AssessmentEvaluateFeatureParity является обязательным.)
/AssessmentEvaluateCompatibilityIssues Выполнение правил совместимости Y
(Либо AssessmentEvaluateCompatibilityIssues AssessmentEvaluateFeatureParity требуется.)
/AssessmentOverwriteResult Перезапись файла результата N
/AssessmentResultJson Полный путь к файлу результата JSON Y
(Либо AssessmentResultJson AssessmentResultCsv требуется)
/AssessmentResultCsv Полный путь к CSV-файлу результатов Y
(Либо AssessmentResultJson AssessmentResultCsv требуется)
/AssessmentResultDma Полный путь к файлу .dma результата N
/Action Используйте SkuRecommendation для получения рекомендаций SKU.
Используется AssessTargetReadiness для оценки готовности целевого объекта.
Используется AzureMigrateUpload для отправки всех файлов оценки DMA в массовой отправке AssessmentResultInputFolder в службу "Миграция Azure". Action Использование типа /Action=AzureMigrateUpload
N
/SourceConnections Разделенный пробелами список строка подключения. Имя базы данных (начальный каталог) является необязательным. Если имя базы данных не указано, то оцениваются все базы данных в источнике. Y
(Требуется, если Action есть AssessTargetReadiness)
/TargetReadinessConfiguration Полный путь к XML-файлу, описывающий значения для имени, исходных подключений и результирующих файлов. Y
(Либо TargetReadinessConfiguration SourceConnections требуется)
/FeatureDiscoveryReportJson Путь к отчету JSON обнаружения функций. Если этот файл создается, его можно использовать для повторной оценки готовности к целевому объекту без подключения к источнику. N
/ImportFeatureDiscoveryReportJson Путь к отчету JSON обнаружения функций, созданному ранее. Вместо исходных подключений этот файл используется. N
/EnableAssessmentUploadToAzureMigrate Включение отправки и публикации результатов оценки в службу "Миграция Azure" N
/AzureCloudEnvironment Выбирает облачную среду Azure для подключения, по умолчанию используется общедоступное облако Azure. Поддерживаемые значения: Azure (по умолчанию), AzureChina, AzureGermany. AzureUSGovernment N
/SubscriptionId Идентификатор подписки Azure. Y
(Требуется, если EnableAssessmentUploadToAzureMigrate задан аргумент)
/AzureMigrateProjectName Имя проекта миграции Azure для отправки результатов оценки. Y
(Требуется, если EnableAssessmentUploadToAzureMigrate задан аргумент)
/ResourceGroupName Имя группы ресурсов службы "Миграция Azure". Y
(Требуется, если EnableAssessmentUploadToAzureMigrate задан аргумент)
/AssessmentResultInputFolder Путь к входной папке, .dma содержащий файлы оценки для отправки в службу "Миграция Azure". Y
(Требуется, если Action есть AzureMigrateUpload)

Примеры оценки с помощью интерфейса командной строки

DMACMD

dmacmd.exe /?

Или сделайте так:

dmacmd.exe /help`

Оценка одной базы данных с помощью проверка подлинности Windows и выполнения правил совместимости

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

Оценка отдельных баз данных с помощью проверки подлинности SQL Server и четности функций

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

Оценка одной базы данных для целевой платформы SQL Server 2012, сохранение результатов в .json и .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"

Оценка одной базы данных для целевой платформы База данных SQL Azure, сохранение результатов в .json и .csv файла

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"

Оценка нескольких баз данных

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"

Оценка готовности целевой целевой базы данных с помощью проверка подлинности Windows

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

Оценка готовности целевой базы данных с помощью проверки подлинности 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"

Оценка одной базы данных для целевой платформы База данных SQL Azure, сохранение результатов в .json и .csv файла

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"

Оценка готовности к работе с несколькими базами данных

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 и /AssessmentTargetPlatform являются необязательными.)

Оценка целевой готовности для всех баз данных на сервере с помощью проверка подлинности Windows

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

Оценка готовности целевого объекта путем импорта отчета об обнаружении компонентов, созданного ранее

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

Оценка готовности целевого объекта путем предоставления файла конфигурации

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

Содержимое файла конфигурации при использовании исходных подключений:

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

Содержимое файла конфигурации при импорте отчета об обнаружении компонентов:

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

Оценка и отправка в службу "Миграция Azure" в общедоступном облаке Azure (по умолчанию)

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

Пакетная отправка файлов оценки DMA в службу "Миграция Azure" в общедоступном облаке Azure (по умолчанию)

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

База данных SQL Azure / Управляемый экземпляр SQL Azure / SQL Server в SKU виртуальной машины Azure с помощью интерфейса командной строки

При установке Помощник по миграции данных версии 5.4 и более поздних версий она также устанавливается SqlAssessment.exe в %ProgramFiles%\Microsoft Data Migration Assistant\SQLAssessmentConsole. Используйте SqlAssessment.exe для сбора данных о производительности для экземпляра SQL в течение длительного периода времени и вывода результата в JSON-файл или CSV-файл.

Эти команды поддерживают рекомендации по развертыванию виртуальных машин Azure База данных SQL Azure отдельной базе данных, Управляемый экземпляр SQL Azure и SQL Server.

.\SqlAssessment.exe GetSkuRecommendation
--outputFolder C:\Output
--targetPlatform AzureSqlManagedInstance
Аргумент Description Обязательный (Y/N)
PerfDataCollection Начинает сбор данных о производительности. Y
GetSkuRecommendation Выполняет агрегирование и анализ собранных данных о производительности и определяет рекомендации SKU. Y
GetMetadata Выполняет коллекцию метаданных целевых экземпляров SQL, включая количество и свойства экземпляров сервера, баз данных и файлов баз данных, определяемых пользователем объектов и т. д. Полный отчет экспортируется в MetadataReport.json. Y
--outputFolder Папка, из которой записываются данные о производительности, отчеты и журналы. N
(по умолчанию: текущий каталог)
--sqlConnectionStrings Заключаемые в кавычки формальные строка подключения для целевых экземпляров SQL. Y
--overwrite Следует ли перезаписать существующие отчеты об оценке или номере SKU. N
(Значение по умолчанию: true.)
--perfQueryIntervalInSec Интервал запроса данных о производительности в секундах. N
(Конкретно для PerfDataCollection действия. По умолчанию 30)
--staticQueryIntervalInSec Интервал запроса и сохранения статических данных конфигурации в секундах. N
(Конкретно для PerfDataCollection действия. По умолчанию 30)
--numberOfIterations Количество итерации сбора данных о производительности перед сохранением в файле. N
(Конкретно для PerfDataCollection действия. По умолчанию 20)
--perfQueryIntervalInSec Интервал, в течение которого запрашивались данные о производительности в секундах. N
(Конкретно для GetSkuRecommendation действия. Это должно соответствовать значению, которое изначально использовалось во время сбора данных о производительности. По умолчанию: 30)
--targetPlatform Целевая платформа для рекомендации SKU: AzureSqlDatabaseлибо , AzureSqlVirtualMachineAzureSqlManagedInstanceлибо Any. N
(Конкретно для GetSkuRecommendation действия. По умолчанию: Any)
--targetSqlInstance Имя экземпляра SQL, на который ориентирована рекомендация SKU. N
(Конкретно для GetSkuRecommendation действия)
--targetPercentile Процентиль точек данных, используемых во время агрегирования данных производительности. N
(Конкретно для GetSkuRecommendation действия. Используется только для базовой стратегии (nonelastic). По умолчанию: 95)
--scalingFactor Коэффициент масштабирования (комфорт), используемый во время рекомендации SKU. N
(Конкретно для GetSkuRecommendation действия. По умолчанию: 100)
--startTime Время начала utc точек данных производительности, которые следует учитывать во время агрегирования в "YYYY-MM-DD HH:MM" формате. N
(Конкретно для GetSkuRecommendation действия. Используется только для базовой стратегии (nonelastic)
--endTime Время окончания utc точек данных производительности, которые следует учитывать во время агрегирования в "YYYY-MM-DD HH:MM" формате N
(Конкретно для GetSkuRecommendation действия. Используется только для базовой стратегии (nonelastic)
--elasticStrategy Следует ли использовать эластичную стратегию для рекомендаций SKU на основе профилирования использования статистических ресурсов. В настоящее время эластичная стратегия доступна для База данных SQL Azure и Управляемый экземпляр SQL, пока недоступна для SQL Server на целевом объекте виртуальной машины Azure. N
(Конкретно для GetSkuRecommendation действия. По умолчанию: false)
--databaseAllowList Разделенный пробелом список имен баз данных для рекомендаций SKU N
(Конкретно для GetSkuRecommendation действия. По умолчанию: null)
--databaseDenyList Разделенный пробелами список имен баз данных, которые следует исключить для рекомендаций SKU. Задайте только одно из следующих или ни одно из следующих элементов: databaseAllowListdatabaseDenyList N
(Конкретно для GetSkuRecommendation действия. По умолчанию: null)
--displayResult Независимо от того, следует ли распечатать результаты рекомендаций SKU в консоли. Задайте только одно из следующих или ни одно из следующих элементов: databaseAllowListdatabaseDenyList N
(Конкретно для GetSkuRecommendation действия. По умолчанию: true)

Примеры оценки SKU с помощью интерфейса командной строки

SqlAssessment.exe

SqlAssessment.exe --help

Запуск процесса сбора данных для локальных экземпляров SQL Server

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

База данных SQL Azure / Управляемый экземпляр SQL Azure / SQL Server в рекомендациях SKU виртуальной машины Azure

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

Управляемый экземпляр SQL Azure рекомендации по SKU с определенным процентом агрегирования для точек данных и настраиваемым коэффициентом масштабирования

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

Рекомендации SQL Server на SKU виртуальной машины Azure с пользовательской временной шкалой агрегирования

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