Configurar extensiones de bases de datos

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

Consulta la lista de extensiones de base de datos compatibles con AlloyDB en Extensiones de base de datos admitidas.

Antes de empezar

  • El Google Cloud proyecto que estés usando debe tener habilitado el acceso a AlloyDB.
  • Debes tener uno de estos roles de gestión de identidades y accesos en el Google Cloud proyecto que estés usando:
    • roles/alloydb.admin (el rol de gestión de identidades y accesos predefinido de AlloyDB)
    • roles/owner (el rol básico de propietario de gestión de identidades y accesos)
    • roles/editor (el rol básico de gestión de identidades y accesos Editor)

    Si no tienes ninguno de estos roles, ponte en contacto con el administrador de tu organización para solicitar acceso.

Habilitar una extensión

Por lo general, para habilitar una extensión, debes conectarte a una base de datos en la instancia principal de un clúster de AlloyDB e introducir un comando LOAD o CREATE EXTENSION.

Sin embargo, algunas extensiones requieren que definas una o varias marcas de base de datos antes de poder usar los comandos LOAD o CREATE EXTENSION para habilitar la extensión. Puede definir estas marcas en la instancia de AlloyDB en la que quiera usar la extensión, ya sea la instancia principal o la instancia del grupo de lectura.

Procedimiento

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

    En la lista de extensiones admitidas se indica qué extensiones requieren este paso y qué marcas de base de datos debes definir.

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

  3. En el símbolo del sistema 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 quieres, repite el paso anterior para conectarte a otras bases de datos y crear la extensión en cada una de ellas.

Inhabilitar una extensión

Para inhabilitar una extensión, debes seguir el procedimiento inverso al que has usado para habilitarla.

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

  2. En la petición de comando psql, conéctate a la base de datos que tenga habilitada la extensión y elimina 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 suelta la extensión en cada una de ellas.

  4. Si la extensión requería que se definieran las marcas de la 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 de Configurar las marcas de la base de datos de una instancia.

    En la lista de extensiones admitidas se indica qué extensiones requieren que se definan marcas de bases de datos y cuáles son esas marcas.