Datenbankparameter konfigurieren

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie Datenbankparameter mit dem AlloyDB Omni RPM-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 in der Ressourcenspezifikation DBCluster die erforderlichen Parameter und ihre Werte hinzu oder ändern Sie sie. Sie können dies tun, um Parameter während der Clustererstellung zu konfigurieren oder Parameter nach der Clustererstellung zu aktualisieren.

Das folgende Snippet zeigt Beispiele für GUC-Parameter. Sie können andere unterstützte Datenbankparameter auf ähnliche Weise konfigurieren:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

Ersetzen Sie Folgendes:

  • CLUSTER_NAME: der Name Ihres Datenbankclusters.
  • MAX_WAL_SIZE: ein Beispielparameter, der die maximale Größe steuert, auf die das WAL zwischen automatischen WAL-Prüfpunkten anwachsen kann, z. B. 2GB.
  • MAX_CONNECTIONS_LIMIT: ein Beispielparameter, der die maximale Anzahl gleichzeitiger Verbindungen zum Datenbankserver steuert, z. B. 200. Der unterstützte Mindestwert ist 50.
  • HUGE_PAGES: ein Beispielparameter, der die Verwendung von Huge Pages steuert, z. B. on.
  • LOG_STATEMENT: ein Beispielparameter, der steuert, welche SQL-Anweisungen protokolliert werden, z. B. all.

Konfiguration anwenden

Wenden Sie die Änderungen über die gewünschte Orchestrator-Oberfläche an.

Ansible

Wenn Sie Ihre AlloyDB Omni RPM-Orchestrator-Infrastruktur direkt mit Ansible verwalten, werden Updates ausgelöst, indem das entsprechende Playbook ausgeführt und die ausgewählte update_action als zusätzliche Variable übergeben wird.

Beispieldatei für update.yml:

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

Führen Sie den Ansible-Befehl aus:

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -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_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.

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.