PostgreSQL es un sistema de administración de bases de datos relacionales (RDBMS) de código abierto que fue desarrollado por un equipo mundial de voluntarios.
El conector de PostgreSQL te permite acceder a los datos de las bases de datos de PostgreSQL en 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 única tabla de base de datos de PostgreSQL.
Versiones compatibles
Probamos Data Studio en las siguientes versiones de PostgreSQL:
- 9.6
- 10
- 11
- 12
- 13
- 14
Si tienes problemas para usar una versión compatible, infórmanos en la comunidad de Data Studio. También puedes agregar solicitudes de funciones y votar por ellas en la herramienta de seguimiento de errores.
Para conectarse
- Accede a Data Studio.
- En la página principal de Data Studio, en la parte superior izquierda, haz clic en Crear y, luego, selecciona Fuente de datos.
- Selecciona el conector PostgreSQL.
- Configura el acceso a tu base de datos con 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 acceder a todas las columnas de la tabla como campos en tus informes.
Opciones de conexión
BÁSICO
Para conectarte con un nombre de host o una dirección IP, deberás proporcionar la siguiente información:
- Nombre de host o dirección IP
- Puerto (opcional)
- Base de datos
- Nombre de usuario
- Contraseña
URL de JDBC
Para conectarte con una URL de JDBC, proporciona la siguiente información de conexión:
- URL de JDBC
- Ejemplo
jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
- Ejemplo
- Contraseña
Si usas la opción de nombre de host de JDBC, puedes asegurarte de que sea accesible con herramientas de búsqueda de DNS públicas, como Whois.
Para conectarte con una dirección literal de IPv6, encierra la dirección entre corchetes. Por ejemplo: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db
Habilitar SSL
Data Studio admite conexiones seguras (encriptadas) al servidor con el protocolo TLS (seguridad de la capa de transporte). TLS también se conoce como SSL (capa de conexión segura). Para habilitar una conexión segura, marca Habilitar SSL y, luego, proporciona tus archivos de configuración de SSL.
Data Studio no requiere este parámetro, pero es posible que sí lo requiera la configuración de tu base de datos. Consulta con tu proveedor de base de datos para obtener más detalles.
Habilitar la autenticación de cliente
Cuando se marca 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 este parámetro, pero es posible que sí lo requiera la configuración de tu base de datos. Consulta con tu proveedor de base de datos para obtener más detalles.
Nota : Data Studio espera un formato de clave de cliente PKCS-8.
Obtén más información sobre las conexiones seguras de PostgreSQL.
Consulta personalizada
Selecciona la opción CONSULTA PERSONALIZADA para proporcionar una consulta en SQL en lugar de conectarte a una sola tabla. Data Studio usa este SQL personalizado como una instrucción de selección interna para cada consulta generada a la base de datos.
Por ejemplo, lo siguiente no funcionará porque tiene varias instrucciones de 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;
Es posible que las consultas en Data Studio se agoten después de tres a cinco minutos. Si se agotan tus consultas personalizadas, prueba los siguientes enfoques para resolver el problema:
- Simplifica la consulta para que se ejecute más rápido.
- Ejecuta la consulta en tu base de datos y almacena los resultados en una tabla separada. Conecta la tabla nueva en tu fuente de datos.
Notas
Tipos de datos admitidos
El conector de PostgreSQL admite los siguientes tipos de datos:
- Numérico
- “Basado
- Booleano
- Fecha/hora (excepto los intervalos)
Cuando Data Studio encuentra una columna de un tipo no admitido, no crea un campo para esa columna.
Obtén más información sobre los tipos de datos de PostgreSQL.
Acceso a la base de datos y al firewall
Para permitir que Data Studio se conecte a bases de datos que están detrás de un firewall y las consulte, deberás abrir el acceso a una de las siguientes direcciones IP. Es posible que también debas 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 que admiten IPv6)
Ten en cuenta las siguientes limitaciones de redes cuando uses el conector de PostgreSQL:
Data Studio no admite conexiones de IP privadas a PostgreSQL en Cloud SQL.
El conector de PostgreSQL no usa el proxy de Cloud SQL cuando se conecta a instancias de Cloud SQL PostgreSQL. Si te conectas a una instancia de Cloud SQL PostgreSQL, deberás agregar las IPs enumeradas a la lista de redes autorizadas. Consulta la documentación de Cloud SQL.
Límites 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 certificada (CA).
No se admite la selección de una tabla fuera del esquema
public. Sin embargo, puedes seleccionar la opción CONSULTA PERSONALIZADA para escribir una consulta que incluya tablas en cualquier esquema.Puedes consultar un máximo de 150,000 filas por consulta con este conector. Si superas este límite, los datos se truncarán.
Los encabezados de columna (nombres de campo) deben usar solo caracteres ASCII. No se admiten los caracteres que no son ASCII.
Soluciona problemas
Consulta la guía de solución de problemas de Data Studio para obtener una lista de mensajes de error comunes y los pasos para resolverlos.
Recursos relacionados
Cómo crear una fuente de datos