Mit der regionsübergreifenden Replikation arbeiten

Auf dieser Seite wird beschrieben, wie Sie die regionenübergreifende Replikation verwenden, indem Sie sekundäre Cluster erstellen und damit arbeiten.

Eine konzeptionelle Übersicht über die regionenübergreifende Replikation finden Sie unter Regionenübergreifende Replikation.

Hinweis: Sie können erweiterte Query Insights-Funktionen für AlloyDB nicht auf Instanzen in replikationsübergreifenden Clustern aktivieren. Weitere Informationen finden Sie unter Einschränkungen und häufig gestellten Fragen.

Hinweise

• Für das von Ihnen verwendete Google Cloud-Projekt muss der Zugriff auf AlloyDB aktiviert sein.
• Sie benötigen eine der folgenden IAM-Rollen im verwendeten Google Cloud-Projekt:
  • roles/alloydb.admin (die vordefinierte IAM-Rolle „AlloyDB Admin“)
  • roles/owner (die einfache IAM-Rolle „Inhaber“)
  • roles/editor (einfache IAM-Rolle „Bearbeiter“)

  Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Administrator Ihrer Organisation, um Zugriff anzufordern.

Sekundären Cluster erstellen

Wenn Sie einen sekundären Cluster erstellen, kopiert und wendet AlloyDB einen Teil der primären Clusterkonfiguration, einschließlich der Wiederherstellung zu einem bestimmten Zeitpunkt (Point-in-Time-Recovery, PITR) und der Sicherungskonfiguration, auf den sekundären Cluster an. AlloyDB fügt dem sekundären Cluster nach dem Erstellen keine Lesepoolinstanzen hinzu, unabhängig davon, wie viele Lesepoolinstanzen im primären Cluster vorhanden sind.

Wenn Sie die Konfiguration des primären Clusters nach dem Erstellen des sekundären Clusters aktualisieren, sind die Änderungen im sekundären Cluster nicht verfügbar. Sie können den sekundären Cluster jedoch manuell aktualisieren, damit er die neueste Konfiguration hat, die im primären Cluster verfügbar ist.

So erstellen Sie einen sekundären AlloyDB-Cluster und eine sekundäre Instanz:

Console

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

3. Klicken Sie auf der Seite Übersicht auf Sekundären Cluster erstellen.

4. Konfigurieren Sie den sekundären Cluster:

   1. Geben Sie im Feld Cluster-ID eine Ressourcen-ID für den sekundären Cluster ein.
   2. Wählen Sie für den sekundären Cluster eine andere Region als die des primären Clusters aus.
   3. Wählen Sie die Standardverschlüsselung von Google oder einen vom Kunden verwalteten Schlüssel (CMEK) als Verschlüsselungsmethode für den sekundären Cluster aus.

   Wenn Sie diesen Cluster mit einem CMEK-Schlüssel verschlüsseln möchten, gehen Sie so vor:

   1. Klicken Sie auf Erweiterte Verschlüsselungsoptionen.
   2. Wählen Sie Vom Kunden verwalteter Verschlüsselungsschlüssel (CMEK) aus.

   3. Wählen Sie im angezeigten Menü einen vom Kunden verwalteten Schlüssel aus.

      In der Google Cloud Console ist diese Liste auf Schlüssel im selbenGoogle Cloud Projekt und in derselben Region wie der neue Cluster beschränkt.

      Wenn Sie einen Schlüssel verwenden möchten, der nicht in dieser Liste enthalten ist, gehen Sie so vor:

      1. Klicken Sie auf Sie können Ihren Schlüssel nicht finden? Geben Sie den Namen der Schlüsselressource ein.
      2. Geben Sie den Ressourcennamen in das Feld Name der Schlüsselressource ein.
      3. Klicken Sie auf Speichern.
      4. Klicken Sie auf Weiter.

   Die Verwendung eines CMEK-Schlüssels mit AlloyDB erfordert einige zusätzliche Schritte. Weitere Informationen finden Sie unter CMEK verwenden.

   Wenn die zugehörige primäre Instanz mit einem CMEK-Schlüssel verschlüsselt ist, müssen Sie auch den sekundären Cluster mit einem CMEK-Schlüssel verschlüsseln.

5. Konfigurieren Sie die sekundäre Instanz:

   1. Geben Sie im Feld Instanz-ID eine Ressourcen-ID für die sekundäre Instanz ein. Die Ressourcen-ID muss innerhalb eines Clusters eindeutig sein.

6. Klicken Sie auf Cluster erstellen.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

