Configurer les paramètres de base de données

Sélectionnez une version de la documentation :

Cette page explique comment configurer les paramètres de base de données à l'aide de l'outil d'orchestration RPM AlloyDB Omni.

Les paramètres de base de données, également appelés paramètres GUC (Grand Unified Configuration), vous permettent d'ajuster les performances et le comportement de votre cluster de bases de données AlloyDB Omni. Pour en savoir plus, consultez la section Définir des paramètres dans la documentation PostgreSQL.

Avant de commencer

Avant de configurer les paramètres de base de données, assurez-vous d'avoir effectué les opérations suivantes :

  1. Installer l' outil d'orchestration AlloyDB Omni.
  2. Provisionner et créer votre cluster AlloyDB Omni.

Configurer les paramètres de base de données

Pour configurer les paramètres de base de données, utilisez le champ parameters dans la section primarySpec de la spécification de votre ressource DBCluster.

Mettre à jour la spécification de la ressource

Ajoutez ou modifiez les paramètres requis et leurs valeurs dans la spécification de votre ressource DBCluster. Vous pouvez effectuer cette opération pour configurer des paramètres lors de la création du cluster ou pour mettre à jour des paramètres après la création du cluster.

L'extrait de code suivant montre des exemples de paramètres GUC. Vous pouvez configurer d'autres paramètres de base de données compatibles de la même manière :

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

Remplacez les éléments suivants :

  • CLUSTER_NAME: nom de votre cluster de bases de données.
  • MAX_WAL_SIZE: exemple de paramètre contrôlant la taille maximale que le WAL peut atteindre entre les points de contrôle WAL automatiques, par exemple 2GB.
  • MAX_CONNECTIONS_LIMIT: exemple de paramètre contrôlant le nombre maximal de connexions simultanées autorisées sur le serveur de base de données, par exemple 200. La valeur minimale acceptée est 50.
  • HUGE_PAGES: exemple de paramètre contrôlant l'utilisation de pages volumineuses, par exemple on.
  • LOG_STATEMENT: exemple de paramètre contrôlant les instructions SQL qui sont enregistrées, par exemple all.

Appliquer la configuration

Appliquez les modifications à l'aide de l'interface de l'outil d'orchestration de votre choix.

Ansible

Si vous gérez directement votre infrastructure d'outil d'orchestration RPM AlloyDB Omni à l'aide d'Ansible, cela déclenche des mises à jour en exécutant le playbook approprié et en transmettant la update_action sélectionnée en tant que variable supplémentaire.

Exemple de fichier pour 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

Exécutez la commande Ansible :

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

Remplacez les variables suivantes :

  • DEPLOYMENT_SPECIFICATION: chemin d'accès à la spécification de déploiement que vous avez créée dans Installer les composants AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: chemin d'accès à la spécification de votre cluster.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Remplacez les variables suivantes :

  • DEPLOYMENT_SPECIFICATION: chemin d'accès à la spécification de déploiement que vous avez créée dans Installer les composants AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: chemin d'accès à la spécification de votre cluster.

Vérifier les modifications des paramètres

Après avoir appliqué la configuration, vous pouvez vérifier que les paramètres sont mis à jour à l'aide de la commande SHOW dans psql :

SHOW PARAMETER_NAME;

Remplacez PARAMETER_NAME par le nom du paramètre que vous avez configuré.