az postgres flexible-server migration

コマンド

名前	説明	型	状態
az postgres flexible-server migration check-name-availability	指定された移行名を使用できるかどうかを確認します。	コア	GA
az postgres flexible-server migration create	フレキシブル サーバー用の新しい移行ワークフローを作成します。	コア	GA
az postgres flexible-server migration list	フレキシブル サーバーの移行を一覧表示します。	コア	GA
az postgres flexible-server migration show	特定の移行の詳細を取得します。	コア	GA
az postgres flexible-server migration update	特定の移行を更新します。	コア	GA

az postgres flexible-server migration check-name-availability --migration-name
                                                              [--ids]
                                                              [--name]
                                                              [--resource-group]
                                                              [--subscription]

例

指定された移行名が移行ワークフローで使用できるかどうかを確認します。

az postgres flexible-server migration check-name-availability --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--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 postgres flexible-server migration create --name
                                             --properties
                                             --resource-group
                                             [--location]
                                             [--migration-mode {offline, online}]
                                             [--migration-name]
                                             [--migration-option {Migrate, Validate, ValidateAndMigrate}]
                                             [--tags]

例

パラメーターによって識別されるターゲット サーバーで移行ワークフローを開始します。 移行の構成は、プロパティ ファイルで指定する必要があります。 さまざまなプロパティは、sourceDbServerResourceId: ソース サーバーの詳細として定義されます。 adminCredentials: このパラメーターは、ソース サーバーとターゲット PostgreSQL フレキシブル サーバーの両方の管理者ユーザーのパスワードを一覧表示します。 targetServerUserName: 既定値は PostgreSQL ターゲット フレキシブル サーバーの作成時に作成された管理者ユーザーであり、指定されたパスワードはこのユーザーに対する認証に使用されます。 dbsToMigrate: フレキシブル サーバーに移行するデータベースの一覧を指定します。 overwriteDBsInTarget: true (既定値) に設定すると、移行しようとしているデータベースと同じ名前の既存のデータベースがターゲット サーバーに存在する場合、移行サービスによってデータベースが自動的に上書きされます。 PostgreSQLSingleServer のサンプル migrationConfig.jsonを次に示します。 { "properties": { "sourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "secretParameters": { "adminCredentials": { "sourceServerPassword": "password", "targetServerPassword": "password" }, "sourceServerUserName": "testuser@pg-single-1", "targetServerUserName": "fspguser" }, "dBsToMigrate": [ "postgres" ], "overwriteDbsInTarget": "true" }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json"

パラメーターによって識別されるターゲット サーバーで移行ワークフローを開始します。 移行の構成は、migrationConfig.json ファイルで指定する必要があります。 オフライン移行には --migration-mode をオフラインで使用します。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode offline

パラメーターによって識別されるターゲット サーバーで移行ワークフローを開始します。 移行の構成は、migrationConfig.json ファイルで指定する必要があります。 --migration-mode online for Online (with CDC) migration を使用します。 migration-option Validate for validate only request を使用します。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode online --migration-option Validate

パラメーターによって識別されるターゲット サーバーで移行ワークフローを開始します。 移行の構成は、migrationConfig.json ファイルで指定する必要があります。 --migration-option Migrate for Migrate only request を使用します。

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-option Migrate

PostgreSQLSingleServer 以外の移行を開始するには、プロパティ ファイルで soureType と sslMode を指定する必要があります。 これらのプロパティは、sourceType: 値として定義されます。値は、オンプレミス、AWS_RDS、AzureVM、PostgreSQLSingleServer sslMode: 移行用の SSL モードです。 PostgreSQLSingleServer の SSL モードは VerifyFull であり、他のソースの種類の場合は Prefer/Require です。 サンプル migrationConfig.jsonを次に示します。 { "properties": { "sourceDBServerResourceId": "<c0/><c1/><c2/>>:<c3/><c4/><c5/><c6/><c7/><c8/><c9/>>", "secretParameters": { "adminCredentials": { "sourceServerPassword": "password", "targetServerPassword": "password" }, "sourceServerUserName": "postgres", "targetServerUserName": "fspguser" }, "dBsToMigrate": [ "ticketdb","timedb","inventorydb" ], "overwriteDbsInTarget": "true", "sourceType": "OnPremises", "sslMode": "Prefer" }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver         --migration-name testmigration --properties "migrationConfig.json"

プロパティ ファイルで migrationRuntimeResourceId を指定して、ターゲット サーバーでプライベート エンドポイントが有効な移行ワークフローを開始します。 このプロパティは、migrationRuntimeResourceId: ソースとターゲット サーバーの間でデータを移行する移行ランタイム サーバーのリソース ID として定義されます。 サンプル migrationConfig.jsonを次に示します。 { "properties": { "sourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "migrationRuntimeResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/testsourcemigration", "secretParameters": { "adminCredentials": { "sourceServerPassword": "password", "targetServerPassword": "password" }, "sourceServerUserName": "testuser@pg-single-1", "targetServerUserName": "fspguser" }, "dBsToMigrate": [ "postgres" ], "overwriteDbsInTarget": "true" } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --properties "migrationConfig.json"

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--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 postgres flexible-server migration list --name
                                           --resource-group
                                           [--filter {Active, All}]

例

ターゲット フレキシブル サーバーの現在アクティブな移行を一覧表示します。

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter Active

ターゲット フレキシブル サーバーのすべての (アクティブ/完了) 移行を一覧表示します。

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter All

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--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 postgres flexible-server migration show --migration-name
                                           [--ids]
                                           [--name]
                                           [--resource-group]
                                           [--subscription]

例

ターゲット フレキシブル サーバーの特定の移行の詳細を取得します。

az postgres flexible-server migration show --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

--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 postgres flexible-server migration update --migration-name
                                             [--cancel]
                                             [--cutover]
                                             [--ids]
                                             [--name]
                                             [--resource-group]
                                             [--setup-replication]
                                             [--subscription]

例

移行ワークフローでソースに論理レプリケーションをセットアップできるようにします。 このコマンドを実行すると、ソース サーバーが再起動されることに注意してください。

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --setup-replication

移行に関係するすべてのデータベースのデータ移行をカットオーバーします。 これが完了すると、移行内のすべてのデータベースに対する後続の更新はターゲットに移行されません。 カットオーバー移行は、migration_mode=Online に対してのみトリガーできます。

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cutover

移行に関係するすべてのデータベースのデータ移行を取り消します。 'InProgress' の移行のみを取り消すことができます

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cancel

必須のパラメーター

省略可能のパラメーター

グローバル パラメーター

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