Erstellen und Verwalten von Lesereplikaten in Azure Database for PostgreSQL – Flexibler Server über das Azure-Portal, die CLI oder die REST-API

GILT FÜR: Azure Database for PostgreSQL – Flexible Server

In diesem Artikel erfahren Sie, wie Sie Lesereplikate in Azure Database for PostgreSQL – Flexibler Server über das Azure-Portal, die Azure CLI und die REST-API erstellen und verwalten. Weitere Informationen zu Lesereplikaten finden Sie in der Übersicht.

Voraussetzungen

Eine Instanz von Azure Database for PostgreSQL – Flexibler Server, die als primärer Server fungiert.

Hinweis

Beim Bereitstellen von Lesereplikaten für persistente, sehr schreibintensive primäre Workloads kann sich die Replikation immer weiter verzögern, sodass der Stand des primären Servers möglicherweise gar nicht mehr erreicht wird. Dadurch kann auch die Speicherauslastung auf dem primären Server ansteigen, weil die WAL-Dateien nur gelöscht werden, sobald sie im Replikat empfangen wurden.

Überprüfen der primären Einstellungen

Stellen Sie vor dem Einrichten eines Lesereplikats für Azure Database for PostgreSQL – Flexibler Server sicher, dass der primäre Server so konfiguriert ist, dass er die erforderlichen Voraussetzungen erfüllt. Bestimmte Einstellungen auf dem primären Server können sich auf die Möglichkeit zum Erstellen von Replikaten auswirken.

Automatische Speichervergrößerung: Einstellungen für die automatische Speichervergrößerung auf dem primären Server und deren Lesereplikaten müssen spezifische Richtlinien einhalten, um Konsistenz zu gewährleisten und Replikationsunterbrechungen zu verhindern. Ausführliche Regeln und Einstellungen finden Sie unter Automatische Speichervergrößerung.

Premium SSD v2: Die aktuelle Version unterstützt keine Erstellung von Lesereplikaten für primäre Server mit Premium SSD v2-Speicher. Wenn Ihr Workload Lesereplikate erfordert, wählen Sie eine andere Speicheroption für den primären Server aus.

Portal

1. Wählen Sie im Azure-Portal die Instanz von Azure Database for PostgreSQL – Flexibler Server aus, die Sie für Ihr Replikat benötigen.

2. Beachten Sie im Dialogfeld Übersicht die PostgreSQL-Version (z. B. 15.4). Beachten Sie außerdem die Region, für die Ihr primäres System bereitgestellt wird (z. B. East US).

   

3. Wählen Sie auf der Randleiste des Servers unter Einstellungen die Option Compute + Speicher aus.

4. Überprüfen und beachten Sie die folgenden Einstellungen:

   • Computeebene, Prozessor, Größe (z. B. Standard_D4ads_v5).

   • Storage

     • Speichergröße (z. B. 128GB)
     • Automatische Vergrößerung

   • Hochverfügbarkeit

     • Aktiviert/Deaktiviert
     • Verfügbarkeitszoneneinstellungen

   • Sicherungseinstellungen

     • Beibehaltungsdauer
     • Redundanzoptionen

5. Wählen Sie unter Einstellungen die Option Netzwerk aus.

6. Informieren Sie sich über die Netzwerkeinstellungen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Hinweis

Die in diesem Handbuch genannten Befehle gelten für Azure CLI, Version 2.56.0 oder höher. Stellen Sie sicher, dass Sie die erforderliche Version oder eine neuere Version installiert haben, um diese Befehle erfolgreich ausführen zu können. Sie können Ihre aktuelle Azure CLI-Version überprüfen, indem Sie az --version in der Befehlszeilenschnittstelle ausführen. Um Azure CLI auf die neueste Version zu aktualisieren, befolgen Sie die Anweisungen in der Azure CLI-Dokumentation.

Verwenden Sie den Befehl az postgres flexible-server show, um die Konfiguration und den aktuellen Status einer Instanz von Azure PostgreSQL  – Flexibler Server anzuzeigen. Dieser Befehl liefert detaillierte Informationen zum angegebenen Server.

az postgres flexible-server show \
  --resource-group <resource-group> \
  --name <server-name>

Ersetzen Sie <resource-group> und <server-name> durch ihre spezifische Ressourcengruppe und den Namen des Servers, den Sie anzeigen möchten.

Überprüfen und beachten Sie die folgenden Einstellungen:

• Computeebene, Prozessor, Größe (z. B. Standard_D8ads_v5).
• Speicher
  • Typ
  • Speichergröße (z. B. 128)
  • autogrow
• Hochverfügbarkeit
  • Aktiviert/Deaktiviert
  • Verfügbarkeitszoneneinstellungen
