az postgres flexible-server migration
PostgreSQL フレキシブル サーバーの移行ワークフローを管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az postgres flexible-server migration check-name-availability |
指定された移行名を使用できるかどうかを確認します。 |
Core | GA |
az postgres flexible-server migration create |
フレキシブル サーバー用の新しい移行ワークフローを作成します。 |
Core | GA |
az postgres flexible-server migration list |
フレキシブル サーバーの移行を一覧表示します。 |
Core | GA |
az postgres flexible-server migration show |
特定の移行の詳細を取得します。 |
Core | GA |
az postgres flexible-server migration update |
特定の移行を更新します。 |
Core | 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
必須のパラメーター
移行の名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバー名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバーのリソース グループ名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
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: 値は、OnPremises、AWS_AURORA、AWS_RDS、AzureVM、PostgreSQLSingleServer sslMode: 移行用の SSL モードです。 PostgreSQLSingleServer の SSL モードは VerifyFull であり、他のソースの種類の場合は Prefer/Require です。 サンプル migrationConfig.json を次に示します。 { "properties": { "sourceDBServerResourceId": "<<hostname or IP address>>:<<port>>@<<username>>", "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"
必須のパラメーター
移行ターゲット サーバー名。
Request properties. json ファイルパスを引数として渡すには、二重引用符または引用符を使用しません。
移行ターゲット サーバーのリソース グループ名。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Location. 値のソース: az account list-locations
az configure --defaults location=<location>
を使用して、既定の場所を構成できます。
オフラインまたはオンライン (CDC あり) の移行。
プロパティ | 値 |
---|---|
規定値: | offline |
指定可能な値: | offline, online |
移行の名前。
サポートされている移行オプション。 既定値は ValidateAndMigrate です。
プロパティ | 値 |
---|---|
規定値: | ValidateAndMigrate |
指定可能な値: | Migrate, Validate, ValidateAndMigrate |
スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
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
必須のパラメーター
サーバーの名前。 名前に含めることができるのは、英小文字、数字、ハイフン (-) のみです。 3 文字以上、最大 63 文字。
移行ターゲット サーバーのリソース グループ名。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
すべての移行が返されるか、アクティブな移行だけが返されるかを示します。 有効な値は、Active と All です。
プロパティ | 値 |
---|---|
規定値: | Active |
指定可能な値: | Active, All |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
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
必須のパラメーター
移行の名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバー名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバーのリソース グループ名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
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
必須のパラメーター
移行の名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
すべてのデータベースのデータ移行をキャンセルします。
移行内のすべてのデータベースのデータ移行をカットオーバーします。 この完了後、すべてのデータベースに対する後続の更新はターゲットに移行されません。
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバー名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ターゲット サーバーのリソース グループ名。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
移行ワークフローでソースに論理レプリケーションをセットアップできるようにします。 このコマンドを実行すると、ソース サーバーが再起動されることに注意してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |