Datenbank-Flags einer Instanz konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Datenbank-Flags für eine Instanz in einem AlloyDB for PostgreSQL-Cluster hinzufügen, ändern und 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 bestehen, bis Sie das Flag entfernen oder seinen 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.

Wenn Sie ein Flag für eine Datenbankinstanz festlegen, entfernen oder ändern, wird die Instanz möglicherweise neu gestartet. Das 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, für die ein Neustart erforderlich ist, können Sie eine der folgenden Wartungsrichtlinien auswählen:

  • Geringe Ausfallzeiten Diese Richtlinie ist standardmäßig aktiviert. Wir empfehlen, diese Richtlinie für alle AlloyDB-Cluster in der Produktion zu verwenden, da sie die Ausfallzeiten der Anwendung minimiert.

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

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

    • Das Flag auf der primären Instanz wird nach etwa 15 Minuten auf den neuen Wert aktualisiert.

    Das Aktualisieren eines Flags, für das ein Neustart einer Lesepoolinstanz erforderlich ist, hat folgende Auswirkungen:

    • Bei der Lesepoolinstanz kommt es zu keinen Ausfallzeiten.

    • Das Flag auf 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. Ihr Cluster erreicht einige Minuten nach dem Erzwingen eines Flag-Updates wieder die Spitzenleistung.

    Wenn die Richtlinie zum Erzwingen der Anwendung aktiviert ist, hat das Aktualisieren eines Flags, für das ein Neustart der primären Instanz des Clusters erforderlich ist, folgende Auswirkungen:

    • Bei der primären Instanz kommt es zu Ausfallzeiten von etwa einer Minute.

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

    Das Aktualisieren eines Flags, für das ein Neustart einer Lesepoolinstanz erforderlich ist, hat folgende Auswirkungen:

    • Bei der Lesepoolinstanz kommt es zu Ausfallzeiten von etwa einer Minute.

    • Das Flag auf der Lesepoolinstanz wird nach einer oder 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.

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. Führen Sie einen der folgenden Schritte aus, um ein Datenbank-Flag für Ihre Instanz hinzuzufügen, zu ändern oder zu löschen:

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

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

  5. Klicken Sie auf Instanz aktualisieren.

gcloud

Verwenden Sie den gcloud alloydb instances update Befehl, 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 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 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. während eines Wartungszyklus mit geringen oder keinen Ausfallzeiten, nachdem Sie Datenbank-Flags geändert haben.

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