Datenbank-Flags einer Instanz konfigurieren

Wenn Sie PostgreSQL-Parameter optimieren, Datenbankoptionen anpassen und das Instanzverhalten in einem AlloyDB for PostgreSQL-Cluster anpassen möchten, können Sie Datenbank-Flags für eine Instanz hinzufügen, ändern oder entfernen. Änderungen am Wert eines Datenbank-Flags bleiben für die Instanz bestehen, bis Sie das Flag entfernen oder den Wert noch einmal ändern.

In einigen Fällen muss vor dem Setzen eines Flags ein anderes Flag gesetzt werden, damit die Zielfunktionalität in vollem Umfang genutzt werden kann.

Wenn Sie ein Flag für eine Datenbankinstanz festlegen, entfernen oder ändern, wird die Instanz möglicherweise von AlloyDB neu gestartet. Dies hängt vom Flag ab, wie unter Unterstützte Datenbank-Flags aufgeführt.

Wenn Sie ein Datenbank-Flag in der primären Instanz oder einer Lesepoolinstanz ändern, die neu gestartet werden muss, können Sie eine der folgenden Wartungsrichtlinien auswählen:

  • Geringe Ausfallzeiten. Diese Richtlinie ist standardmäßig aktiviert. Wir empfehlen, diese Richtlinie für alle Ihre AlloyDB-Produktionscluster zu verwenden, da sie die Ausfallzeiten von Anwendungen minimiert.

    Wenn die Richtlinie für geringe Ausfallzeiten aktiviert ist, hat das Aktualisieren eines Flags, das einen Neustart der primären Instanz Ihres Clusters erfordert, folgende Auswirkungen:

    • Bei den meisten Arbeitslasten beträgt die Ausfallzeit der primären Instanz weniger als eine Sekunde.

    • Die Aktualisierung des Flags auf der primären Instanz auf den neuen Wert ist nach etwa 15 Minuten abgeschlossen.

    Das Aktualisieren eines Flags, das einen Neustart einer Lesepoolinstanz erfordert, hat folgende Auswirkungen:

    • Für die Lesepoolinstanz sind keine Ausfallzeiten erforderlich.

    • Das Flag in der Lesepoolinstanz wird nach etwa 10 Minuten auf den neuen Wert aktualisiert.

  • Anwenden erzwingen: Wenn Sie Flag-Updates schneller anwenden möchten, verwenden Sie die Option FORCE_APPLY mit dem Befehl gcloud beta alloydb instances update.

    Diese Richtlinie ist besser für Entwicklungsumgebungen geeignet, da Sie damit schnell Flags hinzufügen oder ändern können. Dafür müssen Sie jedoch längere Ausfallzeiten der Instanz und eine vorübergehende Verringerung der Datenbankleistung oder des Durchsatzes in Kauf nehmen. Der Cluster erreicht einige Minuten nach dem erzwungenen Anwenden eines Flag-Updates wieder die Spitzenleistung.

    Wenn die Richtlinie „Erzwingen“ aktiviert ist, hat das Aktualisieren eines Flags, das einen Neustart der primären Instanz Ihres Clusters erfordert, folgende Auswirkungen:

    • Die primäre Instanz ist etwa eine Minute lang nicht verfügbar.

    • Das Flag auf der primären Instanz wird nach ein bis zwei Minuten auf den neuen Wert aktualisiert.

    Das Aktualisieren eines Flags, das einen Neustart einer Lesepoolinstanz erfordert, hat folgende Auswirkungen:

    • Die Lesepoolinstanz ist etwa eine Minute lang nicht verfügbar.

    • Das Flag auf der Lesepoolinstanz wird nach ein bis zwei Minuten auf den neuen Wert aktualisiert.

Hinweis

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

    Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Organisationsadministrator, um Zugriff anzufordern.

Damit bei Wartungsarbeiten und Updates temporäre Replikationsslots für die Zustandssynchronisierung erstellt werden können, muss die Gesamtzahl der Replikationsslots mindestens um eins unter dem Limit max_wal_senders liegen. Weitere Informationen zum Konfigurieren dieses Flags finden Sie unter Quellinstanzen konfigurieren.

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. Rufen Sie auf der Seite Übersicht den Abschnitt Instanzen in Ihrem Cluster auf, wählen Sie eine Instanz aus und klicken Sie dann auf Bearbeiten.

  4. Maximieren Sie Erweiterte Konfigurationsoptionen.

  5. Fügen Sie ein Datenbank-Flag zu Ihrer Instanz hinzu, ändern oder löschen Sie es:

    Markierung hinzufügen

    1. Wenn Sie Ihrer Instanz ein Datenbank-Flag hinzufügen möchten, klicken Sie auf Flag hinzufügen.
    2. Wählen Sie ein Flag aus der Liste Neues Datenbank-Flag aus.
    3. Geben Sie einen Wert für das Flag an.
    4. Klicken Sie auf Fertig.

    Flag ändern

    1. Wenn Sie ein in Ihrer Instanz vorhandenes Datenbank-Flag ä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.

    Kennzeichnung löschen

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

  6. Klicken Sie auf Instanz aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud alloydb instances update, um die Datenbank-Flags für eine Instanz zu ändern.

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

Wenn Sie Flag-Updates schneller anwenden möchten, fügen Sie das Argument --update-mode=FORCE_APPLY ein. Da dies die Datenbankleistung vorübergehend beeinträchtigen kann, sollten Sie diese Option in einer Produktionsumgebung vermeiden.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Ersetzen Sie Folgendes:

  • INSTANCE_ID: Die ID der Instanz.
  • FLAGS_LIST: Eine durch Kommas getrennte Liste mit einer oder mehreren Datenbank-Flag-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 keine Werte annehmen, den Namen des Flags gefolgt von einem Gleichheitszeichen (=) an.
  • REGION_ID: Die Region, in der sich die Instanz befindet, z. B. us-central1.
  • CLUSTER_ID: Die ID des Clusters, in dem sich die Instanz befindet.
  • PROJECT_ID: Die ID des Projekts, in dem sich der Cluster befindet.

Führen Sie den folgenden Befehl aus, um die Liste der aktuellen, manuell festgelegten Flags einer Instanz aufzurufen:

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID