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 de base de données compatibles avec AlloyDB, consultez Extensions de base de données compatibles.

Avant de commencer

  • Le projet Google Cloud que vous utilisez doit avoir été activé pour 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 "Administrateur AlloyDB")
    • 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 que vous définissiez un ou plusieurs indicateurs de base de données avant de pouvoir utiliser les commandes LOAD ou CREATE EXTENSION pour activer l'extension. Vous définissez ces indicateurs sur l'instance AlloyDB sur laquelle vous souhaitez utiliser l'extension, qu'il s'agisse de l'instance principale ou de l'instance du 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, qu'il s'agisse de l'instance principale ou d'une instance de pool de lecture.

    La liste des extensions compatibles indique celles qui nécessitent cette étape et précise 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 Connecter un client psql à une instance.

  3. À l'invite de commande psql, connectez-vous à la base de données et créez l'extension : 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. 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, vous devez inverser la procédure utilisée pour l'activer.

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

  2. À l'invite de commande psql, connectez-vous à la base de données sur laquelle l'extension est activée et supprimez-la : 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Répétez l'étape précédente pour vous connecter à toutes les autres bases de données pour lesquelles l'extension est activée, puis supprimez l'extension dans chacune d'elles.

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

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