Führen Sie den Befehl gcloud alloydb clusters create-secondary aus:

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID

Ersetzen Sie Folgendes:

• SECONDARY_CLUSTER_ID: Die ID des sekundären Clusters, den Sie erstellen möchten.
• SECONDARY_INSTANCE_ID: Die ID der sekundären Instanz, die Sie erstellen möchten.
• REGION_ID: Die ID der Region des sekundären Clusters, z. B. us-central1.
• PROJECT_ID: Die ID des Projekts des sekundären Clusters.
• LOCATION_ID: Der Standort Ihres primären Clusters, z. B. us-central1.
• PRIMARY_CLUSTER_ID: Die ID des primären Clusters, dem der sekundäre Cluster zugeordnet ist.
• SECONDARY_CLUSTER_ID: Die ID des sekundären Clusters, mit dem die sekundäre Instanz verknüpft ist.
• ALLOWED_PROJECT (Optional): Eine durch Kommas getrennte Liste von Projekt-IDs oder Projektnummern, für die Sie den Zugriff auf die Instanz zulassen möchten, z. B. my-project-1, 12345,my-project-n. Sie müssen eine Liste der zulässigen Projekte oder Nummern festlegen, wenn Ihr Cluster Private Service Connect als Methode zum Herstellen einer Verbindung zur Instanz verwendet.
• --no-enable-automated-backup(Optional): Deaktivieren Sie das Erstellen automatischer Sicherungen im sekundären Cluster.

Wenn Sie einen sekundären Cluster und eine Instanz mit Private Service Connect erstellen möchten, fügen Sie beim Erstellen des Clusters das Flag --enable-private-service-connect und das Flag --allowed-psc-projects hinzu. Mit dem Flag --allowed-psc-projects können Sie eine durch Kommas getrennte Liste von Projekt-IDs oder Projektnummern angeben, für die der Zugriff auf die Instanz zugelassen werden soll, z. B. my-project-1, 12345, my-project-n.

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 --enable-private-service-connect
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

Ersetzen Sie Folgendes:

• ALLOWED_PROJECT (Optional): Die durch Kommas getrennte Liste der Projekt-IDs oder Projektnummern, für die Sie den Zugriff auf die Instanz zulassen möchten, z. B. my-project-1, 12345, my-project-n. Sie müssen eine Liste der zulässigen Projekte oder Nummern festlegen, wenn Ihr Cluster Private Service Connect als Methode zum Herstellen einer Verbindung zur Instanz verwendet.

Wenn Sie eine sekundäre Instanz für einen Cluster mit aktivierter öffentlicher IP-Adresse erstellen möchten, fügen Sie den Parameter --assign-inbound-public-ip=ASSIGN_IPV4 hinzu.

 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
  --assign-inbound-public-ip=ASSIGN_IPV4

Optional können Sie die durch Kommas getrennte Liste der CIDR-Blöcke wie 64.233.160.0/16 an den Parameter --authorized-external-networks übergeben, um autorisierte externe Netzwerke in Ihrer Instanz festzulegen.

Sekundären Cluster ansehen

So rufen Sie detaillierte Informationen zu einem sekundären AlloyDB-Cluster auf:

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen sekundären Cluster.

3. Auf der Seite Übersicht finden Sie alle Details zu Ihrem sekundären Cluster.

Sekundäre Instanz aktualisieren

Sie können eine sekundäre Instanz aktualisieren, um Datenbank-Flags hinzuzufügen, zu ändern oder zu löschen. Sie können auch den Maschinentyp Ihrer sekundären Instanz skalieren.

Datenbank-Flags für eine sekundäre Instanz konfigurieren

So fügen Sie Datenbank-Flags hinzu, ändern sie oder löschen sie:

Console

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen sekundären Cluster, den Sie ändern möchten.

3. Klicken Sie auf der Seite Übersicht auf Instanzen in Ihrem Cluster, wählen Sie die sekundäre Instanz aus und klicken Sie dann auf Sekundäre Instanz bearbeiten.

4. So fügen Sie Ihrer Instanz ein Datenbankflag hinzu, ändern es oder löschen es:

   Markierung hinzufügen

   1. Klicken Sie auf Flag hinzufügen, um Ihrer Instanz ein Datenbank-Flag hinzuzufügen.
   2. Wählen Sie in der Liste Flag für neue Datenbank ein Flag aus.
   3. Geben Sie einen Wert für das Flag an.
   4. Klicken Sie auf Fertig.

   Flag ändern

   1. Wenn Sie ein Datenbank-Flag in Ihrer Instanz ändern möchten, maximieren Sie das Datenbank-Flag und ändern Sie den Wert des vorhandenen Flags im Abschnitt Datenbank-Flag bearbeiten.
   2. Klicken Sie auf Fertig.

   Markierung löschen

   1. Wenn Sie ein Datenbankflag aus Ihrer Instanz löschen möchten, wählen Sie das Flag aus und klicken Sie auf das Löschsymbol.
   2. Klicken Sie auf Fertig.

