共用方式為

az datamigration sql-db

  • 參考

注意

此參考是 Azure CLI 的數據匯入延伸模組的一部分（2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az datamigration sql-db 命令時自動安裝。 深入了解擴充功能。

管理資料庫移轉至 SQL DB。

命令

名稱 Description 類型 狀態
az datamigration sql-db cancel

停止進行中的資料庫移轉至 SQL DB。

 副檔名 GA
az datamigration sql-db create

建立新的資料庫移轉至指定的 SQL Db。 此命令可以將數據從選取的源資料庫數據表遷移至目標資料庫數據表。 如果目標資料庫沒有現有的數據表，請使用 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

標識元追蹤移轉作業。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sqldb-instance-name

目標 SQL 資料庫 伺服器的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az datamigration sql-db create

建立新的資料庫移轉至指定的 SQL Db。 此命令可以將數據從選取的源資料庫數據表遷移至目標資料庫數據表。 如果目標資料庫沒有現有的數據表，請使用 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

移轉服務的資源標識碼。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--scope

目標資源的資源識別碼（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

數據源：數據源。 驗證：驗證類型。 user-name：連線至來源 SQL 的用戶名稱。 password：連線至來源 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

數據源：數據源。 驗證：驗證類型。 user-name：連線至來源 SQL 的用戶名稱。 password：連線至來源 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sqldb-instance-name

目標 SQL 資料庫 伺服器的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--migration-operation-id

選擇性移轉作業標識碼。 如果提供，則會擷取該標識碼的移轉作業詳細數據。 如果未提供 （預設值），則會擷取與最近或目前作業相關的詳細數據。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sqldb-instance-name

目標 SQL 資料庫 伺服器的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--migration-operation-id

選擇性移轉作業標識碼。 如果提供，則會擷取該標識碼的移轉作業詳細數據。 如果未提供 （預設值），則會擷取與最近或目前作業相關的詳細數據。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sqldb-instance-name

目標 SQL 資料庫 伺服器的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。