通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az datamigration sql-db

  • 参考

注释

此参考是 Azure CLI（版本 2.15.0 或更高版本）的 数据迁移 扩展的一部分。 该扩展会在首次运行 az datamigration sql-db 命令时自动安装。 了解更多关于扩展 的相关信息。

管理到 SQL DB 的数据库迁移。

命令

名称 说明 类型 Status
az datamigration sql-db cancel

停止将数据库迁移到 SQL DB。

 扩展 GA
az datamigration sql-db create

创建新的数据库迁移到给定的 SQL 数据库。 此命令可将所选源数据库表中的数据迁移到目标数据库表。 如果目标数据库没有表，请使用 New-AzDataMigrationSqlServerSchema 命令将架构对象从源数据库迁移到目标 databse。 New-AzDataMigrationSqlServerSchema 的链接是 https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema。

 扩展 GA
az datamigration sql-db delete

删除正在进行的或已完成的数据库迁移到 SQL DB。

 扩展 GA
az datamigration sql-db show

检索给定 SQL DB 的指定数据库迁移。

 扩展 GA
az datamigration sql-db wait

将 CLI 置于等待状态，直到满足数据迁移 sql-db 的条件。

 扩展 GA

az datamigration sql-db cancel

停止将数据库迁移到 SQL DB。

az datamigration sql-db cancel --migration-operation-id
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]

示例

停止正在进行的数据库迁移。

az datamigration sql-db cancel --migration-operation-id "9a90bb84-e70f-46f7-b0ae-1aef5b3b9f07" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

必需参数

--migration-operation-id

ID 跟踪迁移作。

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqldb-instance-name

目标 SQL 数据库服务器的名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--target-db-name

目标数据库的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

az datamigration sql-db create

创建新的数据库迁移到给定的 SQL 数据库。 此命令可将所选源数据库表中的数据迁移到目标数据库表。 如果目标数据库没有表，请使用 New-AzDataMigrationSqlServerSchema 命令将架构对象从源数据库迁移到目标 databse。 New-AzDataMigrationSqlServerSchema 的链接是 https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema。

az datamigration sql-db create --resource-group
                               --sqldb-instance-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--scope]
                               [--source-database-name]
                               [--source-sql-connection]
                               [--table-list]
                               [--target-db-collation]
                               [--target-sql-connection]

示例

使用最大参数创建或更新数据库迁移资源。

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --table-list "[Schema1].[TableName1]" "[Schema2].[TableName2]" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

使用最小参数创建或更新数据库迁移资源。

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqldb-instance-name

目标 SQL 数据库服务器的名称。

--target-db-name

目标数据库的名称。

可选参数

--migration-service

迁移服务的资源 ID。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--scope

目标资源的资源 ID（SQL VM、SQL 托管实例或 SQL DB）。

--source-database-name

源数据库的名称。

--source-sql-connection

源 SQL Server 连接详细信息。

用法：--source-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

数据源：数据源。 身份验证：身份验证类型。 用户名：用于连接到源 SQL 的用户名。 密码：用于连接到源 SQL 的密码。 encrypt-connection：是否加密连接。 trust-server-certificate：是否信任服务器证书。

--table-list

要复制的表的列表。

--target-db-collation

要用于目标数据库的数据库排序规则。

--target-sql-connection

目标 SQL DB 连接详细信息。

用法：--target-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

数据源：数据源。 身份验证：身份验证类型。 用户名：用于连接到源 SQL 的用户名。 密码：用于连接到源 SQL 的密码。 encrypt-connection：是否加密连接。 trust-server-certificate：是否信任服务器证书。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

az datamigration sql-db delete

删除正在进行的或已完成的数据库迁移到 SQL DB。

az datamigration sql-db delete [--force {false, true}]
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]
                               [--yes]

示例

删除数据库迁移资源。

az datamigration sql-db delete --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

可选参数

--force

可选强制删除布尔值。 如果此项为 true，即使迁移处于活动状态，也会删除迁移。

接受的值: false, true
--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqldb-instance-name

目标 SQL 数据库服务器的名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--target-db-name

目标数据库的名称。

--yes -y

不要提示确认。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

az datamigration sql-db show

检索给定 SQL DB 的指定数据库迁移。

az datamigration sql-db show [--expand]
                             [--ids]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]

示例

使用 expand 参数获取 Sql DB 数据库迁移。

az datamigration sql-db show --expand "MigrationStatusDetails" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

在没有 expand 参数的情况下获取 Sql DB 数据库迁移。

az datamigration sql-db show --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

可选参数

--expand

响应中包括完整的迁移详细信息。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--migration-operation-id

可选的迁移作 ID。 如果提供此项，则会检索该 ID 的迁移作的详细信息。 如果未提供（默认值），则会检索与最近或当前作相关的详细信息。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqldb-instance-name

目标 SQL 数据库服务器的名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--target-db-name

目标数据库的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

az datamigration sql-db wait

将 CLI 置于等待状态，直到满足数据迁移 sql-db 的条件。

az datamigration sql-db wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--ids]
                             [--interval]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]
                             [--timeout]
                             [--updated]

示例

暂停执行下一行 CLI 脚本，直到成功创建数据迁移 sql-db。

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --created

暂停执行下一行 CLI 脚本，直到成功删除数据迁移 sql-db。

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --deleted

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False
--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False
--exists

等待资源存在。

默认值: False
--expand

响应中包括完整的迁移详细信息。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--interval

轮询间隔（以秒为单位）。

默认值: 30
--migration-operation-id

可选的迁移作 ID。 如果提供此项，则会检索该 ID 的迁移作的详细信息。 如果未提供（默认值），则会检索与最近或当前作相关的详细信息。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqldb-instance-name

目标 SQL 数据库服务器的名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--target-db-name

目标数据库的名称。

--timeout

最大等待（以秒为单位）。

默认值: 3600
--updated

等到 provisioningState 更新为“Succeeded”。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。