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) im Datenbankclustermanifest (DBCluster) für Umgebungen aktualisieren, in denen AlloyDB Omni in einem Kubernetes-Cluster ausgeführt wird. Eine Liste der unterstützten Flags finden Sie unter Unterstützte Datenbank-Flags.

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 den folgenden Befehl aus, um Datenbankparameter aufzurufen:

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

Die Ausgabe sieht etwa so aus:

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

Wenn AlloyDB Omni die angeforderten Aktualisierungen nicht anwenden kann, werden die aktuellen und die angeforderten Werte in der Ausgabe separat aufgeführt. Dieser Unterschied kann beispielsweise auftreten, wenn Sie einen nicht vorhandenen Parameter anwenden oder einen Stringwert für einen Ganzzahlparameter festlegen.

Datenbankparameter über die Web-UI prüfen

Auf der Seite Datenbank-Flags in der AlloyDB Omni-Weboberfläche können Sie aktive Datenbank-Flags prüfen und benutzerdefinierte Parameter identifizieren, die von den Standardwerten der Engine abweichen.

So prüfen Sie Datenbankparameter in der Web-UI:

  1. Stellen Sie eine Verbindung zur Web-UI her und wählen Sie Ihren Cluster aus.
  2. Klicken Sie im Navigationsmenü auf Datenbank-Flags.
  3. Verwenden Sie die folgenden Steuerelemente, um Parameter zu suchen und zu filtern:
    • Nach Flags suchen: Geben Sie einen Suchbegriff ein (z. B. max), um Parameter nach Namen zu filtern.
    • Geänderte Flags anzeigen: Wählen Sie dieses Kästchen aus, um nur Parameter anzuzeigen, deren aktive Werte von den Standardwerten der Engine abweichen. Angepasste Werte werden in der Spalte Aktueller Wert ebenfalls gelb hervorgehoben.
    • Alle minimieren oder Alle maximieren: Minimieren oder maximieren Sie die Parameterkategoriegruppen (z. B. Google AlloyDB-Optionen, Standardeinstellungen für Clientverbindungen / Sprache und Formatierung, Standardeinstellungen für Clientverbindungen / Weitere Standardeinstellungen und Standardeinstellungen für Clientverbindungen / Vorabladen gemeinsam genutzter Bibliotheken).
  4. Sehen Sie sich die Spalten der Parametertabelle in den einzelnen Kategoriegruppen an:
    • Einstellung: Der Name des Datenbankparameters.
    • Typ: Der Datentyp des Parameters (z. B. INTEGER).
    • Aktueller Wert: Der aktive Wert des Parameters auf der Instanz (gelb hervorgehoben, wenn er vom Standardwert abweicht).
    • Standardwert: Der Standardwert der Engine für den Parameter.
    • Neustart erforderlich: Gibt an, ob für die Änderung des Parameters ein Neustart der Datenbank erforderlich ist (true oder false).
    • Quelle: Die Konfigurationsquelle des aktuellen Werts (z. B. default).