Para agregar funciones adicionales a tus bases de datos de AlloyDB para PostgreSQL, como la búsqueda de vectores, la indexación geoespacial o la auditoría de consultas, puedes habilitar, actualizar e inhabilitar las extensiones de PostgreSQL compatibles.
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 configures una o más marcas de base de datos
antes de poder usar el comando LOAD o CREATE EXTENSION para habilitar la
extensión. Establece 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
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 de grupo de lectura.
En la lista de extensiones compatibles, se muestra qué extensiones requieren este paso y se indican las marcas de base de datos que debes configurar.
Conecta un cliente
psqla la instancia principal del clúster, como se describe en Conecta un cliente psql a una instancia.- 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;
- 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. Eres responsable de actualizar manualmente tus 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 se indica en la tabla de referencia de 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 el cliente que prefieras, como AlloyDB Studio o un cliente de psql, y ejecuta el siguiente comando para cada extensión que quieras 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.
Conecta un cliente
psqla la instancia principal del clúster, como se describe en Conecta un cliente psql a una instancia.- En el símbolo del sistema de
psql, conéctate a la base de datos que tiene la extensión habilitada y descártala:\c DB_NAME DROP EXTENSION EXTENSION_NAME;
- Repite el paso anterior para conectarte a cualquier otra base de datos que tenga la extensión habilitada y descártala en cada una de ellas.
Si la extensión requería que se establecieran marcas de base de datos en las instancias en las que se usaba, quita las marcas de cada una de las instancias en las que se usaba siguiendo las instrucciones que se indican 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.