Conéctate a PostgreSQL

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 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.

Cómo conectarse a PostgreSQL

El conector de PostgreSQL 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 o a una consulta personalizada que proporciones.

Para conectarte a tu base de datos de PostgreSQL, sigue estos pasos:

1. Accede a Data Studio.
2. En la página principal de Data Studio, haz clic en Crear y, luego, selecciona Fuente de datos.
3. Selecciona el conector PostgreSQL.
4. Si se te solicita, autoriza a Data Studio para que acceda a tus datos.
5. Configura el acceso a tu base de datos con una de las opciones de conexión.
6. Haga clic en AUTENTICAR. Verás una lista de las tablas de esa base de datos.
7. Selecciona una tabla de la lista o ingresa una consulta personalizada.
8. 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 BASIC. 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

  • Para Cloud SQL (IP privada) jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE

• Nombre de usuario
• Contraseña

Nota: Si usas la opción de nombre de host 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

Conéctate con SSL

Data Studio admite conexiones seguras (encriptadas) al servidor a través del protocolo TLS (seguridad de la capa de transporte; TLS 1.2). TLS también se conoce como SSL (Secure Sockets Layer).

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 de verificación Habilitar la autenticación de cliente está marcada, puedes subir una clave privada del cliente y un certificado de cliente si es necesario para acceder a tu base de datos.

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.

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 tus consultas personalizadas agotan el tiempo de espera, 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 y hora (excepto intervalos)

Cuando Data Studio encuentra una columna de un tipo no compatible, no crea un campo para esa columna.

Obtén más información sobre los tipos de datos de PostgreSQL.

Conexiones públicas y privadas

Data Studio admite conexiones de IP públicas y privadas a PostgreSQL en Cloud SQL.

Para conectarte con una IP privada, debes usar la opción de conexión de URL de JDBC con el formato jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE. Además, debes seleccionar la opción Ruta privada para los servicios de Google Cloud en la configuración de tu instancia de Cloud SQL.

Acceso a la base de datos y al firewall

Para permitir que Data Studio se conecte a bases de datos que se encuentran detrás de un firewall y realice consultas en ellas, 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 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/23

• 2001:4860:4807::/48 (opcional para plataformas que admiten IPv6)

Si habilitaste la residencia de datos para tu suscripción a Data Studio Pro, usa las siguientes direcciones:

• 142.251.56.0/24

• 2001:4860:4815::/48 (opcional para plataformas que admiten IPv6)

Límites del conector de PostgreSQL

• 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 con una IP pública, deberás agregar las IPs que se indican a la lista de redes autorizadas. Consulta la documentación de Cloud SQL.

• 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 la autoridad de certificación (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.

• 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 los campos) deben usar solo caracteres ASCII. No se admiten caracteres que no sean ASCII.

Soluciona problemas

Consulta la guía de solución de problemas de Data Studio para obtener una lista de los mensajes de error comunes y los pasos para resolverlos.

Recursos relacionados

Cómo crear una fuente de datos