Datenbankparameter konfigurieren

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie Datenbankparameter mit dem AlloyDB Omni-Orchestrator konfigurieren.

Mit Datenbankparametern, auch als Grand Unified Configuration-Parameter (GUC) bezeichnet, können Sie die Leistung und das Verhalten Ihres AlloyDB Omni-Datenbankclusters optimieren. Weitere Informationen finden Sie in der PostgreSQL Dokumentation unter Parameter festlegen.

Hinweis

Bevor Sie Datenbankparameter konfigurieren, müssen Sie Folgendes erledigt haben:

  1. Den AlloyDB Omni-Orchestrator installiert.
  2. Ihren AlloyDB Omni-Cluster bereitgestellt und erstellt.

Datenbankparameter konfigurieren

Zum Konfigurieren von Datenbankparametern verwenden Sie das Feld parameters im Abschnitt primarySpec der Ressourcenspezifikation DBCluster.

Ressourcenspezifikation aktualisieren

Fügen Sie der Ressourcenspezifikation DBCluster die erforderlichen Parameter und ihre Werte hinzu:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"

Ersetzen Sie Folgendes:

  • CLUSTER_NAME: Name Ihres Datenbankclusters.
  • MAX_WAL_SIZE: Die maximale Größe, auf die das WAL zwischen automatischen WAL-Prüfpunkten anwachsen kann, z. B. 2GB.
  • MAX_CONNECTIONS_LIMIT: Maximale Anzahl gleichzeitiger Verbindungen zum Datenbankserver, z. B. 200. Der unterstützte Mindestwert ist 50.

Unterstützte Parameter während der Clustererstellung

Sie können die folgenden Datenbankparameter (GUCs) in der Ressourcenspezifikation DBCluster während der Clustererstellung konfigurieren:

  • log_connections
  • log_disconnections
  • log_hostname
  • log_statement
  • max_connections
  • max_wal_size
  • huge_pages
  • tcp_keepalives_idle
  • tcp_keepalives_interval
  • tcp_keepalives_count

Parameter wie shared_buffers, die nicht in dieser Liste enthalten sind, können nicht mit der Spezifikation DBCluster konfiguriert werden. Stattdessen müssen Sie sie nach der Clustererstellung manuell aktualisieren.

Konfiguration anwenden

Wenden Sie die Änderungen mit der bevorzugten Orchestrator-Oberfläche an.

Ansible 

ansible-playbook -i DEPLOYMENT_SPECIFICATION DBCLUSTER_PLAYBOOK -e resource_spec=DBCLUSTER_SPECIFICATION

Ersetzen Sie die folgenden Variablen:

  • DEPLOYMENT_SPECIFICATION: Pfad zur Bereitstellungsspezifikation, die Sie unter AlloyDB Omni-Komponenten installieren erstellt haben.

  • DBCLUSTER_PLAYBOOK: Pfad zum Playbook, das Sie für Ihren Datenbankcluster erstellt haben.

  • DBCLUSTER_SPECIFICATION: Pfad zur Clusterspezifikation.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Ersetzen Sie die folgenden Variablen:

  • DEPLOYMENT_SPECIFICATION: Pfad zur Bereitstellungsspezifikation, die Sie unter AlloyDB Omni-Komponenten installieren erstellt haben.

  • DBCLUSTER_SPECIFICATION: Pfad zur Clusterspezifikation.

Datenbankparameter nach der Clustererstellung aktualisieren

Wenn Sie Parameter nach der Clustererstellung aktualisieren möchten, müssen Sie die Konfigurationsdateien auf Ihren Datenbankknoten manuell ändern.

Parameter in einem Hochverfügbarkeitscluster aktualisieren

So aktualisieren Sie Datenbankparameter in einem Hochverfügbarkeitscluster (HA) manuell:

  1. Wenn availability.enableAutoFailover und availability.enableAutoHeal in der Spezifikationsdatei DBCluster auf true gesetzt sind, setzen Sie sie auf false.

    DBCluster:
  metadata:
    name: my-db-cluster
  spec:
    databaseVersion: 18.1.0
    mode: ""
    availability:
      ...
      enableAutoFailover: false
      enableAutoHeal: false
      ...

    Wenden Sie die aktualisierte Ressourcenspezifikation mit der bevorzugten Oberfläche an.

  2. Bearbeiten Sie auf jedem Datenbankknoten die 30startup.conf Datei im folgenden Verzeichnis: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Ersetzen Sie DATA_DISK_PATH durch den Wert aus dem Feld path des Laufwerks mit dem Namen DataDisk in der Ressourcenspezifikation DBCluster.

    Beispiel für eine DBCluster-Spezifikation:

    DBCluster:
  spec:
    primarySpec:
      resources:
        disks:
        - name: DataDisk
          path: /var/lib/alloydbomni/data  # This is your DATA_DISK_PATH

  3. Fügen Sie der Datei 30startup.conf Ihre Datenbankparameterkonfigurationen hinzu oder aktualisieren Sie sie. Weitere Informationen finden Sie in der PostgreSQL-Dokumentation.

  4. Starten Sie den Datenbankdienst auf allen Knoten neu:

    sudo systemctl restart alloydbomni18

  5. Wenn Sie die Felder availability.enableAutoFailover und availability.enableAutoHeal in der Ressourcenspezifikation DBCluster geändert haben, setzen Sie sie wieder auf die ursprünglichen Werte und wenden Sie die Änderungen an.

Parameter in einem Standalone-Cluster aktualisieren

So aktualisieren Sie Datenbankparameter in einem Standalone-Cluster manuell:

  1. Aktualisieren Sie auf dem Datenbankknoten die 30startup.conf Datei im folgenden Verzeichnis: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Ersetzen Sie DATA_DISK_PATH durch den Dateisystempfad, der für DataDisk in der Ressourcenspezifikation DBCluster definiert ist.

  2. Fügen Sie der Datei 30startup.conf Ihre Datenbankparameterkonfigurationen hinzu oder aktualisieren Sie sie.

  3. Starten Sie den Datenbankdienst neu:

    sudo systemctl restart alloydbomni18

Parameteränderungen prüfen

Nachdem Sie die Konfiguration angewendet haben, können Sie mit dem Befehl SHOW in psql prüfen, ob die Parameter aktualisiert wurden:

SHOW PARAMETER_NAME;

Ersetzen Sie PARAMETER_NAME durch den Namen des konfigurierten Parameters.