Datenbank-Flags einer Instanz konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Datenbank-Flags für eine Instanz hinzufügen, Datenbank-Flags ändern und Datenbank-Flags aus einer Instanz in einem AlloyDB for PostgreSQL-Cluster löschen.

Sie können Datenbank-Flags für viele Vorgänge verwenden, z. B. für das Anpassen von PostgreSQL-Parametern und Optionen sowie für das Konfigurieren und Optimieren einer Instanz. Änderungen am Wert eines Datenbank-Flags bleiben für die Instanz erhalten, bis Sie das Flag entfernen oder den Wert noch einmal ändern.

In einigen Fällen ist es notwendig, vor dem Setzen eines Flags ein anderes Flag zu setzen, damit die Funktionalität in vollem Umfang genutzt werden kann.

Nachdem Sie ein Flag für eine Datenbankinstanz festgelegt, entfernt oder geändert haben, wird die Instanz möglicherweise von AlloyDB neu gestartet. Das hängt vom Flag ab, wie in der Liste Unterstützte Datenbank-Flags aufgeführt.

Wenn Sie ein Datenbankflag in der primären Instanz oder in 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 Produktions-AlloyDB-Cluster zu verwenden, da dadurch die Ausfallzeiten der Anwendung minimiert werden.

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

    • Bei den meisten Arbeitslasten kommt es bei der primären Instanz zu einer Ausfallzeit von weniger als einer Sekunde.

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

    Wenn Sie ein Flag aktualisieren, das einen Neustart einer Lesepoolinstanz erfordert, hat das folgende Auswirkungen:

    • Für die Lesepoolinstanz sind keine Ausfallzeiten erforderlich.

    • Nach etwa 10 Minuten ist die Aktualisierung des Flags auf der Instanz des Lesepools auf den neuen Wert abgeschlossen.

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

    Diese Richtlinie eignet sich besser für Entwicklungsumgebungen, da Sie damit Flags schnell hinzufügen oder ändern können, was jedoch zu einer längeren Instanzausfallzeit und einer vorübergehenden Verringerung der Datenbankleistung oder des Durchsatzes führt. Nach dem Erzwingen einer Flag-Aktualisierung dauert es einige Minuten, bis der Cluster wieder seine Spitzenleistung erreicht.

    Wenn die Richtlinie zum Erzwingen der Anwendung 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.

    • Die Aktualisierung des Flags auf der primären Instanz auf den neuen Wert ist nach ein bis zwei Minuten abgeschlossen.

    Wenn Sie ein Flag aktualisieren, das einen Neustart einer Lesepoolinstanz erfordert, hat das folgende Auswirkungen:

    • Die Lesepoolinstanz hat eine Ausfallzeit von etwa einer Minute.

    • Nach ein bis zwei Minuten ist die Aktualisierung des Flags auf der Lesepoolinstanz auf den neuen Wert abgeschlossen.

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.

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 Instanzen in Ihrem Cluster, wählen Sie eine Instanz aus und klicken Sie dann auf Bearbeiten.

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

    Flag 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 Instanz aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud alloydb instances update, um die Datenbankflags 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 hinzu. Da dies die Datenbankleistung vorübergehend beeinträchtigen kann, sollten Sie diese Option nicht in einer Produktionsumgebung verwenden.

   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 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 (=) ein.
  • 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 eine Liste der aktuellen, manuell festgelegten Flags einer Instanz aufzurufen:

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