Configura extensiones de bases de datos

En esta página, se describe cómo habilitar y, también, inhabilitar 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 Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto Google Cloud que estás usando:
    • 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 básico de IAM 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 la base de datos antes de que puedas 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, 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 muestran las extensiones que requieren este paso y se indican las marcas de base de datos que 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.

  3. En el símbolo del sistema de psql, conéctate a la base de datos y crea la extensión: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. 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 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.

  2. En el símbolo del sistema de psql, conéctate a la base de datos que tiene habilitada la extensión y descarta 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 habilitada la extensión y descarta 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 en las que se usaba, quita las marcas de cada una de las instancias en las que se usó siguiendo las instrucciones en Configura las marcas de base de datos de una instancia.

    La lista de extensiones compatibles muestra qué extensiones requieren la configuración de marcas de base de datos y qué marcas.