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 paneles y, también, informes interactivos. Luego, puedes compartir tus estadísticas con tu equipo o con las partes interesadas que no tienen 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, comunícate con nosotros 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:

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 de 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 tablas en 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 BÁSICA. 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_NAME

  • Para Cloud SQL (IP privada) jdbc:google:postgresql://< var>INSTANCE_CONNECTION_NAME/DATABASE_NAME

• Nombre de usuario
• Contraseña

Nota: En el caso de las conexiones IP privadas de Cloud SQL, no agregues el nombre o el ID de tu organización como prefijo de la cadena de conexión y quita los espacios de la URL. Para conocer los requisitos completos, incluidos los permisos necesarios, consulta Conexiones públicas y privadas.

Sugerencia: 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 IPv6 literal, 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 con el protocolo TLS (seguridad de la capa de transporte) (TLS 1.2). La 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 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 declaración de selección interna para cada consulta generada a la base de datos.

Las consultas en SQL personalizadas solo pueden tener una sentencia. Por ejemplo, lo siguiente no funcionará porque tiene varias sentencias 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 agotar el tiempo de espera 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 a una instancia de Cloud SQL para PostgreSQL con una IP privada, verifica los siguientes requisitos:

• Permisos de Identity and Access Management (IAM): Otorga el rol de IAM de cliente de Cloud SQL (roles/cloudsql.client) en el proyecto de Google Cloud que contiene la instancia de Cloud SQL. Debes otorgar este rol a la cuenta de usuario que autentica la conexión en Data Studio o al propietario de las credenciales de la fuente de datos. Si la fuente de datos usa las credenciales del visualizador, otorga este rol a cada visualizador del informe.
• Configuración de la instancia: Selecciona la opción Ruta privada para los servicios de Google Cloud en la configuración de la instancia de Cloud SQL.

• URL de JDBC: En el panel de conexión, selecciona la opción de conexión URL de JDBC y, luego, ingresa la cadena de conexión con el siguiente formato:

  jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE_NAME

  Reemplaza lo siguiente:

  • INSTANCE_CONNECTION_NAME: Es el nombre de conexión de la instancia en el formato PROJECT_ID:REGION:INSTANCE_ID.
  • DATABASE_NAME: el nombre de tu base de datos de PostgreSQL

  Por ejemplo:

  jdbc:google:postgresql://my-project:us-central1:my-instance/my-db

  No agregues el nombre ni el ID de organización como prefijo a la cadena de conexión y quita los espacios de la URL.

Nota: Data Studio no valida el campo URL de JDBC antes de intentar conectarse. Una URL de JDBC no válida o la falta de permisos de IAM pueden hacer que Data Studio deje de responder mientras se cargan las tablas en lugar de mostrar un mensaje de error.

Acceso al firewall y a la base de datos

Para permitir que Data Studio se conecte a las bases de datos que están detrás de un firewall y realice consultas en ellas, deberás abrir el acceso a una de las siguientes direcciones IP. También es posible que 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/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 PostgreSQL de Cloud SQL. Si te conectas a una instancia de PostgreSQL de Cloud SQL 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 certificadora (AC).

• 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, se truncarán los datos.

• Los encabezados de columna (nombres de campo) solo deben usar 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 habituales y los pasos para resolverlos.

Recursos relacionados

Cómo crear una fuente de datos