Configurer les extensions de base de données

Cette page explique comment activer et désactiver les extensions PostgreSQL dans AlloyDB.

Pour obtenir la liste des extensions compatibles avec AlloyDB, consultez la section Extensions de base de données compatibles.

Avant de commencer

• Le projet Google Cloud que vous utilisez doit avoir été autorisé à accéder à AlloyDB.
• Vous devez disposer de l'un des rôles IAM suivants dans le projet Google Cloud que vous utilisez :
  • roles/alloydb.admin (rôle IAM prédéfini "AlloyDB Admin")
  • roles/owner (rôle IAM de base Propriétaire)
  • roles/editor (rôle IAM de base Éditeur)

  Si vous ne disposez d'aucun de ces rôles, contactez l'administrateur de votre organisation pour demander l'accès.

Activer une extension

En général, vous activez une extension en vous connectant à une base de données dans l'instance principale d'un cluster AlloyDB et en saisissant une commande LOAD ou CREATE EXTENSION.

Toutefois, certaines extensions nécessitent de définir un ou plusieurs indicateurs de base de données avant de pouvoir utiliser la commande LOAD ou CREATE EXTENSION pour activer l'extension. Vous définissez ces indicateurs sur l'instance AlloyDB dans laquelle vous souhaitez utiliser l'extension, qu'il s'agisse de l'instance principale ou de l'instance de pool de lecture.

Procédure

1. Si nécessaire, définissez les indicateurs de base de données appropriés sur l'instance où vous souhaitez utiliser l'extension, soit l'instance principale, soit une instance de pool de lecture.

   La liste des extensions compatibles indique les extensions qui nécessitent cette étape et les indicateurs de base de données que vous devez définir.

2. Connectez un client psql à l'instance principale du cluster, comme décrit dans la section Connecter un client psql à une instance.

   Remarque:Vous devez vous connecter à l'instance principale, même si vous activez l'extension sur une instance de pool de lecture.
3. À l'invite de commande psql, connectez-vous à la base de données et créez l'extension:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   Remarque:Pour créer l'extension auto_explain, utilisez la commande "LOAD".
4. Si vous le souhaitez, répétez l'étape précédente pour vous connecter à d'autres bases de données et créer l'extension dans chacune d'elles.

Désactiver une extension

Pour désactiver une extension, procédez à l'inverse de la procédure d'activation.

1. Connectez un client psql à l'instance principale du cluster, comme décrit dans la section Connecter un client psql à une instance.

   Remarque:Vous devez vous connecter à l'instance principale, même si vous désactivez une extension qui n'est utilisée que sur les instances de pool de lecture.
2. À l'invite de commande psql, connectez-vous à la base de données pour laquelle l'extension est activée, puis supprimez-la:

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. Répétez l'étape précédente pour vous connecter à d'autres bases de données pour lesquelles l'extension est activée et placez-la dans chacune d'elles.

4. Si l'extension nécessitait que des indicateurs de base de données soient définis sur les instances où elle était utilisée, supprimez les indicateurs de chacune des instances où elle était utilisée en suivant les instructions de la section Configurer les indicateurs de base de données d'une instance.

   La liste des extensions compatibles indique les extensions qui nécessitent la définition d'indicateurs de base de données et identifie les indicateurs concernés.