Configurar extensiones de PostgreSQL

Puedes ampliar PostgreSQL agrupando objetos SQL en un paquete y usándolos como una unidad. En esta página se ofrece información sobre cómo configurar las extensiones de PostgreSQL que admite Cloud SQL.

Usar extensiones de PostgreSQL

Solo puedes instalar las extensiones que admite Cloud SQL. Para obtener más información, consulta Extensiones de PostgreSQL compatibles con Cloud SQL.

Instalar una extensión

Antes de usar una extensión, instálala:

• En la herramienta psql, ejecuta el comando CREATE EXTENSION.

Requisitos de los privilegios de superusuario

En Cloud SQL, solo pueden crear extensiones los usuarios que formen parte del rol cloudsqlsuperuser. Cuando creas una instancia de PostgreSQL, se crea automáticamente el usuario postgres predeterminado (aunque debes definir la contraseña del usuario). El usuario postgres predeterminado forma parte del rol cloudsqlsuperuser. Para obtener más información, consulta Acerca de los usuarios de PostgreSQL.

Conexiones entre bases de datos

Las instancias de destino de las conexiones deben estar en la misma red VPC que la instancia de conexión.

En las instancias de clúster, no puedes elegir la opción Requerir certificados de cliente de confianza en laGoogle Cloud consola. Además, para conectarte a bases de datos de la misma instancia, no puedes definir el host como localhost ni como 127.0.0.1. En su lugar, debes usar la dirección IP que se muestra en la Google Cloud consola de tu instancia.

Solicitar asistencia para una nueva extensión

No puedes crear tus propias extensiones en Cloud SQL.

Para solicitar asistencia para una extensión, haz clic en +1 en la incidencia abierta o crea una nueva. Para ver una lista de los problemas abiertos de Cloud SQL e información sobre cómo crear nuevos problemas, consulta Buscar o crear problemas y solicitudes de funciones por producto.

Extensiones de PostgreSQL compatibles con Cloud SQL

Para obtener información sobre cómo usar una extensión específica, consulta el enlace a la documentación de una de las tablas que aparecen a continuación.

La compatibilidad de Cloud SQL con las extensiones de PostgreSQL se puede dividir en las siguientes categorías:

• Extensiones de PostGIS
• Extensiones de tipo de datos
• Extensiones de idioma
• Extensiones varias

PostGIS

La extensión PostGIS es compatible con Cloud SQL para PostgreSQL en todas las versiones principales.

En la siguiente tabla se muestran las versiones de la extensión PostGIS para cada versión de Cloud SQL para PostgreSQL:

En una versión principal específica de PostgreSQL, en el comando CREATE EXTENSION, puedes especificar una versión de la extensión PostGIS mediante la cláusula VERSION.

La extensión PostGIS incluye lo siguiente:

• postgis
• postgis_raster
• postgis_sfcgal
• postgis_tiger_geocoder
• postgis_topology
• address_standardizer
• address_standardizer_data_us

Para obtener más información, consulta Instalación de PostGIS.

Además, Cloud SQL para PostgreSQL incluye la versión 3.6.2 de la extensión pgRouting, que amplía PostGIS. La extensión pgRouting mejora el procesamiento geoespacial mediante el enrutamiento y el análisis de redes.

Puedes actualizar PostGIS y sus extensiones relacionadas a la versión más reciente manualmente. Para obtener más información sobre cómo actualizar las extensiones de PostGIS, consulta Actualizar PostGIS.

Extensiones de tipo de datos

Extensiones de idioma

Extensiones varias

Más información sobre algunas extensiones de PostgreSQL

En esta sección se ofrece más información sobre algunas de las extensiones de PostgreSQL admitidas en las tablas anteriores.

auto_explain

Para empezar a usar esta extensión en una instancia, define la marca cloudsql.enable_auto_explain en on. Para obtener información sobre cómo definir marcas y consultar las marcas admitidas para esta extensión, consulta el artículo Configurar marcas de la base de datos.

Para ver los datos de registro y los eventos asociados a los registros de los planes de ejecución que habilita esta extensión, consulta la documentación de Cloud Logging.

También puedes usar el comando load para cargar esta extensión en una sesión de un usuario que solo tenga el rol cloudsqlsuperuser.

dblink

Desde una sesión de base de datos, puedes usar esta extensión para conectarte a bases de datos de PostgreSQL y ejecutar consultas.

Actualmente, esta extensión funciona con dos instancias de IP privada de Cloud SQL en la misma red de VPC o con bases de datos cruzadas en la misma instancia.

Para obtener más información, consulta dblink en la documentación de PostgreSQL.

Usar dblink para conectarse con una contraseña

Para conectarte a bases de datos o a la misma instancia que otro usuario, debes especificar una contraseña. A modo de ejemplo (pero no para fines de producción), aquí tienes un fragmento de código:

  SELECT * FROM dblink (
    'dbname=name port=1234 host=host user=user password=password',
    'select id, name from table' \
  ) AS t(id int, name text);