• Sicherungseinstellungen
  • Beibehaltungsdauer
  • Redundanzoptionen

Beispiel für eine Antwort

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "authConfig": {
    "activeDirectoryAuth": "Disabled",
    "passwordAuth": "Enabled",
    "tenantId": null
  },
  "availabilityZone": "2",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2024-01-06T11:43:44.485537+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "createMode": null,
  "dataEncryption": {
    "geoBackupEncryptionKeyStatus": null,
    "geoBackupKeyUri": null,
    "geoBackupUserAssignedIdentityId": null,
    "primaryEncryptionKeyStatus": null,
    "primaryKeyUri": null,
    "primaryUserAssignedIdentityId": null,
    "type": "SystemManaged"
  },
  "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
  "highAvailability": {
    "mode": "Disabled",
    "standbyAvailabilityZone": null,
    "state": "NotEnabled"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
  "identity": null,
  "location": "East US",
  "maintenanceWindow": {
    "customWindow": "Disabled",
    "dayOfWeek": 0,
    "startHour": 0,
    "startMinute": 0
  },
  "minorVersion": "0",
  "name": "{serverName}",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "pointInTimeUtc": null,
  "privateEndpointConnections": null,
  "replica": {
    "capacity": 5,
    "promoteMode": null,
    "promoteOption": null,
    "replicationState": null,
    "role": "Primary"
  },
  "replicaCapacity": 5,
  "replicationRole": "Primary",
  "resourceGroup": "{resourceGroupName}",
  "sku": {
    "name": "Standard_D8ads_v5",
    "tier": "GeneralPurpose"
  },
  "sourceServerResourceId": null,
  "state": "Ready",
  "storage": {
    "autoGrow": "Disabled",
    "iops": 500,
    "storageSizeGb": 128,
    "throughput": null,
    "tier": "P10",
    "type": ""
  },
  "systemData": {
    "createdAt": "2023-11-08T11:27:48.972812+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": null,
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "tags": {},
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "16"
}

REST-API

Um Informationen zur Konfiguration eines Servers in Azure Database for PostgreSQL – Flexibler Server zu erhalten, insbesondere zum Anzeigen von Einstellungen für kürzlich eingeführte Features wie dem automatischen Vergrößern von Speicher oder privaten Verknüpfungen, sollten Sie die neueste API-Version 2023-06-01-preview verwenden. Die GET-Anforderung würde wie folgt formatiert werden:

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2023-06-01-preview

Ersetzen Sie {subscriptionId}, {resourceGroupName} und {serverName} durch Ihre Azure-Abonnement-ID, den Ressourcengruppennamen und den Namen des primären Servers, den Sie überprüfen möchten. Diese Anforderung gibt Ihnen Zugriff auf die Konfigurationsdetails Ihres primären Servers, sodass sichergestellt werden kann, dass er ordnungsgemäß für das Erstellen eines Lesereplikats eingerichtet ist.

Überprüfen und beachten Sie die folgenden Einstellungen:

• Computeebene, Prozessor, Größe (z. B. Standard_D8ads_v5).
• Speicher
  • Typ
  • Speichergröße (z. B. 128)
  • autogrow
• Network
• Hochverfügbarkeit
  • Aktiviert/Deaktiviert
  • Verfügbarkeitszoneneinstellungen
• Sicherungseinstellungen
  • Beibehaltungsdauer
  • Redundanzoptionen

Beispiel für eine Antwort

{
    "sku": {
        "name": "Standard_D8ads_v5",
        "tier": "GeneralPurpose"
    },
    "systemData": {
        "createdAt": "2023-11-22T16:11:42.2461489Z"
    },
    "properties": {
        "replica": {
            "role": "Primary",
            "capacity": 5
        },
        "storage": {
            "type": "",
            "iops": 500,
            "tier": "P10",
            "storageSizeGB": 128,
            "autoGrow": "Disabled"
        },
        "network": {
            "publicNetworkAccess": "Enabled"
        },
        "dataEncryption": {
            "type": "SystemManaged"
        },
        "authConfig": {
            "activeDirectoryAuth": "Disabled",
            "passwordAuth": "Enabled"
        },
        "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
        "version": "15",
        "minorVersion": "4",
        "administratorLogin": "myadmin",
        "state": "Ready",
        "availabilityZone": "1",
        "backup": {
            "backupRetentionDays": 7,
            "geoRedundantBackup": "Disabled",
            "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00"
        },
        "highAvailability": {
            "mode": "Disabled",
            "state": "NotEnabled"
        },
        "maintenanceWindow": {
            "customWindow": "Disabled",
            "dayOfWeek": 0,
            "startHour": 0,
            "startMinute": 0
        },
        "replicationRole": "Primary",
        "replicaCapacity": 5
    },
    "location": "East US",
    "tags": {},
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "name": "{serverName}",
    "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

Erstellen eines Lesereplikats

Führen Sie die folgenden Schritte aus, um ein Lesereplikat zu erstellen:

Portal

1. Wählen Sie eine vorhandene Instanz von Azure Database for PostgreSQL – Flexibler Server aus, die als primärer Server fungieren soll.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Wählen Sie Replikat erstellen aus.

   

4. Geben Sie im Formular „Grundlagen“ die folgenden Informationen ein.

   

5. Wählen Sie Überprüfen + erstellen aus, um die Erstellung des Replikats zu bestätigen, oder klicken Sie auf Weiter: Netzwerk, wenn Sie Firewallregeln hinzufügen, löschen oder ändern möchten.

   

6. Behalten Sie die übrigen Standardeinstellungen bei, und wählen Sie dann unten auf der Seite die Schaltfläche Überprüfen + erstellen aus, oder fahren Sie mit den nächsten Formularen fort, um Tags hinzuzufügen oder die Datenverschlüsselungsmethode zu ändern.

7. Überprüfen Sie die Informationen im abschließenden Bestätigungsfenster. Wählen Sie Erstellen aus, wenn Sie fertig sind. Eine neue Bereitstellung wird erstellt.

   

8. Während der Bereitstellung wird der primäre Status angezeigt in Updating.

   Nach der Erstellung des Lesereplikats wird dieses im Fenster Replikation angezeigt.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Mit dem Befehl az postgres flexible-server replica create können Sie ein Lesereplikat für Ihre Instanz von Azure PostgreSQL – Flexibler Server erstellen.

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Ersetzen Sie <replica-name>, <resource-group>, <source-server-name> und <location> durch Sie Ihre spezifischen Werte.

Nachdem das Lesereplikat erstellt wurde, können die Eigenschaften aller Server, die Replikate eines primären Replikats sind, mithilfe des Befehls az postgres flexible-server replica create abgerufen werden.

az postgres flexible-server replica list \
  --name <source-server-name> \
  --resource-group <resource-group>

Ersetzen Sie <source-server-name> und <resource-group> durch Ihre spezifischen Werte.

REST-API

Initiieren Sie eine HTTP PUT-Anforderung mithilfe der API zum Erstellen von Servern:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Hier müssen Sie {subscriptionId}, {resourceGroupName} und {replicaserverName} durch Ihre spezifische Azure-Abonnement-ID, den Namen Ihrer Ressourcengruppe und den gewünschten Namen für das Lesereplikat ersetzen.

{
  "location": "eastus",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

Nachdem das Lesereplikat erstellt wurde, können die Eigenschaften aller Server, die Replikate eines primären Replikats sind, durch Initiieren einer HTTP GET-Anforderung mithilfe der API zum Auflisten der Replikate nach Server abgerufen werden:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/replicas?api-version=2022-12-01

Hier müssen Sie {subscriptionId}, {resourceGroupName} und {sourceserverName} durch Ihre spezifische Azure-Abonnement-ID, den Namen Ihrer Ressourcengruppe bzw. den Namen, den Sie Ihrem primären Replikat zugewiesen haben, ersetzen.

[
  {
    "administratorLogin": null,
    "administratorLoginPassword": null,
    "authConfig": null,
    "availabilityZone": null,
    "backup": {
      "backupRetentionDays": null,
      "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "createMode": null,
    "dataEncryption": {
      "geoBackupEncryptionKeyStatus": null,
      "geoBackupKeyUri": null,
      "geoBackupUserAssignedIdentityId": null,
      "primaryEncryptionKeyStatus": null,
      "primaryKeyUri": null,
      "primaryUserAssignedIdentityId": null,
      "type": "SystemManaged"
    },
    "fullyQualifiedDomainName": null,
    "highAvailability": null,
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{replicaserverName}",
    "identity": null,
    "location": "eastus",
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "minorVersion": null,
    "name": "{replicaserverName}",
    "network": {
      "delegatedSubnetResourceId": null,
      "privateDnsZoneArmResourceId": null,
      "publicNetworkAccess": "Disabled"
    },
    "pointInTimeUtc": null,
    "privateEndpointConnections": null,
    "replica": {
      "capacity": null,
      "promoteMode": null,
      "promoteOption": null,
      "replicationState": "Active",
      "role": "AsyncReplica"
    },
    "replicaCapacity": null,
    "replicationRole": "AsyncReplica",
    "resourceGroup": "{resourceGroupName}",
    "sku": {
      "name": "",
      "tier": null
    },
    "sourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "iops": null,
      "storageSizeGb": 0,
      "throughput": null,
      "tier": null,
      "type": null
    },
    "systemData": {
      "createdAt": "2023-11-22T17:11:42.2461489Z",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": null,
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "tags": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers",
    "version": null
  }
]

• Legen Sie den Name des Replikatservers fest.

  Tipp

  Es handelt sich um eine bewährte Methode für das Cloud Adoption Framework (CAF), eine Ressourcennamenskonvention zu verwenden, mit der Sie ganz einfach bestimmen können, mit welcher Instanz Sie eine Verbindung herstellen oder verwalten und wo sie sich befindet.

• Wählen Sie einen anderen Speicherort als Ihre primäre Stelle aus, beachten Sie jedoch, dass Sie dieselbe Region auswählen können.

  Tipp

  Weitere Informationen zu den Regionen, in denen Sie ein Replikat erstellen können, finden Sie im Konzeptartikel zu Lesereplikaten.

• Stellen Sie die Rechen- und Speicherkapazität so ein, wie Sie sie von Ihrem primären System aufgezeichnet haben. Wenn die angezeigte Berechnung nicht übereinstimmt, wählen Sie Server konfigurieren aus, und wählen Sie die entsprechende aus.

  Hinweis

  Wenn Sie eine Computegröße auswählen, die kleiner als die primäre ist, schlägt die Bereitstellung fehl. Beachten Sie außerdem, dass die Computegröße möglicherweise nicht in einer anderen Region verfügbar ist.

  

Wichtig

Lesen Sie den Abschnitt „Überlegungen“ in der Übersicht über Lesereplikate.

Um Probleme beim Höherstufen von Replikaten zu vermeiden, ändern Sie die folgenden Serverparameter stets zuerst für die Replikate, bevor Sie sie auf den primären Server anwenden: max_connections, max_prepared_transactions, max_locks_per_transaction, max_wal_senders, max_worker_processes.

Erstellen virtueller Endpunkte

Hinweis

Alle Vorgänge, die virtuelle Endpunkte betreffen, etwa Hinzufügen, Bearbeiten oder Entfernen, werden im Kontext des primären Servers ausgeführt.

Portal

1. Wählen Sie im Azure-Portal den primären Server aus.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Wählen Sie Endpunkt erstellenaus.

4. Geben Sie im Dialogfeld einen aussagekräftigen Namen für Ihren Endpunkt ein. Beachten Sie den DNS-Endpunkt, der generiert wird.

   

5. Klicken Sie auf Erstellen.

   Hinweis

   Wenn Sie keinen virtuellen Endpunkt erstellen, erhalten Sie beim Versuch, eine Replikation zu erstellen, einen Fehler.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können einen virtuellen Endpunkt mithilfe des Befehls az postgres flexible-server virtual-endpoint create erstellen.

    az postgres flexible-server virtual-endpoint create \
      --resource-group <resource-group> \
      --server-name <primary-name> \
      --name <virtual-endpoint-name> \
      --endpoint-type ReadWrite \
      --members <replica-name>

Ersetzen Sie <resource-group>, <primary-name>, <virtual-endpoint-name> und <replica-name> durch Sie Ihre spezifischen Werte.

REST-API

Zum Erstellen eines virtuellen Endpunkts mithilfe der REST-API von Azure verwenden Sie eine HTTP PUT-Anforderung. Die Anforderung sieht wie folgt aus:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

Der zugehörige JSON-Text für diese Anforderung lautet wie folgt:

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

Hier sollte {replicaserverName} durch den Namen des Replikatservers ersetzt werden, den Sie als Leserendpunktziel in diesen virtuellen Endpunkt einschließen.

Auflisten virtueller Endpunkte

Führen Sie die folgenden Schritte aus, um virtuelle Endpunkte aufzulisten:

Portal

1. Wählen Sie im Azure-Portal den primären Server aus.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Oben auf der Seite werden sowohl die Lese- als auch die Schreibendpunkte angezeigt, zusammen mit den Namen der Server, auf die sie verweisen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können die Details des virtuellen Endpunkts entweder mit dem Befehl list oder dem Befehl show anzeigen. Da nur ein virtueller Endpunkt pro primärem Replikatpaar zulässig ist, ergeben beide Befehle das gleiche Ergebnis.

Im folgenden Beispiel wird die Verwendung des Befehls list veranschaulicht:

az postgres flexible-server virtual-endpoint list \
      --resource-group <resource-group> \
      --server-name <server-name>

Ersetzen Sie <server-name> durch den Namen des primären Servers und <resource-group> durch den Namen Ihrer Ressourcengruppe.

Sie können den Befehl show wie folgt verwenden:

az postgres flexible-server virtual-endpoint show \
      --name <virtual-endpoint-name>
      --resource-group <resource-group> \
      --server-name <server-name>

Ersetzen Sie in diesem Befehl <virtual-endpoint-name>, <server-name> und <resource-group> durch die entsprechenden Namen. <server-name> ist der Name des primären Servers.

REST-API

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints?api-version=2023-06-01-preview

Hier sollte {sourceserverName} der Name des primären Servers sein, von dem aus Sie die virtuellen Endpunkte verwalten.

Ändern von Anwendungen, um auf den virtuellen Endpunkt zu verweisen

Ändern Sie alle Anwendungen, die Ihre Instanz von Azure Database for PostgreSQL – Flexibler Server verwenden, sodass sie die neuen virtuellen Endpunkte verwenden (z. B. corp-pg-001.writer.postgres.database.azure.com und corp-pg-001.reader.postgres.database.azure.com).

Höherstufen von Replikaten

Wenn alle erforderlichen Komponenten vorhanden sind, können Sie ein Replikat in den primären Zustand versetzen.

Portal

Führen Sie die folgenden Schritte aus, um ein Replikat über das Azure-Portal höherzustufen:

1. Wählen Sie im Azure-Portal Ihre primäre Instanz von Azure Database for PostgreSQL – Flexibler Server aus.

2. Wählen Sie im Servermenü unter Einstellungen die Option Replikation aus.

3. Wählen Sie unter Server das Höher stufen-Symbol für das Replikat aus.

   

4. Stellen Sie im Dialogfeld sicher, dass die Aktion auf den primären Server heraufstufen ist.

5. Stellen Sie für die Datensynchronisierung sicher, dass Geplant – Daten vor höher stufen synchronisieren ausgewählt wird.

   

6. Wählen Sie Höher stufen aus, um mit dem Vorgang zu beginnen. Nach Abschluss des Vorgangs werden die Rollen umgekehrt: Das Replikat wird primär und das Primärsystem übernimmt die Rolle des Replikats.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Wenn Sie ein Replikat zu einem primären Server in Azure PostgreSQL – Flexibler Server höherstufen, verwenden Sie den Befehl az postgres flexible-server replica promote. Dieser Vorgang ist unerlässlich, um einen Replikationsserver zu einem primären Server höherzustufen und den derzeitigen primären Server in die Replikatrolle herabzustufen. Geben Sie --promote-mode switchover und --promote-option planned im Befehl an.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Ersetzen Sie <resource-group> und <replica-server-name> durch den Namen der jeweiligen Ressourcengruppe und des Replikatservers. Mit diesem Befehl wird ein reibungsloser und geplanter Übergang des Replikats zu einer primären Rolle sichergestellt.

REST-API

Verwenden Sie beim Höherstufen eines Replikats auf einen primären Server eine HTTP PATCH-Anforderung mit einem bestimmten JSON-Text, um die Optionen zum Höherstufen festzulegen. Dieser Vorgang ist entscheidend, wenn Sie einen Replikatserver auf einen primären Server höher stufen müssen.

Die HTTP-Anforderung ist wie folgt strukturiert:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

In diesem JSON-Code ist die Höherstufung für den switchover-Modus mit der Höherstufungsoption planned festgelegt. Auch wenn es zwei Optionen für die Höherstufung (planned oder forced) gibt, wählen Sie für diese Übung die Option planned aus.

Hinweis

Dem Replikat, das Sie höher stufen, muss der virtuelle Reader-Endpunkt zugewiesen sein, oder Sie erhalten eine Fehlermeldung bei der Höherstufung.

Testen von Anwendungen

Wenn Sie einige Vorgänge ausführen möchten, starten Sie Ihre Anwendungen neu, und versuchen Sie, diese Vorgänge auszuführen. Ihre Anwendungen sollten nahtlos funktionieren, ohne die Zeichenfolge der virtuellen Endpunktverbindung oder DNS-Einträge zu ändern. Lassen Sie Ihre Anwendungen dieses Mal laufen.

Failback auf den Ursprungsserver und die ursprüngliche Region

Wiederholen Sie die gleichen Vorgänge, um den Ursprungsserver auf den primären Server höher zu stufen.

Portal

1. Wählen Sie im Azure-Portal das folgende Replikat aus.

2. Wählen Sie auf der Randleiste des Servers unter Einstellungen die Option Replikation aus

3. Wählen Sie unter Server das Höher stufen-Symbol für das Replikat aus.

4. Stellen Sie im Dialogfeld sicher, dass die Aktion auf den primären Server heraufstufen ist.

5. Stellen Sie für die Datensynchronisierung sicher, dass Geplant – Daten vor höher stufen synchronisieren ausgewählt wird.

6. Wählen Sie Höher stufen aus, der Prozess beginnt. Nach Abschluss des Vorgangs werden die Rollen umgekehrt: Das Replikat wird primär und das Primärsystem übernimmt die Rolle des Replikats.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Ändern Sie dieses Mal den Parameter <replica-server-name> im Befehl az postgres flexible-server replica promote so, dass er auf Ihren alten primären Server verweist, der derzeit als Replikat fungiert, und führen Sie die Anforderung erneut aus.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

Ersetzen Sie <resource-group> und <replica-server-name> durch den Namen Ihrer spezifischen Ressourcengruppe bzw. den Namen des aktuellen Replikatservers.

REST-API

Ändern Sie dieses Mal den {replicaserverName} in der API-Anforderung so, dass er auf Ihren alten primären Server verweist, der derzeit als Replikat fungiert, und führen Sie die Anforderung erneut aus.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

In diesem JSON-Code ist die Höherstufung für den switchover-Modus mit der Höherstufungsoption planned festgelegt. Auch wenn es zwei Optionen für die Höherstufung (planned oder forced) gibt, wählen Sie für diese Übung die Option planned aus.

Testen von Anwendungen

Wechseln Sie erneut zu einer der verbrauchenden Anwendungen. Warten Sie, bis sich der primäre Status und der Replikatstatus zu Updating ändern und versuchen Sie dann, einige Vorgänge auszuführen. Während der Höherstufung des Replikats treten möglicherweise temporäre Konnektivitätsprobleme mit dem Endpunkt auf:

Sekundäres Lesereplikat hinzufügen

Erstellen Sie ein sekundäres Lesereplikat in einem separaten Bereich, um den virtuellen Reader-Endpunkt zu ändern und das Erstellen eines unabhängigen Servers aus dem ersten Replikat zu ermöglichen.

Portal

1. Wählen Sie im Azure-Portal die primäre Instanz von Azure Database for PostgreSQL – Flexibler Server aus.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Wählen Sie Replikat erstellen aus.

4. Geben Sie in das Formular Grundlagen mit Informationen in einem dritten Bereich ein (z. B. westus und corp-pg-westus-001)

5. Wählen Sie Überprüfen + erstellen aus, um die Erstellung des Replikats zu bestätigen, oder klicken Sie auf Weiter: Netzwerk, wenn Sie Firewallregeln hinzufügen, löschen oder ändern möchten.

6. Überprüfen der Firewalleinstellungen. Beachten Sie, dass die primären Einstellungen automatisch kopiert werden.

7. Behalten Sie die übrigen Standardeinstellungen bei, und wählen Sie dann unten auf der Seite die Schaltfläche Überprüfen + erstellen aus, oder fahren Sie mit den folgenden Formularen fort, um die Sicherheit zu konfigurieren oder Tags hinzuzufügen.

8. Überprüfen Sie die Informationen im abschließenden Bestätigungsfenster. Wählen Sie Erstellen aus, wenn Sie fertig sind. Eine neue Bereitstellung wird erstellt.

9. Während der Bereitstellung wird der primäre Status angezeigt in Updating.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können mit dem Befehl az postgres flexible-server replica create ein sekundäres Lesereplikat erstellen.

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

Wählen Sie einen eindeutigen Namen für den <replica-name> aus, um ihn vom primären Server und anderen Replikaten zu unterscheiden. Ersetzen Sie <resource-group>, <source-server-name> und <location> durch Ihre spezifischen Werte.

REST-API

Sie können mithilfe der API zum Erstellen von Servern ein sekundäres Lesereplikat erstellen:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Wählen Sie einen eindeutigen Namen für den {replicaserverName} aus, um ihn vom primären Server und anderen Replikaten zu unterscheiden.

{
  "location": "westus3",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

Der Standort ist auf westus3 festgelegt, Sie können die Einstellung jedoch basierend auf Ihren geografischen und betrieblichen Anforderungen anpassen.

Ändern des virtuellen Endpunkts

Portal

1. Wählen Sie im Azure-Portal die primäre Instanz von Azure Database for PostgreSQL – Flexibler Server aus.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Wählen Sie die Ellipsen und anschließend Bearbeiten aus.

   

4. Wählen Sie im Dialogfeld das neue sekundäre Replikat aus.

   

5. Wählen Sie Speichern. Der Leserendpunkt wird nun auf das sekundäre Replikat verwiesen, und der Vorgang zum Höherstufen ist jetzt an dieses Replikat gebunden.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können nun Ihren Leseendpunkt mit dem Befehl az postgres flexible-server virtual-endpoint update so ändern, dass er auf das neu erstellte sekundäre Replikat verweist. Denken Sie daran, <replica-name> durch den Namen des neu erstellten Lesereplikats zu ersetzen.

az postgres flexible-server virtual-endpoint update \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name> \
  --endpoint-type ReadWrite \
  --members <replica-name>

Ersetzen Sie <resource-group>, <server-name>, <virtual-endpoint-name> und <replica-name> durch Sie Ihre spezifischen Werte.

REST-API

Sie können nun Ihren Leseendpunkt über eine PATCH-Anforderung so ändern, dass er auf das neu erstellte sekundäre Replikat verweist. Denken Sie daran, {replicaserverName} durch den Namen des neu erstellten Lesereplikats zu ersetzen.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
} 

Höherstufen des Replikats auf unabhängigen Server

Anstatt zu einem Replikat zu wechseln, ist es auch möglich, die Replikation eines Replikats so zu unterbrechen, dass es zu seinem eigenständigen Server wird.

Portal

1. Wählen Sie im Azure-Portal den primärer Server für Azure Database for PostgreSQL – Flexibler Server aus.

2. Wählen Sie auf der Randleiste des Servers im Servermenü unter Einstellungen die Option Replikation aus.

3. Wählen Sie unter Server das Symbol Höher stufen für das Replikat aus, das Sie auf einen unabhängigen Server hochstufen möchten.

   

4. Stellen Sie im Dialogfeld sicher, dass die Aktion Auf einen unabhängigen Server hochstufen und aus der Replikation entfernen ist. Dies wirkt sich nicht auf den primären Server aus.

5. Stellen Sie für die Datensynchronisierung sicher, dass Geplant – Daten vor höher stufen synchronisieren ausgewählt wird.

   

6. Wählen Sie Höher stufen aus, der Prozess beginnt. Nach Abschluss des Vorgangs ist der Server kein Replikat des primären Systems mehr.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Wenn Sie ein Replikat in Azure PostgreSQL – Flexibler Server höherstufen, wird es standardmäßig auf einen unabhängigen Server höhergestuft. Die Höherstufung wird erreicht, indem der Befehl az postgres flexible-server replica promote ohne Angabe der Option --promote-mode verwendet wird, da der Modus standalone standardmäßig angenommen wird.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name>

Ersetzen Sie in diesem Befehl <resource-group> und <replica-server-name> durch den Namen Ihrer spezifischen Ressourcengruppe und den Namen des ersten erstellten Replikatservers, der nicht mehr Teil des virtuellen Endpunkts ist.

REST-API

Sie können ein Replikat mithilfe einer PATCH-Anforderung auf einen eigenständigen Server höher stufen. Senden Sie hierzu eine PATCH-Anforderung an die angegebene Azure Management-REST-API-URL mit dem ersten JSON-Text, wobei PromoteMode auf standalone und PromoteOption auf planned festgelegt ist. Das Format des zweiten JSON-Texts, in dem ReplicationRole auf None festgelegt wird, ist veraltet, wird hier jedoch aus Gründen der Abwärtskompatibilität erwähnt.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "standalone",
      "PromoteOption": "planned"
    }
  }
}

{
  "Properties": {
    "ReplicationRole": "None"
  }
}

Hinweis

Nachdem ein Replikat auf einen unabhängigen Server höhergestuft wurde, kann es nicht wieder zum Replikationssatz hinzugefügt werden.

Löschen virtueller Endpunkte

Portal

1. Wählen Sie im Azure-Portal den primären Server aus.

2. Wählen Sie auf der Seitenleiste des Servers unter Einstellungen die Option Replikation aus.

3. Suchen Sie oben auf der Seite den Abschnitt Virtual endpoints. Navigieren Sie neben dem Endpunktnamen zu den drei Punkten (Menüoptionen), erweitern Sie diese, und wählen Sie Delete aus.

4. Ein Bestätigungsdialogfeld für den Löschvorgang wird angezeigt. Es enthält die Warnung: „Mit dieser Aktion wird der virtuelle Endpunkt virtualendpointName gelöscht. Clients, die mit diesen Domänen verbunden sind, verlieren möglicherweise den Zugriff.“ Nehmen Sie die Auswirkungen zur Kenntnis, und bestätigen Sie den Vorgang, indem Sie auf Löschen klicken.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Um einen virtuellen Endpunkt aus einer Instanz von Azure PostgreSQL – Flexibler Server zu entfernen, können Sie den Befehl az postgres flexible-server virtual-endpoint delete verwenden. Mit dieser Aktion wird der angegebene virtuelle Endpunkt endgültig gelöscht.

az postgres flexible-server virtual-endpoint delete \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name>

Ersetzen Sie in diesem Befehl <resource-group>, <server-name> und <virtual-endpoint-name> durch Ihre spezifische Ressourcengruppe, den Servernamen und den Namen des virtuellen Endpunkts, den Sie löschen möchten.

REST-API

Um einen virtuellen Endpunkt mithilfe der REST-API von Azure zu löschen, stellen Sie eine HTTP DELETE-Anforderung. Die Anforderungs-URL ist wie folgt strukturiert:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{serverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

Löschen eines Replikats

Portal

Sie können ein Lesereplikat auf ähnliche Weise löschen wie eine eigenständige Instanz von Azure Database for PostgreSQL – Flexibler Server.

1. Öffnen Sie im Azure-Portal die Seite Übersicht für das Lesereplikat. Klicken Sie auf Löschen.

   

Sie können das Lesereplikat auch über das Fenster Replikation löschen, indem Sie folgendermaßen vorgehen:

2. Wählen Sie im Azure-Portal Ihre primäre Instanz von Azure Database for PostgreSQL – Flexibler Server aus.

3. Wählen Sie im Servermenü unter Einstellungen die Option Replikation aus.

4. Wählen Sie das zu löschende Lesereplikat und dann die Auslassungspunkte aus. Klicken Sie auf Löschen.

   

5. Bestätigen Sie den Löschvorgang.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Verwenden Sie den Befehl az postgres flexible-server delete, um einen primären Server oder einen Replikatserver zu löschen. Wenn der Server Lesereplikate enthält, sollten Sie die Lesereplikate zuerst löschen, bevor der primäre Server gelöscht wird.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Ersetzen Sie <resource-group> und <server-name> durch den Namen der Ressourcengruppe bzw. den Namen des Replikatservers, den Sie löschen möchten.

REST-API

Verwenden Sie zum Löschen eines primären Servers oder Replikatservers die API zum Löschen eines Servers. Wenn der Server Lesereplikate enthält, sollten die Lesereplikate zuerst gelöscht werden, bevor der primäre Server gelöscht wird.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

Löschen eines primären Servers

Sie können den primären Server erst löschen, wenn alle Lesereplikate gelöscht wurden. Befolgen Sie die Anweisungen im Abschnitt Löschen eines Replikats, um Replikate zu löschen, und fahren Sie dann mit den angegebenen Schritten fort.

Portal

Um einen Server über das Azure-Portal zu löschen, gehen Sie folgendermaßen vor:

1. Wählen Sie im Azure-Portal Ihre primäre Instanz von Azure Database for PostgreSQL – Flexibler Server aus.

2. Öffnen Sie die Seite Übersicht für den Server, und wählen Sie Löschen aus.

   

3. Geben Sie den Namen des zu löschenden primären Servers ein. Wählen Sie Löschen aus, um das Löschen des primären Servers zu bestätigen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Verwenden Sie den Befehl az postgres flexible-server delete, um einen primären Server oder einen Replikatserver zu löschen. Wenn der Server Lesereplikate enthält, sollten die Lesereplikate zuerst gelöscht werden, bevor der primäre Server gelöscht wird.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

Ersetzen Sie <resource-group> und <server-name> durch den Namen Ihrer Ressourcengruppe bzw. den Namen des primären Servers, den Sie löschen möchten.

REST-API

Verwenden Sie zum Löschen eines primären Servers oder Replikatservers die API zum Löschen eines Servers. Wenn der Server Lesereplikate enthält, sollten die Lesereplikate zuerst gelöscht werden, bevor der primäre Server gelöscht wird.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}?api-version=2022-12-01

Überwachen eines Replikats

Für die Überwachung von Lesereplikaten stehen zwei Metriken zur Verfügung.

Maximale Verzögerung physischer Replikationen

Nur auf dem primären Server verfügbar.

Die Metrik Maximale Verzögerung physischer Replikationen zeigt die Byteverzögerung zwischen dem primären Server und dem Replikat mit der größten Verzögerung.

1. Wählen Sie im Azure-Portal den primären Server aus.

2. Klicken Sie auf Metriken. Wählen Sie im Fenster Metriken die Option Maximale Verzögerung physischer Replikationen aus.

   

3. Wählen Sie für Ihre Aggregation den Wert Max aus.

Metrik „Lesereplikatverzögerung“

Die Metrik Lesereplikatverzögerung zeigt die Zeit seit der letzten wiedergegebenen Transaktion auf einem Replikat an. Wenn auf dem primären Server keine Transaktionen stattfinden, gibt die Metrik diese Verzögerungszeit wieder. Wenn beispielsweise auf Ihrem primären Server keine Transaktionen ausgeführt werden und die letzte Transaktion vor 5 Sekunden wiedergegeben wurde, zeigt die Lesereplikatverzögerung eine Verzögerung von 5 Sekunden an.

1. Wählen Sie im Azure-Portal das Lesereplikat aus.

2. Klicken Sie auf Metriken. Wählen Sie im Fenster Metriken die Option Lesereplikatverzögerung aus.

   

3. Wählen Sie für Ihre Aggregation den Wert Max aus.

Zugehöriger Inhalt

• Lesereplikate in Azure Database for PostgreSQL – Flexible Server