Cette page explique comment activer et désactiver les extensions PostgreSQL dans AlloyDB.
Consultez la liste des extensions compatibles avec AlloyDB dans Extensions de base de données compatibles.
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 la commande LOAD ou CREATE EXTENSION pour activer l'extension. Vous définissez ces indicateurs sur l'instance AlloyDB où vous souhaitez utiliser l'extension, qu'il s'agisse de l'instance principale ou d'une instance de pool de lecture.
Procédure
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 les indicateurs de base de données que vous devez définir.
Connectez un client
psqlà l'instance principale du cluster, comme décrit dans Connecter un client psql à une instance.- À 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;
- 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.
Mettre à jour une extension
Bien que les mises à jour de maintenance d'AlloyDB installent automatiquement les derniers binaires d'extension sur le logiciel sous-jacent de votre instance, elles ne mettent pas automatiquement à jour le catalogue de base de données de l'extension. Vous devez mettre à jour manuellement vos extensions pour vous assurer qu'elles utilisent les dernières versions compatibles.
Pour déterminer les extensions qui nécessitent une mise à jour, comparez la version installée avec la dernière version compatible listée dans le tableau de référence Extensions compatibles.
Connectez-vous à votre base de données et exécutez la commande suivante pour afficher les versions installées :
SELECT * FROM pg_extension;
Pour mettre à jour une extension vers la dernière version disponible sur votre instance, utilisez la commande ALTER EXTENSION.
Connectez-vous à l'instance principale du cluster à l'aide d'un client de votre choix, tel qu'AlloyDB Studio ou un client psql, puis exécutez la commande suivante pour chaque extension que vous souhaitez mettre à jour :
ALTER EXTENSION EXTENSION_NAME UPDATE;
Si vous devez effectuer une mise à jour vers une version spécifique, utilisez la syntaxe suivante :
ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';
Désactiver une extension
Pour désactiver une extension, vous devez inverser la procédure utilisée pour l'activer.
Connectez un client
psqlà l'instance principale du cluster, comme décrit dans Connecter un client psql à une instance.- À l'invite de commande
psql, connectez-vous à la base de données pour laquelle l'extension est activée et supprimez-la :\c DB_NAME DROP EXTENSION EXTENSION_NAME;
- 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 et supprimez-la dans chacune d'elles.
Si l'extension nécessitait la définition d'indicateurs de base de données 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 celles qui nécessitent la définition d'indicateurs de base de données et les identifie lesquels.