az postgres flexible-server migration

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

コマンド

名前	説明	型	Status
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]

例

パラメーターによって識別されるターゲット サーバーで移行ワークフローを開始します。 移行の構成は、migrationConfig.json ファイルで指定する必要があります。 オフライン移行には --migration-mode をオフラインで使用します。 サンプル migrationConfig.jsonは次のようになります。 { "properties": { "SourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "SecretParameters": { "管理Credentials": { "SourceServerPassword": "password", "TargetServerPassword": "password" }, "SourceServerUserName": "testuser@pg-single-1", "TargetServerUserName": "fspguser" }, "dBsToMigrate": [ "postgres" ], "OverwriteDbsInTarget": "true", "SourceType": "PostgreSQLSingleServer", "SslMode": "VerifyFull" } }

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 ファイルで指定する必要があります。 このサンプル migrationConfig.jsonでは、--migration-mode online for Online (cdc) 移行に使用します。 migration-option Validate for validate only request { "properties": { "SourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "SecretParameters": { "管理Credentials": { "SourceServerPassword": "password", "TargetServerPassword": "password" }, "SourceServerUserName": "testuser@pg-single-1", "TargetServerUserName": "fspguser" }, "dBsToMigrate": [ "postgres" ], "OverwriteDbsInTarget": "true" } } ソース リソース ID が /subscriptions/xxxxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/{rg-name}/providers/Microsoft.DBforPostgreSQL/servers/{single-server-name} サーバー パターンに従っている場合、sourceType パラメーターと sslmode パラメーターはそれぞれ 'PostgreSQL Single server' と 'VerifyFull' に自動的に設定されます。 これらのパラメーターに対して CLI/SDK で渡されるすべての値は無視されます。

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

既定の移行オプションは ValidateAndMigrate です。 PostgreSQLSingleServer 以外の移行では、SoureType と SslMode を渡す必要があります。 json ファイルの移行パラメーターは次のようになります。 { "properties": { "SourceDBServerResourceId": "20.66.25.58:5432@postgres", "SecretParameters": { "管理Credentials": { "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"

必須のパラメーター

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