Conectarse a Google Cloud SQL para MySQL

Cloud SQL para MySQL es un servicio de base de datos totalmente gestionado que te permite configurar, mantener y gestionar tus bases de datos MySQL relacionales en Google Cloud. El conector de Cloud SQL para MySQL le permite acceder a la información de las bases de datos de Cloud SQL para MySQL en Data Studio.

Versiones compatibles

El conector de Cloud SQL para MySQL se ha testado en las siguientes versiones de MySQL:

  • 5,6
  • 5,7
  • 8,0

Si tienes problemas 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 solicitudes de funciones y votar por ellas en el sistema de seguimiento de problemas.

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

Para conectarse

  1. Inicia sesión en Data Studio.
  2. En la parte superior izquierda de la página principal de Data Studio, haz clic en El icono de crear. Crear y, a continuación, selecciona Fuente de datos.
  3. Selecciona el conector de Cloud SQL para MySQL.
  4. Si se le solicita, autorice a Data Studio a acceder a los datos.

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

    • Para conectarse con un nombre de host o una dirección IP
      1. En la parte izquierda, selecciona BÁSICA .
      2. Introduce los detalles de conexión:
        1. Nombre de conexión de la instancia
        2. Base de datos
        3. Nombre de usuario
        4. Contraseña
    • Para conectarse con una URL de JDBC, siga estos pasos:
      1. En la parte izquierda, selecciona URL de JDBC .
      2. Introduce los detalles de conexión:
        1. URL de JDBC

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

        2. Nombre de usuario
        3. Contraseña
      > Si usa el nombre de host JDBC para realizar la conexión, las herramientas de petición de DNS públicas como Whois le permiten comprobar si es accesible.
    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
    • Nota : Data Studio no se puede conectar a localhost. Debes usar un nombre de host o una dirección IP públicos.

  6. Haz clic en AUTENTICARSE.

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

Por ejemplo, el siguiente no funcionará 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;

Las consultas de Data Studio pueden agotar el tiempo de espera 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 la consulta para que se ejecute más rápido.
  • Ejecuta las consultas en tu base de datos y almacena los resultados en otra tabla. Conecta la nueva tabla a tu fuente de datos.
  1. Haz clic en CONECTAR.

En breve, aparecerá la página de la lista de campos de la fuente de datos. Haz clic en CREAR INFORME para empezar a visualizar los datos.

Notas

Buscar el nombre de conexión de la instancia

El nombre de conexión de la 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

  1. Ve a https://console.cloud.google.com/sql/instances.
  2. Haz clic en el ID de instancia al que te quieras conectar.
  3. 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

Data Studio asigna 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 su tabla o consulta, no creará ningún campo para esa columna.

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

Límites del conector de Cloud SQL para 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.