5. Klicken Sie auf Sekundäres Konto aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud alloydb instances update, um die Datenbankflags für eine sekundäre Instanz zu ändern.

Achtung: Mit dem folgenden Befehl werden alle zuvor festgelegten Datenbank-Flags überschrieben. Alle Datenbank-Flags, die nicht explizit in der Liste --database-flags enthalten sind, werden auf den Standardwert zurückgesetzt. Wenn Sie die Datenbank-Flags Ihrer Instanz beibehalten und gleichzeitig neue hinzufügen möchten, müssen Sie sowohl die aktuellen als auch die neuen Flags in die Liste --database-flags aufnehmen.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --database-flags FLAGS_LIST \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

• SECONDARY_INSTANCE_ID: Die ID der sekundären Instanz.
• FLAGS_LIST: Eine durch Kommas getrennte Liste mit einer oder mehreren Datenbankflag-Spezifikationen. Jede Spezifikation besteht aus dem Namen des Flags, einem Gleichheitszeichen (=) und dem Wert, der den Flags zugewiesen werden soll. Geben Sie für Datenbank-Flags, die keinen Wert haben, den Namen des Flags gefolgt von einem Gleichheitszeichen (=) an.
• REGION_ID: Die Region, in der sich die sekundäre Instanz befindet, z. B. us-central1.
• CLUSTER_ID: Die ID des Clusters, in dem sich die sekundäre Instanz befindet.
• PROJECT_ID: Die ID des Projekts, in dem sich der sekundäre Cluster befindet.

Maschinentyp der sekundären Instanz skalieren

So skalieren Sie den Maschinentyp Ihrer sekundären Instanz:

Console

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen sekundären Cluster, den Sie ändern möchten.

3. Klicken Sie auf der Seite Übersicht im Abschnitt Instanzen in Ihrem Cluster auf Sekundär bearbeiten.

   Diese Aktion ist nicht verfügbar, wenn auf der Seite der Status des Clusters Wartung lautet. Die Aktion ist wieder verfügbar, nachdem der Status in Bereit geändert wurde.

4. Wählen Sie einen Maschinentyp aus.

5. Klicken Sie auf Sekundäres Konto aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud alloydb instances update, um den Maschinentyp der sekundären Instanz zu ändern.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --cpu-count=CPU_COUNT \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

• SECONDARY_INSTANCE_ID: Die ID der sekundären Instanz, die Sie aktualisieren.

• CPU_COUNT: Die Anzahl der vCPUs, die Sie für die Instanz benötigen. Gültige Werte sind:

  • 2 (2 vCPUs, 16 GB RAM)
  • 4 (4 vCPUs, 32 GB RAM)
  • 8 (8 vCPUs, 64 GB RAM)
  • 16 (16 vCPUs, 128 GB RAM)
  • 32 (32 vCPUs, 256 GB RAM)
  • 64 (64 vCPUs, 512 GB RAM)

• REGION_ID: Die Region, in der sich die Instanz befindet.

• CLUSTER_ID: Die ID des Clusters, in dem sich die Instanz befindet.

• PROJECT_ID: Die ID des Projekts, in dem sich der Cluster befindet.

Wenn der Befehl eine Fehlermeldung mit dem Begriff invalid cluster state MAINTENANCE zurückgibt, wird der Cluster gerade routinemäßig gewartet. Dadurch ist die Neukonfiguration der Instanz vorübergehend nicht möglich. Führen Sie den Befehl noch einmal aus, nachdem der Cluster wieder den Status READY hat.

Informationen zum Prüfen des Clusterstatus finden Sie unter Clusterdetails ansehen.

Lesepoolinstanzen einem sekundären Cluster hinzufügen

So fügen Sie einem sekundären Cluster eine Lesepoolinstanz hinzu:

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen sekundären Cluster, dem Sie eine Lesepoolinstanz hinzufügen möchten.

3. Klicken Sie auf der Seite Übersicht im Bereich Instanzen in Ihrem Cluster auf Lesepool hinzufügen.