También puedes configurar solo una conexión. Aquí tienes un fragmento de código de ejemplo (no para producción):

  SELECT dblink_connect('dbname=dblinktest user=postgres host=name_or_ip password=xxx');

Usar dblink para conectarse sin contraseña

Para conectarte a la misma instancia como el mismo usuario, puedes conectarte sin contraseña. Por ejemplo:

1. Define la siguiente marca de base de datos para habilitar las conexiones locales sin contraseña:
   cloudsql.allow_passwordless_local_connections

2. Conectarse sin especificar un host, lo que implica conectarse a la misma instancia. A continuación se muestra un ejemplo:

   SELECT *
     FROM dblink('dbname=finance user=alice',
                 'select income from revenue')
       AS revenue(income integer);
   

   El resultado podría ser similar al siguiente:

         income
         --------
         1000
         (1 row)
   

Para conectarte a bases de datos de la misma instancia, no puedes definir el host como localhost ni como 127.0.0.1. En su lugar, debes usar la dirección IP que se muestra en la Google Cloud consola de tu instancia.

Consulta también postgres_fdw y PL/Proxy en este documento.

pageinspect

Esta extensión inspecciona el contenido de las páginas de la base de datos a un nivel bajo. Para obtener más información, consulta pageinspect en la documentación de PostgreSQL.

pg_bigm

Esta extensión habilita la búsqueda en todo el texto y permite un índice de dos palabras (bigrama) para que la búsqueda en todo el texto sea más rápida.

Para empezar a usar esta extensión en una instancia, define la marca cloudsql.enable_pg_bigm en on. También se admiten las siguientes marcas:

• pg_bigm.enable_recheck
• pg_bigm.gin_key_limit
• pg_bigm.similarity_limit

Para obtener información sobre cómo definir marcas y consultar las marcas admitidas en esta extensión, consulta Configurar marcas de la base de datos.

pg_cron

Para empezar a usar pg_cron en una instancia, define la marca cloudsql.enable_pg_cron en on. Para obtener información sobre cómo definir marcas y consultar las marcas admitidas en esta extensión, consulta Configurar marcas de la base de datos.

Los trabajos se configuran como trabajadores en segundo plano, por lo que es posible que tengas que usar técnicas estándar de PostgreSQL (como la marca max_worker_processes) para ajustar el número de esos trabajadores en segundo plano.

En esta extensión, Cloud SQL admite el modo de trabajador en segundo plano, pero no la interfaz libpq. Por lo tanto, no es necesario autenticar la confianza directamente con esta extensión.

pgfincore

Esta extensión contiene funciones para gestionar páginas en la memoria caché de disco del sistema operativo desde PostgreSQL. Para obtener más información, consulta la documentación de pgfincore.

pg_freespacemap

Esta extensión examina el mapa de espacio libre (FSM). Para obtener más información, consulta pg_freespacemap en la documentación de PostgreSQL.

pg_hint_plan

Para empezar a usar esta extensión en una instancia, define la marca cloudsql.enable_pg_hint_plan en on. Para obtener información sobre cómo definir marcas y consultar las marcas admitidas para esta extensión, consulta el artículo Configurar marcas de la base de datos.

También puedes usar el comando load para cargar esta extensión en una sesión solo para un usuario con el rol cloudsqlsuperuser.

pg_partman

Esta extensión te permite crear y gestionar conjuntos de particiones de tablas basadas en el tiempo y en series.

En Cloud SQL, esta extensión no incluye el trabajador en segundo plano para el mantenimiento automático de particiones. En su lugar, puedes usar, por ejemplo, Cloud Scheduler para llevar a cabo el mantenimiento llamando a las funciones de mantenimiento a intervalos regulares.

pg_proctab

Estos son los pasos para usar la extensión pg_proctab para habilitar la utilidad pg_top:

1. En la herramienta psql, ejecuta el comando CREATE EXTENSION para pg_proctab.
2. Descarga y ejecuta pg_top.
3. Cuando te conectes a una instancia de Cloud SQL para PostgreSQL, añade la opción -r para conectarte a una base de datos remota y obtener métricas.

Las siguientes métricas de toda la instancia, que se incluyen en el resultado, incluyen el uso de otros agentes y servicios compatibles en la instancia:

• Carga media
• Estados de la CPU (porcentaje de usuario, nice, sistema, inactivo y espera de E/S)
• Memoria (usada, libre y en caché)

pg_repack

Esta extensión te permite eliminar el exceso de datos de las tablas y los índices. Opcionalmente, puedes usar esta extensión para realizar un CLUSTER online (ordenar tablas por índice de clúster). Para obtener más información, consulta la documentación de pg_repack. Además, para usar esta extensión en Cloud SQL, se necesita un procedimiento especial para añadir privilegios a un usuario.

Si un usuario que no tiene el rol cloudsqlsuperuser quiere usar una extensión, debes concederle los privilegios cloudsqlsuperuser. Para obtener más información, consulta la sección Requisito de privilegios de superusuario de este documento. En el siguiente ejemplo se usa el comando GRANT para añadir los privilegios necesarios.

