Configura extensiones de bases de datos

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

Consulta Extensiones de bases de datos compatibles para ver la lista de extensiones que admite AlloyDB.

Antes de comenzar

• El proyecto de Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
• Debes tener uno de estos roles de IAM en el proyecto de Google Cloud que usas:
  • roles/alloydb.admin (el rol de IAM predefinido de administrador de AlloyDB)
  • roles/owner (el rol de IAM básico de propietario)
  • roles/editor (el rol de IAM básico de editor)

  Si no tienes ninguno de estos roles, comunícate con el administrador de tu organización para solicitar acceso.

Cómo habilitar 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. Puedes 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, configura 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.

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 de 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.

Cómo inhabilitar una extensión

Para inhabilitar una extensión, debes revertir el procedimiento que se usó 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 la extensión habilitada y, luego, elimínala:

   \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 suéltala en cada una de ellas.

4. Si la extensión requiere que se establezcan marcas de base de datos en las instancias en las que se usó, quita las marcas de cada una de las instancias en las que se usó siguiendo las instrucciones que se indican en Cómo configurar 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 cuáles son.