Freigeben über


az postgres flexible-server replica

Verwalten von Lesereplikaten.

Befehle

Name Beschreibung Typ Status
az postgres flexible-server replica create

Erstellen Sie ein Lesereplikat für einen Server.

Core GA
az postgres flexible-server replica list

Listet alle lesereplikate für einen bestimmten Server auf.

Core GA
az postgres flexible-server replica promote

Beenden Sie die Replikation eines Lesereplikats, und stufen Sie es auf einen unabhängigen Server oder als primärer Server höher.

Core GA

az postgres flexible-server replica create

Erstellen Sie ein Lesereplikat für einen Server.

az postgres flexible-server replica create --replica-name
                                           --resource-group
                                           --source-server
                                           [--address-prefixes]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

Beispiele

Erstellen Sie ein Lesereplikat "testreplicaserver" für "testserver" mit öffentlichem oder privatem Zugriff in der angegebenen Zone und am angegebenen Speicherort, falls verfügbar.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --zone 3 --location testLocation

Erstellen Sie ein Lesereplikat "testreplicaserver" mit neuem Subnetz für "testserver" mit privatem Zugriff.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com \
  --tags "key=value"

Erstellen Sie ein Lesereplikat "testreplicaserver" für "testserver" mit öffentlichem oder privatem Zugriff am angegebenen Speicherort, falls verfügbar. Da die Zone nicht übergeben wird, nimmt sie automatisch die Zone am Replikatspeicherort auf, die sich von dem Quellserver unterscheidet, sofern verfügbar, andernfalls wird die Zone wie der Quellserver am Replikatspeicherort verwendet, falls verfügbar, andernfalls wird die Zone als "Keine" festgelegt, d. h. keine Einstellung.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --location testLocation

Erstellen Sie ein Lesereplikat "testreplicaserver" für "testserver" mit benutzerdefinierter --storage-size und --sku.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

Erstellen Sie ein Lesereplikat "testreplicaserver" für "testserver", wobei sich "testreplicaserver" in einer anderen Ressourcengruppe "newTestGroup" befindet. Hier --resource-group ist für die Ressourcengruppe des Lesereplikats, und --source-server muss als Ressourcen-ID übergeben werden.

az postgres flexible-server replica create --replica-name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName} --location testLocation

Erforderliche Parameter

--replica-name

Der Name des Servers, auf dem wiederhergestellt werden soll.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--source-server

Der Name oder die Ressourcen-ID des Quellservers, aus dem wiederhergestellt werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--address-prefixes

Das IP-Adresspräfix, das beim Erstellen eines neuen virtuellen Netzwerks im CIDR-Format verwendet werden soll. Der Standardwert ist 10,0,0,0/16.

--identity

Der Name oder die Ressourcen-ID der vom Benutzer zugewiesenen Identität für die Datenverschlüsselung.

--key

Die Ressourcen-ID des Primärschlüsselschlüssels für die Datenverschlüsselung.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--performance-tier

Leistungsebene des Servers.

--private-dns-zone

Dieser Parameter gilt nur für einen Server mit privatem Zugriff. Der Name oder die ID der neuen oder vorhandenen privaten DNS-Zone. Sie können die private DNS-Zone aus derselben Ressourcengruppe, einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden. Wenn Sie eine Zone aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie bitte die Ressourcen-ID an. CLI erstellt eine neue private DNS-Zone innerhalb derselben Ressourcengruppe wie das virtuelle Netzwerk, wenn sie nicht von Benutzern bereitgestellt wird.

--sku-name

Der Name der Compute-SKU. Folgt der Konvention Standard_{VM name}. Beispiele: Standard_B1ms.

--storage-size

Die Speicherkapazität des Servers. Der Mindestwert beträgt 32 GiB und max. 16 TiB.

--subnet

Name oder Ressourcen-ID eines neuen oder vorhandenen Subnetzes. Wenn Sie ein Subnetz aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie die Ressourcen-ID anstelle des Namens an. Bitte beachten Sie, dass das Subnetz an flexibleServer delegiert wird. Nach der Delegierung kann dieses Subnetz nicht für andere Arten von Azure-Ressourcen verwendet werden.

--subnet-prefixes

Das Subnetz-IP-Adresspräfix, das beim Erstellen eines neuen Subnetzes im CIDR-Format verwendet werden soll. Der Standardwert ist 10,0,0,0/24.

--tags

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

--tier

Computeebene des Servers. Akzeptierte Werte: Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Name oder ID eines neuen oder vorhandenen virtuellen Netzwerks. Wenn Sie ein vnet aus einer anderen Ressourcengruppe oder einem anderen Abonnement verwenden möchten, geben Sie bitte eine Ressourcen-ID an. Der Name muss zwischen 2 und 64 Zeichen bestehen. Der Name muss mit einem Buchstaben oder einer Zahl beginnen, mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und darf nur Buchstaben, Zahlen, Unterstriche, Punkte oder Bindestriche enthalten.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
--zone -z

Verfügbarkeitszone, in der die Ressource bereitgestellt werden soll.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az postgres flexible-server replica list

Listet alle lesereplikate für einen bestimmten Server auf.

az postgres flexible-server replica list --name
                                         --resource-group

Beispiele

Listet alle Lesereplikate für den Masterserver "testserver" auf.

az postgres flexible-server replica list -g testGroup -n testserver

Erforderliche Parameter

--name -n

Name des Quellservers.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az postgres flexible-server replica promote

Beenden Sie die Replikation eines Lesereplikats, und stufen Sie es auf einen unabhängigen Server oder als primärer Server höher.

az postgres flexible-server replica promote [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

Beispiele

Beenden Sie die Replikation auf "testreplicaserver" und höherstufen Sie sie als eigenständigen Lese-/Schreibserver.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver

Beenden Sie die Replikation auf "testreplicaserver", und fördern Sie sie mit erzwungener Datensynchronisierung als eigenständigen Lese-/Schreibserver.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode standalone --promote-option forced

Beenden Sie die Replikation auf "testreplicaserver", und fördern Sie sie mit geplanter Datensynchronisierung auf den primären Server. Das Replikat, das Sie bewerben, muss der virtuelle Reader-Endpunkt zugewiesen sein, oder Sie erhalten eine Fehlermeldung bei der Heraufstufung.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode switchover --promote-option planned

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine 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.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name des Servers. Der Name kann nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Mindestens 3 Zeichen und maximal 63 Zeichen.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--promote-mode

Gibt an, ob Lesereplikate auf einen unabhängigen Server heraufstufen oder als Primärserver höher stufen sollen.

Eigenschaft Wert
Standardwert: standalone
Zulässige Werte: standalone, switchover
--promote-option

Unabhängig davon, ob Daten synchronisiert werden sollen, bevor Sie das Lesereplikat höher stufen oder so schnell wie möglich höher stufen.

Eigenschaft Wert
Standardwert: planned
Zulässige Werte: forced, planned
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False