4. Lesepoolinstanz konfigurieren:

   1. Geben Sie im Feld Lesepoolinstanz-ID eine ID für die Lesepoolinstanz ein.
   2. Geben Sie im Feld Knotenzahl eine Knotenzahl ein. Die Anzahl der Knoten in einer Lesepoolinstanz bestimmt die Gesamtrechenleistung der Instanz. Alle Lesepoolinstanzen in einem Cluster können maximal 20 Knoten haben.
   3. Wählen Sie einen Maschinentyp aus.

   4. Optional: Legen Sie benutzerdefinierte Flags für Ihre Instanz fest. Gehen Sie für jedes Flag so vor:

      1. Klicken Sie auf Flag hinzufügen.
      2. Wählen Sie in der Liste Flag für neue Datenbank ein Flag aus.
      3. Geben Sie einen Wert für das Flag an.
      4. Klicken Sie auf Fertig.

5. Klicken Sie auf Lesepool hinzufügen.

Sekundären Cluster hochstufen

Bevor Sie einen sekundären Cluster hochstufen, führen Sie die folgenden Schritte aus, um zu prüfen, ob der sekundäre Cluster alle vom primären Cluster empfangenen Transaktionen angewendet hat:

1. Beenden Sie alle Schreibvorgänge an den primären Cluster.

2. So prüfen Sie den Replikationsstatus des sekundären Clusters:

   1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

      Zu den Clustern

   2. Klicken Sie in der Clusterliste auf den Namen des sekundären Clusters, den Sie befördern möchten.

   3. Klicken Sie auf der Seite mit den Clusterdetails auf Monitoring.

   4. Wählen Sie in der Liste Monitoring die sekundäre Instanz aus. Er wird in der Liste als Sekundär: INSTANCE_NAME angezeigt.

   5. Suchen Sie in der Liste der Messwerte nach dem Diagramm Replikationsverzögerung von der primären Instanz.

   6. Prüfen Sie, ob das Diagramm eine minimale Verzögerung aufweist.

      Ein Wert von 0 ist ideal. Wenn die Verzögerung länger als 0 ist, können Sie den sekundären Cluster trotzdem zum primären Cluster machen. Es besteht jedoch das Risiko, dass einige aktuelle Transaktionen verloren gehen, die bereits im primären Cluster committet wurden.

   7. Suchen Sie in der Liste der Messwerte nach dem Diagramm Replikationsstatus.

   8. Prüfen Sie, ob alle im Diagramm dargestellten Knoten den Wert streaming haben.

So stufen Sie einen sekundären Cluster in einen primären Cluster hoch:

Console

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf einen sekundären Cluster, den Sie zum primären Cluster machen möchten.

3. Klicken Sie auf der Seite Übersicht auf Cluster bewerben.

4. Geben Sie im angezeigten Dialogfeld die sekundäre Cluster-ID ein, um zu bestätigen, dass Sie den Cluster bewerben möchten.

5. Klicken Sie auf Hochstufen.

   Nachdem der Cluster befördert wurde, wird das Feld Typ: Sekundärer Cluster (hochverfügbar) auf der Seite Übersicht in Typ: Hochverfügbar mit Lesepools geändert.

gcloud

Führen Sie den Befehl gcloud alloydb clusters promote aus:

 gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --project=PROJECT_ID \

Ersetzen Sie Folgendes:

• SECONDARY_CLUSTER_ID: Die ID des sekundären Clusters, den Sie bewerben möchten.
• REGION_ID: Die ID der Region des sekundären Clusters,z. B. us-central1.
• PROJECT_ID: Die ID des Projekts des sekundären Clusters.

Switchover durchführen

Prüfen Sie vor dem Umschalten, ob beide Regionen, zu denen die primäre und die sekundäre Instanz gehören, online sind und sich die Instanzen in einem fehlerfreien Zustand befinden. Weitere Informationen finden Sie unter Instanz mit dem AlloyDB-Systemstatistik-Dashboard überwachen.

Führen Sie den Befehl gcloud alloydb clusters switchover aus:

   gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
   --region=REGION_ID \
   --project=PROJECT_ID \

Ersetzen Sie Folgendes:

• SECONDARY_CLUSTER_ID: Die ID des sekundären Clusters, den Sie zum primären Cluster machen möchten.
• REGION_ID: Die ID der Region des sekundären Clusters, z. B. us-central1.
• PROJECT_ID: Die ID des Projekts des sekundären Clusters.

Weitere Informationen

• Clusterdetails ansehen
• Liste der Cluster aufrufen