Puedes conectar tus bases de datos de Cloud SQL para MySQL a Data Studio mediante el conector de Cloud SQL para MySQL. Usa las tablas de tu base de datos o consultas personalizadas para crear informes y paneles de control interactivos. Después, puedes compartir esta información con los colaboradores o los miembros del equipo que no tengan acceso directo a la base de datos.
Versiones compatibles
El conector de Cloud SQL para MySQL se ha probado en las siguientes versiones de MySQL:
- 5,6
- 5,7
- 8,0
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 la herramienta de seguimiento de incidencias.
Cómo conectarse a Cloud SQL para MySQL
Una fuente de datos de Data Studio se puede conectar a una sola tabla de base de datos de Cloud SQL para MySQL o a una consulta personalizada que proporciones.
Para conectarte a tu base de datos de Cloud SQL para MySQL, sigue estos pasos:
- Inicia sesión en Data Studio.
- En la página principal de Data Studio, haz clic en Crear y, a continuación, selecciona Fuente de datos.
- Selecciona el conector de Cloud SQL para MySQL.
- Configura el acceso a tu base de datos utilizando una de las opciones de conexión.
- Haz clic en AUTHENTICATE. Aparecerá la lista de las tablas de esa base de datos.
- Selecciona una tabla de la lista o introduce una consulta personalizada.
- Haz clic en CONECTAR.
Ahora puedes usar todas las columnas de dicha tabla como campos en los informes.
Opciones de conexión
Conectarse con un nombre de host o una dirección IP
En el panel de conexión, selecciona BÁSICA. Introduce los detalles de conexión:
- Nombre de conexión de la instancia
- Base de datos
- Nombre de usuario
- Contraseña
Conectarse mediante una URL de JDBC
En el panel de conexión, selecciona URL de JDBC. Introduce los detalles de conexión:
- URL de JDBC
Ejemplo
jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE
- Nombre de usuario
- Contraseña
Para conectarte a través de una dirección literal IPv6, escríbela entre corchetes. Por ejemplo:
jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db
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.
Las consultas de SQL personalizadas solo pueden tener una instrucción. El ejemplo siguiente no funciona porque tiene varias instrucciones 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;
Puede que se agote el tiempo de espera de las consultas de Data Studio 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 de tu fuente de datos.
Notas
Consulta las siguientes secciones para obtener información sobre cómo encontrar el nombre de conexión de tu instancia, configurar los permisos necesarios y configurar la conectividad de red.
Buscar el nombre de conexión de la instancia
El nombre de conexión de instancia identifica tu instancia en Google Cloud. Puedes obtenerlo en la consola de Google Cloud o usando la línea de comandos.
Usar la consola
- Ve a https://console.cloud.google.com/sql/instances.
- Haz clic en el ID de instancia al que te quieras conectar.
- En la parte izquierda, en la sección "Conectar a esta instancia", verás el nombre de la conexión.
Usar la línea de comandos
Para buscar el nombre de la conexión con la interfaz de la línea de comandos de Cloud, usa este comando:
gcloud sql instances describe [INSTANCE_NAME] | grep connectionName
Permisos
Para crear la conexión, debes tener al menos el permiso cloudsql.client en el proyecto de Cloud SQL para MySQL. Si no lo tienes o no tienes posibilidad de conseguirlo, puedes usar el conector de MySQL en su lugar.
Conectividad de red
El conector de Cloud SQL para MySQL admite conexiones a instancias de Cloud SQL para MySQL con conectividad de IP pública y privada.
Antes de usar el conector de Cloud SQL para MySQL, debes configurar la conectividad de IP pública o la conectividad de IP privada para tu instancia de Cloud SQL para MySQL.
Para permitir que Data Studio acceda a los datos de Cloud SQL y haga consultas sobre ellos a través de una conexión privada, selecciona la opción Ruta privada para los servicios de Google Cloud en la configuración de la instancia de Cloud SQL para MySQL.
Tipos de datos admitidos
Data Studio asocia los tipos de datos integrados de la base de datos a un conjunto unificado de tipos de datos. Si Data Studio encuentra una columna de un tipo no compatible en tu tabla o consulta, no creará ningún campo para esa columna.Cortafuegos y acceso a la base de datos
Para permitir que Data Studio se conecte a bases de datos protegidas por un cortafuegos y las consulte, 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 específica de tu base de datos para obtener instrucciones al respecto.
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 compatibles con IPv6)
Si has habilitado la residencia de datos en tu suscripción a Data Studio Pro, usa las siguientes direcciones:
142.251.56.0/242001:4860:4815::/48(opcional, para plataformas compatibles con IPv6)
Límites del conector de Cloud SQL para MySQL
- Data Studio no admite extensiones de datos espaciales de MySQL.
- 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.