PostgreSQL es un sistema de gestión de bases de datos relacionales (RDBMS) de código abierto desarrollado por un equipo de voluntarios de todo el mundo.
El conector de PostgreSQL te permite acceder a la información de las bases de datos de PostgreSQL desde Data Studio.
Cómo conectarse a PostgreSQL
Este conector utiliza el controlador JDBC de PostgreSQL para conectar una fuente de datos de Data Studio a una sola tabla de base de datos de PostgreSQL.
Versiones compatibles
Hemos probado Data Studio en las siguientes versiones de PostgreSQL:
- 9,6
- 10
- 11
- 12
- 13
- 14
Si tienes algún problema al usar una versión compatible, ponte en contacto con nosotros a través de la comunidad de Data Studio. También puedes añadir y votar solicitudes de funciones en el registro de incidencias.
Para conectarse
- Inicia sesión en Data Studio.
- En la parte superior izquierda de la página principal de Data Studio, haz clic en Crear y, a continuación, selecciona Fuente de datos.
- Selecciona el conector de PostgreSQL.
- Configura el acceso a tu base de datos mediante una de las opciones de conexión.
- Haz clic en AUTHENTICATE. Verás una lista de las tablas de esa base de datos.
- Selecciona una tabla.
- Haz clic en CONECTAR.
Ahora puedes usar todas las columnas de dicha tabla como campos en los informes.
Opciones de conexión
BÁSICA
Para conectarse usando un nombre de host o una dirección IP, deberás proporcionar los datos siguientes:
- Nombre de host o dirección IP
- Puerto (opcional)
- Base de datos
- Nombre de usuario
- Contraseña
URL de JDBC
Para conectarse mediante una URL de JDBC, facilita la siguiente información de conexión:
- URL de JDBC
- Ejemplo:
jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
- Ejemplo:
- Contraseña
Si usas el nombre de host JDBC para realizar la conexión, las herramientas de petición de DNS públicas como Whois te permiten comprobar si es accesible.
Para conectarte a través de una dirección literal IPv6, escríbela entre corchetes. Por ejemplo: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db
Habilitar SSL
Data Studio admite conexiones seguras (cifradas) con el servidor mediante el protocolo TLS (Seguridad en la capa de transporte). TLS también se conoce como SSL (Capa de conexión segura). Para usar una conexión segura, marca Habilitar SSL y proporciona tus archivos de configuración de SSL.
Data Studio no requiere esta configuración, pero puede que sea necesaria para la configuración de tu base de datos. Ponte en contacto con el proveedor de tu base de datos para obtener más información.
Habilitar autenticación de cliente
Si marcas esta casilla, puedes subir una clave privada de cliente y un certificado de cliente si es necesario para acceder a tu base de datos.
Data Studio no requiere esta configuración, pero puede que sea necesaria para la configuración de tu base de datos. Ponte en contacto con el proveedor de tu base de datos para obtener más información.
Nota : Data Studio espera un formato de clave de cliente PKCS-8.
Más información sobre conexiones seguras con PostgreSQL.
Consulta personalizada
Selecciona la opción CONSULTA PERSONALIZADA para proporcionar una consulta de SQL en lugar de relacionarla con una sola tabla. Data Studio usa esta consulta SQL personalizada como instrucción SELECT interna para cada consulta enviada a la base de datos.
El ejemplo siguiente no funciona porque tiene varias declaraciones SQL:
DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;
SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;
Las consultas de Data Studio pueden agotar el tiempo de espera pasados entre 3 y 5 minutos. Si se agota el tiempo de espera de tus consultas personalizadas, prueba las siguientes soluciones para resolver el problema:
- Simplifica las consultas para que se ejecuten más rápido.
- Ejecuta las consultas en tu base de datos y almacena los resultados en otra tabla. Conecta la nueva tabla en tu fuente de datos.
Notas
Tipos de datos admitidos
El conector de PostgreSQL admite los siguientes tipos de datos:
- Numérico
- Carácter
- Booleano
- Fecha/Hora (excepto Intervalos)
Si Data Studio encuentra una columna de un tipo no admitido, no creará ningún campo para esa columna.
Más información sobre los tipos de datos de PostgreSQL.
Cortafuegos y acceso a la base de datos
Para permitir que Data Studio se conecte a bases de datos protegidas por un cortafuegos y para consultarlas, debes abrir el acceso a una de las siguientes direcciones IP. Puede que también tengas que configurar tu base de datos para que acepte el tráfico de estas direcciones. Consulta la documentación de tu base de datos específica para obtener instrucciones sobre cómo hacerlo.
Direcciones IP
142.251.74.0/232001:4860:4807::/48(opcional, para plataformas compatibles con IPv6)
Ten en cuenta las siguientes limitaciones de red al usar el conector de PostgreSQL:
Data Studio no admite conexiones de IP privada a PostgreSQL en Cloud SQL.
El conector de PostgreSQL no usa el proxy de Cloud SQL cuando se conecta a las instancias de Cloud SQL para PostgreSQL. Si quieres conectarte a una instancia de Cloud SQL para PostgreSQL, deberás agregar las IPs enumeradas a la lista de redes autorizadas. Consulta la documentación de Cloud SQL.
Limitaciones del conector de PostgreSQL
No se admite la conexión a fuentes de datos de AlloyDB a través de SSL, ya que AlloyDB no admite la exportación de certificados de autoridad de certificación (CA).
No se puede seleccionar una tabla que no esté incluida en el esquema
public. Sin embargo, puedes seleccionar la opción CONSULTA PERSONALIZADA para escribir una consulta que incluya tablas en cualquier esquema.Con este conector, puedes consultar un máximo de 150.000 filas por consulta. Si superas este límite, los datos se truncarán.
Los encabezados de columna (nombres de campo) solo deben usar caracteres ASCII. No se admiten caracteres que no sean ASCII.
Solución de problemas
Consulta la guía de solución de problemas de Data Studio para ver una lista de mensajes de error habituales y los pasos que debes seguir para solucionarlos.