Conéctate a Google Cloud SQL para MySQL

Cloud SQL para MySQL es un servicio de base de datos completamente administrado que te permite configurar, mantener, controlar y administrar tus bases de datos relacionales de MySQL en Google Cloud. El conector de Cloud SQL para MySQL te permite acceder a los datos de las bases de datos de Cloud SQL para MySQL en Data Studio.

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

  1. Accede a Data Studio.
  2. En la página principal de Data Studio, en la parte superior izquierda, haz clic en Ícono de Crear. Crear y, luego, selecciona Fuente de datos.
  3. Selecciona el conector de Cloud SQL para MySQL.
  4. Si se te solicita, autoriza a Data Studio para que acceda a tus datos.

  5. Configura la conexión a tu base de datos:

    • Para conectarte con un nombre de host o una dirección IP
      1. A la izquierda, selecciona BÁSICO .
      2. Ingresa los detalles de la conexión:
        1. Nombre de conexión con la instancia
        2. Base de datos
        3. Nombre de usuario
        4. Contraseña
    • Para conectarte con una URL de JDBC
      1. A la izquierda, selecciona URL de JDBC .
      2. Ingresa los detalles de la conexión:
        1. URL de JDBC

          Ejemplo jdbc:google:mysql: //<instance connection name>/

        2. Nombre de usuario
        3. Contraseña
      > 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 literal de IPv6, encierra la dirección entre corchetes. Por ejemplo: jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • Nota : Data Studio no puede conectarse a localhost. Debes usar un nombre de host público o una dirección IP.

  6. Haz clic en AUTENTICAR.

  7. Selecciona una tabla de la lista o ingresa una 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.

Por ejemplo, lo 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.
  1. Haz clic en CONECTAR.

En un momento, aparecerá la página de la lista de campos de la fuente de datos. Haz clic en CREAR INFORME para comenzar a visualizar tus datos.

Notas

Cómo encontrar el nombre de conexión de la instancia

El nombre de conexión de la instancia identifica tu instancia en Google Cloud. Puedes obtenerlo de la Google Cloud console o con la línea de comandos.

Usa la consola

  1. Navega a https://console.cloud.google.com/sql/instances.
  2. Haz clic en el ID de la instancia a la que deseas conectarte.
  3. 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

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 compatible, no creará un campo para esa columna.

Nota : Data Studio no admite las extensiones de datos espaciales de MySQL.

Límites del conector de Cloud SQL para MySQL

  • 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. Los caracteres que no son ASCII no son compatibles.

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.