Configura extensiones de bases de datos

En esta página, se describe cómo habilitar y cómo inhabilitar las extensiones de PostgreSQL en AlloyDB.

Consulta Extensiones de base de datos compatibles para obtener la lista de las extensiones que admite AlloyDB.

Habilita una extensión

En general, para habilitar una extensión, debes conectarte a una base de datos en la instancia principal de un clúster de AlloyDB y, luego, ingresar un comando LOAD o CREATE EXTENSION.

Sin embargo, algunas extensiones requieren que establezcas una o más marcas de base de datos antes de que puedas usar el comando LOAD o CREATE EXTENSION para habilitar la extensión. Debes establecer estas marcas en la instancia de AlloyDB en la que deseas usar la extensión, ya sea la instancia principal o la instancia del grupo de lectura.

Procedimiento

1. Si es necesario, establece las marcas de base de datos adecuadas en la instancia en la que deseas usar la extensión, ya sea la instancia principal o una instancia del grupo de lectura.

   En la lista de extensiones compatibles se muestra qué extensiones requieren este paso y qué marcas de base de datos debes establecer.

2. Conecta un cliente psql a la instancia principal del clúster, como se describe en Conecta un cliente psql a una instancia.

   Nota: Debes conectarte a la instancia principal incluso si habilitas la extensión en una instancia del grupo de lectura.
3. En el símbolo del sistema de psql, conéctate a la base de datos y crea la extensión:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   Nota: Para crear la extensión auto_explain usa el comando LOAD.
4. Si lo deseas, repite el paso anterior para conectarte a otras bases de datos y crear la extensión en cada una de ellas.

Actualiza una extensión

Aunque las actualizaciones de mantenimiento de AlloyDB instalan automáticamente los objetos binarios de extensión más recientes en el software subyacente de tu instancia, no actualizan automáticamente el catálogo de la base de datos de la extensión. Es tu responsabilidad actualizar manualmente las extensiones para asegurarte de que usen las versiones compatibles más recientes.

Para determinar qué extensiones requieren una actualización, compara la versión instalada con la versión compatible más reciente que aparece en la tabla de referencia Extensiones compatibles.

Conéctate a tu base de datos y ejecuta el siguiente comando para ver las versiones instaladas:

SELECT * FROM pg_extension;

Para actualizar una extensión a la versión más reciente disponible en tu instancia, usa el comando ALTER EXTENSION.

Conéctate a la instancia principal del clúster con un cliente de tu elección, como AlloyDB Studio o un cliente psql, y ejecuta el siguiente comando para cada extensión que deseas actualizar:

ALTER EXTENSION EXTENSION_NAME UPDATE;

Si necesitas actualizar a una versión específica, usa la siguiente sintaxis:

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Cómo inhabilitar una extensión

Para inhabilitar una extensión, debes revertir el procedimiento que usaste para habilitarla.

1. Conecta un cliente psql a la instancia principal del clúster, como se describe en Conecta un cliente psql a una instancia.

   Nota: Debes conectarte a la instancia principal incluso si inhabilitas una extensión que solo se usa en instancias del grupo de lectura.
2. En el símbolo del sistema de psql, conéctate a la base de datos que tiene habilitada la extensión y quita la extensión:

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. Repite el paso anterior para conectarte a cualquier otra base de datos que tenga la extensión habilitada y quita la extensión en cada una de ellas.

4. Si la extensión requería que se establecieran marcas de base de datos en las instancias donde se usaba, quita las marcas de cada una de las instancias donde se usó siguiendo las instrucciones en Configura las marcas de base de datos de una instancia.

   En la lista de extensiones compatibles se muestra qué extensiones requieren la configuración de marcas de base de datos y se identifican las marcas.