你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az datamigration
注意
此参考是 Azure CLI(版本 2.15.0 或更高版本)的数据迁移扩展的一部分。 该扩展将在首次运行 az datamigration 命令时自动安装。 详细了解扩展。
管理数据迁移。
命令
az datamigration get-assessment
在 SQL Server 实例上启动评估。
az datamigration get-assessment [--config-file-path]
[--connection-string]
[--output-folder]
[--overwrite]
示例
使用 连接字符串 在给定的 SQL Server 上运行 SQL 评估。
az datamigration get-assessment --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\AssessmentOutput" --overwrite
使用评估配置文件在给定的 SQL Server 上运行 SQL 评估。
az datamigration get-assessment --config-file-path "C:\Users\user\document\config.json"
使用 连接字符串 在一次调用中对多个 SQL Server 运行 SQL 评估。
az datamigration get-assessment --connection-string "Data Source=LabServer1.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" "Data Source=LabServer2.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\AssessmentOutput" --overwrite
可选参数
ConfigFile 的路径。
SQL Server 连接ion 字符串。
用于存储评估报告的输出文件夹。
启用此参数以覆盖现有评估报告。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration get-sku-recommendation
为 Azure SQL 产品/服务提供 SKU 建议。
az datamigration get-sku-recommendation [--config-file-path]
[--database-allow-list]
[--database-deny-list]
[--display-result]
[--elastic-strategy]
[--end-time]
[--output-folder]
[--overwrite]
[--scaling-factor]
[--start-time]
[--target-percentile]
[--target-platform]
[--target-sql-instance]
示例
使用命令行获取给定 SQL Server 的 SKU 建议。
az datamigration get-sku-recommendation --output-folder "C:\PerfCollectionOutput" --database-allow-list AdventureWorks1 AdventureWorks2 --display-result --overwrite
使用评估配置文件获取给定 SQL Server 的 SKU 建议。
az datamigration get-sku-recommendation --config-file-path "C:\Users\user\document\config.json"
可选参数
ConfigFile 的路径。
允许在排除所有其他数据库时考虑 SKU 建议考虑的数据库名称的空格分隔列表。 仅设置以下一项或都不设置:databaseAllowList、databaseDenyList。 默认值:NULL。
不考虑 SKU 建议的数据库名称的空格分隔列表。 仅设置以下一项或都不设置:databaseAllowList、databaseDenyList。 默认值:NULL。
是否将 SKU 建议结果输出到控制台。 启用此参数以显示结果。
是否根据资源使用情况分析使用 SKU 建议的弹性策略。 启用此参数以使用弹性策略。
聚合期间要考虑的性能数据的 UTC 结束时间,采用 YYYY-MM-DD HH:MM 格式。 仅用于基线(非弹性)策略。 默认值:将考虑收集的所有数据点。
存储 SQL Server 性能数据的输出文件夹。 此处的值必须与 PerfDataCollection 中使用的值相同。
是否覆盖任何现有的 SKU 建议报告。 启用此参数以覆盖。
SKU 建议过程中使用的缩放(“舒适”)因子。 例如,如果确定有一个 4 vCore CPU 需求,且缩放因子为 150%,则真正的 CPU 需求将为 6 vCore。
聚合期间要考虑的性能数据点的 UTC 开始时间,采用 YYYY-MM-DD HH:MM 格式。 仅用于基线(非弹性)策略。 默认值:将考虑收集的所有数据点。
聚合性能数据期间要使用的数据点的百分位。 仅用于基线(非弹性)策略。
SKU 建议的目标平台:AzureSqlDatabase、AzureSqlManagedInstance、AzureSqlVirtualMachine 或 Any。 如果选择了“任何”,则会评估所有三个目标平台的 SKU 建议,并返回最佳拟合度。
应为其推荐 SKU 的 SQL 实例的名称。 默认值:将扫描 outputFolder 以获取 PerfDataCollection 操作创建的文件,并为找到的每个实例提供建议。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration login-migration
将登录名从源 Sql Server 迁移到目标 Azure Sql Server。
az datamigration login-migration [--aad-domain-name]
[--config-file-path]
[--csv-file-path]
[--list-of-login]
[--output-folder]
[--src-sql-connection-str]
[--tgt-sql-connection-str]
示例
使用参数运行从源 Sql Server 到目标 Azure Sql Server 的登录名。
az datamigration login-migration --src-sql-connection-str "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --tgt-sql-connection-str "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --csv-file-path "C:\CSVFile" --list-of-login "loginname1" "loginname2" --output-folder "C:\OutputFolder" --aad-domain-name "AADDomainName"
使用配置文件运行从源 Sql Server 到目标 Azure Sql Server 的登录名。
az datamigration login-migration --config-file-path "C:\Users\user\document\config.json"
可选参数
如果要迁移的登录名列表中包括 Windows 登录名,则为必需。
ConfigFile 的路径。
登录名的 CSV 文件的位置。 在此参数和 listOfLogin 之间只使用一个参数。
字符串格式的登录名列表。 如果需要迁移大量登录名,请使用 CSV 文件选项。
默认值:%LocalAppData%/Microsoft/SqlLoginMigrations) 将写入日志的文件夹。
使用正式连接字符串格式的源 SQL 实例连接字符串(s)。
使用正式连接字符串格式的目标 SQL 实例的连接字符串(s)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration performance-data-collection
收集给定 SQL Server 实例的性能数据。
az datamigration performance-data-collection [--config-file-path]
[--connection-string]
[--number-of-iteration]
[--output-folder]
[--perf-query-interval]
[--static-query-interval]
[--time]
示例
使用 连接字符串 收集给定 SQL Server 的性能数据。
az datamigration performance-data-collection --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60
使用 连接字符串 在一次调用中收集多个 SQL Server 的性能数据。
az datamigration performance-data-collection --connection-string "Data Source=LabServer1.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" "Data Source=LabServer2.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60
使用评估配置文件收集给定 SQL Server 的性能数据。
az datamigration performance-data-collection --config-file-path "C:\Users\user\document\config.json"
通过指定时间限制来收集给定 SQL Server 的性能数据。 如果指定的时间限制是在迭代周期的延续之前,则该过程将结束,而不会保存最后一个周期的性能数据。
az datamigration performance-data-collection --connection-string "Data Source=LabServer.database.net;Initial Catalog=master;Integrated Security=False;User Id=User;Password=password" --output-folder "C:\PerfCollectionOutput" --number-of-iteration 5 --perf-query-interval 10 --static-query-interval 60 --time 60
可选参数
ConfigFile 的路径。
SQL Server 连接ion 字符串。
在保存到文件之前要执行的性能数据收集迭代次数。 例如,使用默认值,性能数据将每 10 分钟(= 30 秒 * 20 次迭代)保存一次。 最小值:2。
用于存储性能数据的输出文件夹。
查询性能数据的间隔(以秒为单位)。
查询和保留静态配置数据的时间间隔(以秒为单位)。
命令执行自动停止的时间(以秒为单位)。 如果未指定此参数,则需要手动干预才能停止命令执行。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration register-integration-runtime
在 Integration Runtime 上注册数据库迁移服务。
az datamigration register-integration-runtime --auth-key
[--installed-ir-path]
[--ir-path]
示例
在自承载集成运行时上注册 Sql 迁移服务。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc"
安装 Integration Runtime 并在其中注册 Sql 迁移服务。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc" --ir-path "C:\Users\user\Downloads\IntegrationRuntime.msi"
从给定安装位置读取 Integration Runtime。
az datamigration register-integration-runtime --auth-key "IR@00000-0000000-000000-aaaaa-bbbb-cccc" --installed-ir-path "D:\My Softwares\Microsoft Integration Runtime\5.0"
必需参数
SQL 迁移服务的 AuthKey。
可选参数
Integration Runtime 安装位置中的版本文件夹路径。 安装 IR 时,可以提供此功能,但命令无法读取它。 格式:“\Microsoft Integration Runtime<版本>”。
Integration Runtime MSI 的路径。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration sql-server-schema
将架构从源 Sql Server 迁移到目标 Azure Sql Server。
az datamigration sql-server-schema [--action {DeploySchema, GenerateScript, MigrateSchema}]
[--config-file-path]
[--input-script-file-path]
[--output-folder]
[--src-sql-connection-str]
[--tgt-sql-connection-str]
示例
使用参数将数据库对象从源 SQL Server 运行到目标Azure SQL 数据库。
az datamigration sql-server-schema --action "MigrateSchema" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password="
使用参数从源 SQL Server 运行生成 TSQL 架构脚本。
az datamigration sql-server-schema --action "GenerateScript" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --output-folder "C:\OutputFolder"
使用参数将 TSQL 脚本部署到目标Azure SQL 数据库。
az datamigration sql-server-schema --action "GenerateScript" --src-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --tgt-sql-connection-str "Server=;Initial Catalog=;User ID=;Password=" --input-script-file-path "C:\OutputFolder\script.sql"
使用 ConfigFile 将数据库对象从源 SQL Server 运行到目标Azure SQL 数据库。
az datamigration sql-server-schema --config-file-path "C:\configfile.json"
可选参数
选择一个架构迁移操作。 MigrateSchema 将数据库对象迁移到Azure SQL 数据库目标。 GenerateScript 用于生成可编辑的 TSQL 架构脚本,该脚本可用于在目标上运行以部署对象。 DeploySchema 是在目标上运行从 -GenerateScript 操作生成的 TSQL 脚本来部署对象。
ConfigFile 的路径。 configfile.json中接受的参数名称为 Action、source连接ionString、target连接ionString、inputScriptFilePath 和 outputFolder。
可编辑 TSQL 架构脚本的位置。 仅对 DeploySchema Action 使用此参数。
默认值:%LocalAppData%/Microsoft/SqlSchemaMigration) 将写入日志的文件夹,并通过 GenerateScript 操作生成 TSQL 架构脚本。
使用正式连接字符串格式为源 SQL 实例连接字符串。
使用正式连接字符串格式连接目标 SQL 实例的字符串。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az datamigration tde-migration
将 TDE 证书从源 SQL Server 迁移到目标 Azure SQL Server。
az datamigration tde-migration [--database-name]
[--network-share-domain]
[--network-share-password]
[--network-share-path]
[--network-share-user-name]
[--source-sql-connection-string]
[--target-managed-instance-name]
[--target-resource-group-name]
[--target-subscription-id]
示例
将 TDE 证书从源 SQL Server 迁移到目标 Azure SQL Server。
az datamigration tde-migration --source-sql-connection-string "data source=servername;user id=userid;password=;initial catalog=master;TrustServerCertificate=True" --target-subscription-id "00000000-0000-0000-0000-000000000000" --target-resource-group-name "ResourceGroupName" --target-managed-instance-name "TargetManagedInstanceName" --network-share-path "\NetworkShare\Folder" --network-share-domain "NetworkShare" --network-share-user-name "NetworkShareUserName" --network-share-password "" --database-name "TdeDb_0" "TdeDb_1" "TdeDb_2"
可选参数
源数据库名称。
网络共享域。
网络共享密码。
网络共享路径。
网络共享用户名。
使用正式连接字符串格式为源 SQL 实例连接字符串。
Azure SQL Server 的名称。
目标 Azure SQL Server 的资源组名称。
目标 Azure SQL Server 的订阅 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。