az postgres flexible-server migration

  • Referenz

Verwalten Sie Migrationsworkflows für flexible Server von PostgreSQL.

Befehle

Name Beschreibung Typ Status
az postgres flexible-server migration check-name-availability

Überprüft, ob der bereitgestellte Migrationsname verwendet werden kann.

 Core Allgemein verfügbar
az postgres flexible-server migration create

Erstellen Sie einen neuen Migrationsworkflow für einen flexiblen Server.

 Core Allgemein verfügbar
az postgres flexible-server migration list

Listen Sie die Migrationen eines flexiblen Servers auf.

 Core Allgemein verfügbar
az postgres flexible-server migration show

Rufen Sie die Details einer bestimmten Migration ab.

 Core Allgemein verfügbar
az postgres flexible-server migration update

Aktualisieren sie eine bestimmte Migration.

 Core Allgemein verfügbar

az postgres flexible-server migration check-name-availability

Überprüft, ob der bereitgestellte Migrationsname verwendet werden kann.

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

Beispiele

Überprüfen Sie, ob der bereitgestellte Migrationsname für Ihren Migrationsworkflow verfügbar ist.

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

Erforderliche Parameter

--migration-name

Name der Migration.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Migrationszielservers.

--resource-group -g

Ressourcengruppenname des Migrationszielservers.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az postgres flexible-server migration create

Erstellen Sie einen neuen Migrationsworkflow für einen flexiblen Server.

az postgres flexible-server migration create --name
                                             --properties
                                             --resource-group
                                             [--location]
                                             [--migration-mode {offline, online}]
                                             [--migration-name]
                                             [--migration-option {Migrate, Validate, ValidateAndMigrate}]
                                             [--tags]

Beispiele

Starten Sie einen Migrationsworkflow auf dem Zielserver, der durch die Parameter identifiziert wird. Die Konfigurationen der Migration sollten in der Datei "migrationConfig.json" angegeben werden. Verwenden Sie den Offlinemodus für die Offlinemigration. BeispielmigrationConfig.json sieht wie folgt aus: { "properties": { "SourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xx/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", "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

Starten Sie einen Migrationsworkflow auf dem Zielserver, der durch die Parameter identifiziert wird. Die Konfigurationen der Migration sollten in der Datei "migrationConfig.json" angegeben werden. Verwenden Sie den --Migrationsmodus online für online(mit CDC)-Migration, mit diesem Beispiel "migrationConfig.json". Verwenden Sie die Migrationsoption "Validate for validate only request" { "properties": { "SourceDBServerResourceId": "/subscriptions/xxxxxx-xxxx-xxxx-xxxx-xx/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" } } The sourceType and sslmode parameters are automatically set to 'PostgreSQL Single server' bzw. 'VerifyFull', wenn die Quellressourcen-ID auf die /subscriptions/xx-xxxx-xxxx-xxxx-xxxx/resourceGroups/{rg-name}/providers/Microsoft.DBforPostgreSQL/servers/{single-server-name} Servermuster folgt. Alle werte, die in der CLI/SDK für diese Parameter übergeben werden, werden ignoriert.

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

Starten Sie einen Migrationsworkflow auf dem Zielserver, der durch die Parameter identifiziert wird. Die Konfigurationen der Migration sollten in der Datei "migrationConfig.json" angegeben werden. Verwenden Sie "--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

Die Standardmigrationsoption ist ValidateAndMigrate. SoureType und SslMode müssen für andere Migrationen als PostgreSQLSingleServer übergeben werden. Migrationsparameter in json-Datei sollten wie folgt aussehen: { "properties": { "SourceDBServerResourceId": "20.66.25.58:5432@postgres", "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"

Erforderliche Parameter

--name -n

Name des Migrationszielservers.

--properties -b

Anforderungseigenschaften. Verwenden Sie doppelte oder keine Anführungszeichen, um json filepath als Argument zu übergeben.

--resource-group -g

Ressourcengruppenname des Migrationszielservers.

Optionale Parameter

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--migration-mode

Entweder offline oder online(mit CDC)-Migration.

Zulässige Werte: offline, online
Standardwert: offline
--migration-name

Name der Migration.

--migration-option

Unterstützte Migrationsoption. Der Standardwert ist ValidateAndMigrate.

Zulässige Werte: Migrate, Validate, ValidateAndMigrate
Standardwert: ValidateAndMigrate
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az postgres flexible-server migration list

Listen Sie die Migrationen eines flexiblen Servers auf.

az postgres flexible-server migration list --name
                                           --resource-group
                                           [--filter {Active, All}]

Beispiele

Auflisten der derzeit aktiven Migrationen eines flexiblen Zielservers.

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

Auflisten aller (Active/Completed)-Migrationen eines flexiblen Zielservers.

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

Erforderliche Parameter

--name -n

Name des Servers. Der Name darf nur aus Kleinbuchstaben, Zahlen und Bindestrichen (-) bestehen. Mindestens 3 Zeichen und maximal 63 Zeichen.

--resource-group -g

Ressourcengruppenname des Migrationszielservers.

Optionale Parameter

--filter

Gibt an, ob alle Migrationen oder nur die aktiven Migrationen zurückgegeben werden. Gültige Werte sind: "Aktiv" und "Alle".

Zulässige Werte: Active, All
Standardwert: Active
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az postgres flexible-server migration show

Rufen Sie die Details einer bestimmten Migration ab.

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

Beispiele

Rufen Sie die Details einer bestimmten Migration eines flexiblen Zielservers ab.

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

Erforderliche Parameter

--migration-name

Name der Migration.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Migrationszielservers.

--resource-group -g

Ressourcengruppenname des Migrationszielservers.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az postgres flexible-server migration update

Aktualisieren sie eine bestimmte Migration.

az postgres flexible-server migration update --migration-name
                                             [--cancel]
                                             [--cutover]
                                             [--ids]
                                             [--name]
                                             [--resource-group]
                                             [--setup-replication]
                                             [--subscription]

Beispiele

Zulassen, dass der Migrationsworkflow die logische Replikation auf der Quelle einrichten kann. Beachten Sie, dass dieser Befehl den Quellserver neu startet.

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

Übernahme der Datenmigration für alle Datenbanken, die an der Migration beteiligt sind. Nachdem dies abgeschlossen ist, werden nachfolgende Aktualisierungen aller Datenbanken in der Migration nicht zum Ziel migriert. Die Übernahmemigration kann nur für migration_mode=Online ausgelöst werden.

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

Bricht die Datenmigration für alle Datenbanken ab, die an der Migration beteiligt sind. Es kann nur die Migration "InProgress" abgebrochen werden.

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

Erforderliche Parameter

--migration-name

Name der Migration.

Optionale Parameter

--cancel

Abbrechen der Datenmigration für alle Datenbanken.

--cutover

Übernahme der Datenmigration für alle Datenbanken in der Migration. Nachdem dies abgeschlossen ist, werden nachfolgende Aktualisierungen aller Datenbanken nicht zum Ziel migriert.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Migrationszielservers.

--resource-group -g

Ressourcengruppenname des Migrationszielservers.

--setup-replication

Zulassen, dass der Migrationsworkflow die logische Replikation auf der Quelle einrichten kann. Beachten Sie, dass dieser Befehl den Quellserver neu startet.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.