AlloyDB Omni-Datenbankparameter konfigurieren

Wählen Sie eine Dokumentationsversion aus:

Wenn Sie einen Datenbankparameter für AlloyDB Omni konfigurieren möchten, können Sie GUC-Parameter (Grand Unified Configuration) in einer der folgenden Optionen aktualisieren:

  • Die Datei postgresql.conf für Umgebungen, in denen AlloyDB Omni auf einer VM ausgeführt wird.

  • Das Datenbankclustermanifest für Umgebungen, in denen AlloyDB Omni in einem Kubernetes-Cluster ausgeführt wird.

Parameter in containerisiertem AlloyDB Omni aktualisieren

In einer AlloyDB Omni-Instanz, die auf einer VM ausgeführt wird, können Sie einen Parameter aktualisieren, indem Sie die Datei postgresql.conf so bearbeiten:

  1. Suchen Sie die postgresql.conf-Konfigurationsdatei für Ihre Installation von AlloyDB Omni.

  2. Fügen Sie mit einem Texteditor ein Datenbankflag in postgresql.conf hinzu oder aktualisieren Sie ein vorhandenes Flag.

    Wenn Sie beispielsweise das Ablaufen von Passwörtern erzwingen möchten, legen Sie das folgende Flag in der Datei postgresql.conf fest:

    password.enforce_expiration = ON

  3. Nachdem Sie die Datenbankkennzeichnungen hinzugefügt oder bearbeitet haben, müssen Sie die postgresql.conf-Datei neu laden, damit die Änderungen wirksam werden. Wenn Sie beispielsweise AlloyDB Omni mit Docker installiert haben, führen Sie Folgendes aus, um Ihre Docker-Instanz neu zu starten und postgresql.conf neu zu laden:

    docker restart CONTAINER-NAME

Weitere Informationen finden Sie in der PostgreSQL-Dokumentation unter Parameter festlegen.

Parameter in AlloyDB Omni in einem Kubernetes-Cluster aktualisieren

Sie können Datenbankparameter mit dem Feld parameters im Abschnitt primarySpec des Manifests Ihres Datenbankclusters konfigurieren:

spec:
  primarySpec:
    parameters:
      "PARAMETER_NAME": "PARAMETER_VALUE"
      ...

Ersetzen Sie Folgendes:

  • PARAMETER_NAME: Der Name des Parameters, z. B. autovacuum.
  • PARAMETER_VALUE: der Wert des Parameters, z. B. off.

Bei einigen Parametern müssen Sie den Cluster neu starten, damit die Änderungen wirksam werden. Eine Liste der Parameter, für die ein Neustart erforderlich ist, finden Sie unter pg_catalog.pg_settings. Für jeden Parameter mit pg_catalog.pg_settings.context = 'postmaster' ist ein Neustart erforderlich.

Führen Sie den folgenden Befehl aus, um Datenbankparameter zu aktualisieren:

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

Die Parametereinstellungen befinden sich im status-Teil des Felds currentParameters.

Führen Sie Folgendes aus, um Datenbankparameter aufzurufen:

kubectl get dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -o jsonpath={.status.primary.currentParameters}

Die Ausgabe sieht dann ungefähr so aus:

{"autovacuum":"off","max_connections":"3000"}

Wenn AlloyDB Omni die im Datenbankclustermanifest angeforderten Parameter nicht anwenden kann, können sich die Werte für das Feld currentParameters von den Werten im Feld parameters Ihres Manifests unterscheiden. Sie wenden beispielsweise einen nicht vorhandenen Parameter an oder legen einen Stringwert für einen Ganzzahlparameter fest.