Puedes conectar tus bases de datos de Cloud SQL para MySQL a Data Studio con el conector de Cloud SQL para MySQL. Usa las tablas de tu base de datos o las consultas personalizadas para crear informes y paneles interactivos. Luego, puedes compartir estas estadísticas con las partes interesadas o los miembros del equipo que no tienen acceso directo a la base de datos.
Versiones compatibles
El conector de Cloud SQL para MySQL se probó en las siguientes versiones de MySQL:
- 5.6
- 5.7
- 8.0
Si tienes problemas para usar una versión compatible, avísanos 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 Cloud SQL para MySQL
Una fuente de datos de Data Studio puede conectarse 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:
- 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 Cloud SQL para MySQL.
- 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 conexión con la instancia
- 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:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE
- Nombre de usuario
- Contraseña
Para conectarte con una dirección literal de IPv6, encierra la dirección 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 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;
Es posible que las consultas en Data Studio agoten 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.
Notas
Consulta las siguientes secciones para obtener detalles sobre cómo encontrar el nombre de conexión de tu instancia, configurar los permisos necesarios y configurar la conectividad de red.
Encuentra el nombre de conexión de tu instancia
El nombre de conexión de la instancia identifica tu instancia en Google Cloud. Puedes obtenerlo desde la Google Cloud consola o con la línea de comandos.
Usa la consola
- Navega a https://console.cloud.google.com/sql/instances.
- Haz clic en el ID de la instancia a la que deseas conectarte.
- A la izquierda, encontrarás el nombre de la conexión en la sección "Conéctate a esta instancia".
Usa la línea de comandos
Para encontrar el nombre de la conexión con la interfaz de línea de comandos de Cloud, usa el siguiente comando:
gcloud sql instances describe [INSTANCE_NAME] | grep connectionName
Permisos
Debes tener al menos el permiso cloudsql.client en el proyecto de Cloud SQL para MySQL para crear la conexión. Si no tienes (o no puedes obtener) este acceso, 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 conectividad de IP privada.
Debes configurar la conectividad de IP pública o la conectividad de IP privada para tu instancia de Cloud SQL para MySQL antes de usar el conector de Cloud SQL para MySQL.
Para permitir que Data Studio acceda a los datos en Cloud SQL y realice consultas en estos datos 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 tu instancia de Cloud SQL para MySQL.
Tipos de datos admitidos
Data Studio asigna los tipos de datos integrados de tu base de datos a un conjunto unificado de tipos de datos. Si Data Studio encuentra una columna en tu tabla o consulta de un tipo no admitido, no creará un campo para esa columna.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)
Límites del conector de Cloud SQL para MySQL
- Data Studio no admite las extensiones de datos espaciales de MySQL.
- 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.