az postgres flexible-server migration

  • リファレンス

PostgreSQL フレキシブル サーバーの移行ワークフローを管理します。

コマンド

名前 説明 型 状態
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

指定された移行名を使用できるかどうかを確認します。

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

必須のパラメーター

--migration-name

移行の名前。

省略可能のパラメーター

--ids

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

--name -n

移行ターゲット サーバー名。

--resource-group -g

移行ターゲット サーバーのリソース グループ名。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--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

フレキシブル サーバー用の新しい移行ワークフローを作成します。

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"

必須のパラメーター

--name -n

移行ターゲット サーバー名。

--properties -b

要求プロパティ。 json ファイルパスを引数として渡すには、二重引用符または引用符を使用しません。

--resource-group -g

移行ターゲット サーバーのリソース グループ名。

省略可能のパラメーター

--location -l

Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--migration-mode

オフラインまたはオンライン (CDC あり) の移行。

指定可能な値: offline, online
規定値: offline
--migration-name

移行の名前。

--migration-option

サポートされている移行オプション。 既定値は ValidateAndMigrate です。

指定可能な値: Migrate, Validate, ValidateAndMigrate
規定値: ValidateAndMigrate
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

グローバル パラメーター
--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

フレキシブル サーバーの移行を一覧表示します。

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

必須のパラメーター

--name -n

サーバーの名前。 名前に含めることができるのは、英小文字、数字、ハイフン (-) のみです。 3 文字以上、最大 63 文字。

--resource-group -g

移行ターゲット サーバーのリソース グループ名。

省略可能のパラメーター

--filter

すべての移行が返されるか、アクティブな移行だけが返されるかを示します。 有効な値は、Active と All です。

指定可能な値: Active, All
規定値: Active
グローバル パラメーター
--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

特定の移行の詳細を取得します。

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

必須のパラメーター

--migration-name

移行の名前。

省略可能のパラメーター

--ids

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

--name -n

移行ターゲット サーバー名。

--resource-group -g

移行ターゲット サーバーのリソース グループ名。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--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

特定の移行を更新します。

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

必須のパラメーター

--migration-name

移行の名前。

省略可能のパラメーター

--cancel

すべてのデータベースのデータ移行をキャンセルします。

--cutover

移行内のすべてのデータベースのデータ移行をカットオーバーします。 この完了後、すべてのデータベースに対する後続の更新はターゲットに移行されません。

--ids

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

--name -n

移行ターゲット サーバー名。

--resource-group -g

移行ターゲット サーバーのリソース グループ名。

--setup-replication

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

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--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 を使います。