Puedes conectar tus bases de datos de PostgreSQL a Data Studio para visualizar y analizar tus datos. Usa el conector de PostgreSQL para transformar tus datos en informes y paneles interactivos. Luego, puedes compartir tus estadísticas con tu equipo o las partes interesadas que no tengan acceso directo a la base de datos.
Versiones compatibles
Probamos Data Studio en las siguientes versiones de PostgreSQL:
- 9.6
- 10
- 11
- 12
- 13
- 14
Si tienes problemas con el uso de 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.
Cómo conectarse a PostgreSQL
El conector de PostgreSQL usa el controlador JDBC de PostgreSQL para conectar una fuente de datos de Data Studio a una sola tabla de base de datos de PostgreSQL o a una consulta personalizada que proporciones.
Para conectarte a tu base de datos de PostgreSQL, sigue estos pasos:
- Accede a Data Studio.
- En la página principal de Data Studio, haz clic en Crear y, luego, selecciona Fuente de datos.
- Selecciona el conector de 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 tablas en esa base de datos.
- Selecciona una tabla de la lista o ingresa una consulta personalizada.
- Haz clic en CONECTAR.
Ahora puedes acceder a todas las columnas de la tabla como campos en tus informes.
Opciones de conexión
Conéctate con un nombre de host o una dirección IP
En el panel de conexión, selecciona BÁSICO. Ingresa los detalles de la conexión:
- Nombre de host o dirección IP
- Puerto (opcional)
- Base de datos
- Nombre de usuario
- Contraseña
Conéctate con una URL de JDBC
En el panel de conexión, selecciona URL de JDBC. Ingresa los detalles de la conexión:
- URL de JDBC
Ejemplo
jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
- Nombre de usuario
- Contraseña
Para conectarte con una dirección literal de IPv6, incluye la dirección entre corchetes. Por ejemplo:
jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db
Conéctate con SSL
Data Studio admite conexiones seguras (encriptadas) al servidor con el protocolo de seguridad de la capa de transporte (TLS) (TLS 1.2). TLS también se conoce como SSL (capa de conexión segura).
Para habilitar una conexión segura, selecciona Habilitar SSL y, luego, proporciona tus archivos de configuración de SSL.
Conéctate con la autenticación de cliente
Cuando la casilla Habilitar la autenticación de cliente está marcada, puedes subir una clave privada de cliente y un certificado de cliente si es necesario para acceder a tu base de datos.
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.
Las consultas de SQL personalizadas solo pueden tener una instrucción. Por ejemplo, la 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;
Las consultas en Data Studio pueden agotarse 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.
Tipos de datos admitidos
El conector de PostgreSQL admite los siguientes tipos de datos:
- Numérico
- “Basado
- Booleano
- Fecha/hora (excepto 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
Las siguientes direcciones están reservadas para la infraestructura global de Data Studio:
142.251.74.0/232001:4860:4807::/48(opcional, para plataformas que admiten IPv6)
142.251.56.0/242001:4860:4815::/48(opcional, para plataformas que admiten IPv6)
Ten en cuenta las siguientes limitaciones de red 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 excedes 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.