Share via

az datamigration sql-db

  • リファレンス

Note

このリファレンスは、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 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

datamigration sql-db の条件が満たされるまで、CLI を待機状態にします。

 拡張機能 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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--sqldb-instance-name

ターゲット SQL Database Server の名前。

--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 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 Database Server の名前。

--target-db-name

ターゲット データベースの名前です。

省略可能のパラメーター

--migration-service

移行サービスのリソース ID。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--scope

ターゲット リソース (SQL VM、SQL Managed Instance、または SQL DB) のリソース ID。

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

データ ソース: データ ソース。 authentication: 認証の種類。 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

データ ソース: データ ソース。 authentication: 認証の種類。 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

サブスクリプションの名前または 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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--sqldb-instance-name

ターゲット SQL Database Server の名前。

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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--migration-operation-id

オプションの移行操作 ID。 これが指定されている場合は、その ID の移行操作の詳細が取得されます。 指定しない場合 (既定値)、最新または現在の操作に関連する詳細が取得されます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--sqldb-instance-name

ターゲット SQL Database Server の名前。

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

datamigration sql-db の条件が満たされるまで、CLI を待機状態にします。

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]

例

datamigration sql-db が正常に作成されるまで、CLI スクリプトの次の行の実行を一時停止します。

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

datamigration sql-db が正常に削除されるまで、CLI スクリプトの次の行の実行を一時停止します。

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

省略可能のパラメーター

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

既定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

--deleted

削除されるまで待ちます。

既定値: False
--exists

リソースが存在するまで待ちます。

既定値: False
--expand

完全な移行の詳細が応答に含まれます。

--ids

1 つまたは複数のリソース 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 Database Server の名前。

--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 を使います。