Ejemplo de cómo añadir privilegios

En los ejemplos que se muestran a continuación, csuper1 es un cloudsqlsuperuser y testdb es una base de datos propiedad de testuser. Para crear la extensión pg_repack en testdb, ejecuta inicialmente los siguientes comandos:

1. Conéctate a testdb como cloudsqlsuperuser:

   psql -U csuper1 -d testdb;
   

2. Concede el rol de propietario de la base de datos, que es testuser,, a csuper1:

   GRANT testuser TO csuper1;
   

3. Crea la extensión:

   CREATE EXTENSION pg_repack;
   

4. Ejecuta el comando pg_repack en una tabla, como t1 en testdb, de la siguiente manera: csuper1

   pg_repack -h <hostname> -d testdb -U csuper1 -k -t t1
   

5. Una vez completada la tarea pg_repack, revoca la concesión que has realizado en el paso 2:

    REVOKE testuser FROM csuper1;
   

Es posible que el comando pg_repack falle y se muestre el siguiente error:
"ERROR: query failed: SSL SYSCALL error: EOF detected"

Si se produce ese error, prueba a asignar un valor más pequeño a las conexiones keep-alive de TCP y, a continuación, ejecuta el comando pg_repack. Para obtener más información, consulta Tiempo de espera de las conexiones (de Compute Engine).

pg_squeeze

Esta extensión elimina el espacio no utilizado de una tabla y, opcionalmente, usa un índice para ordenar las tuplas de la tabla. Para empezar a usar la extensión en una instancia, define la marca cloudsql.enable_pg_squeeze como on.

Esta extensión también admite la decodificación lógica escribiendo información adicional en el registro de escritura anticipada (WAL). Para habilitar esta función en la extensión, asigna al parámetro de configuración wal_level el valor logical o uno superior. Para ello, asigna el valor on a la marca cloudsql.logical_decoding.

La extensión requiere que se defina un valor para la marca max_replication_slots. Si no has especificado ningún valor para esta marca, asigna el valor 1. De lo contrario, añade 1 al valor asignado a la marca.

Para obtener información sobre cómo definir marcas y consultar las marcas admitidas para esta extensión, consulta Configurar marcas de la base de datos.

pgtt

Para empezar a usar esta extensión en una instancia, define la marca pgtt.enabled en on. Para obtener información sobre cómo definir marcas y consultar las marcas admitidas para esta extensión, consulta el artículo Configurar marcas de la base de datos.

pg_visibility

Esta extensión permite examinar el mapa de visibilidad (VM) y la información de visibilidad a nivel de página de una tabla. Para obtener más información, consulta pg_visibility en la documentación de PostgreSQL.

PL/Proxy

Esta extensión es un controlador de lenguaje de procedimiento que permite realizar llamadas a procedimientos remotos entre bases de datos PostgreSQL, con la opción de usar el particionado.

Para obtener más información, consulta la documentación de PL/Proxy.

Las instancias de destino de las conexiones deben estar en la misma red VPC que la instancia de conexión. Además, no puedes elegir el botón Permitir solo conexiones SSL en la consola de las instancias de clúster.Google Cloud

Para conectarte a bases de datos de la misma instancia, no puedes definir el host como localhost ni como 127.0.0.1. En su lugar, debes usar la dirección IP que se muestra en la Google Cloud consola de tu instancia.

Consulta también postgres_fdw y dblink en este documento.

postgresql_anonymizer

Para empezar a usar esta extensión en una instancia, define la marca cloudsql.enable_anon en on. Para obtener información sobre cómo definir marcas y consultar las marcas admitidas para esta extensión, consulta el artículo Configurar marcas de la base de datos.

postgres_fdw

Esta extensión permite que las tablas de otras bases de datos PostgreSQL ("externas") se expongan como tablas "externas" en la base de datos actual. Estas tablas se pueden usar casi como si fueran tablas locales. Para obtener más información, consulta postgres_fdw en la documentación de PostgreSQL.

Esta extensión funciona con dos instancias de IP privada de Cloud SQL en la misma red de VPC o con bases de datos cruzadas en la misma instancia.

Para conectarte a bases de datos de la misma instancia, no puedes definir el host como localhost ni como 127.0.0.1. En su lugar, debes usar la dirección IP que se muestra en la Google Cloud consola de tu instancia.

Además, en una instancia en la que se almacenan datos extranjeros, puedes elegir la opción Permitir solo conexiones SSL en la consola de Google Cloud . No puedes elegir la opción Requerir certificados de cliente de confianza. Solo el cloudsqlsuperuser puede ser el propietario de un postgres_fdw envoltorio de datos externos.

Consulta también PL/Proxy y dblink en este documento.

postgresql-hll

Esta extensión introduce un nuevo tipo de datos, hll, que es una estructura de datos HyperLogLog. Para obtener más información, consulta la documentación de postgresql-hll.