Se connecter à Google Cloud SQL pour MySQL

Cloud SQL pour MySQL est un service de base de données entièrement géré qui permet de configurer, entretenir, gérer et administrer rapidement vos bases de données relationnelles MySQL dans Cloud Platform. Le connecteur Cloud SQL pour MySQL vous permet d'accéder aux données des bases de données Cloud SQL pour MySQL dans Looker Studio.

Versions compatibles

Le connecteur Cloud SQL pour MySQL a été testé sur les versions suivantes de MySQL:

  • 5,6
  • 5,7
  • 8

Si vous rencontrez des problèmes lors de l'utilisation d'une version compatible, veuillez nous en informer via la communauté d'aide Looker Studio. Pour ajouter des demandes de fonctionnalités et voter pour vos préférées, cliquez ici.

Se connecter à Cloud SQL pour MySQL

Une source de données Looker Studio ne peut être associée qu'à une seule table de base de données Cloud SQL pour MySQL ou à une requête personnalisée que vous fournissez.

Pour vous connecter

  1. Connectez-vous à Looker Studio.
  2. Sur la page d'accueil de Looker Studio, en haut à gauche, cliquez sur Icône Créer Créer, puis sélectionnez Source de données.
  3. Sélectionnez le connecteur Cloud SQL pour MySQL.
  4. Si vous y êtes invité, autorisez Looker Studio à accéder à vos données.
  5. Configurez la connexion à votre base de données:

    • Pour vous connecter avec un nom d'hôte ou une adresse IP
      1. Sur la gauche, sélectionnez STANDARD .
      2. Saisissez les informations de connexion:
        1. Nom de connexion de l'instance (découvrez comment lister vos connexions d'instance ci-dessous).
        2. Base de données
        3. Nom d'utilisateur
        4. Mot de passe
    • Pour vous connecter via une URL JDBC :
      1. Sur la gauche, sélectionnez URL JDBC .
      2. Saisissez les informations de connexion:
        1. URL JDBC

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

        2. Nom d'utilisateur
        3. Mot de passe
      > Si vous utilisez l'option de nom d'hôte JDBC, vous pouvez vérifier qu'il est accessible grâce à des outils de résolution DNS public (comme WHOIS).
    Pour vous connecter à l'aide d'une adresse IPv6 littérale, placez-la entre crochets. Par exemple: jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • Remarque : Looker Studio ne peut pas se connecter à localhost. Vous devez utiliser un nom d'hôte ou une adresse IP publics.
  6. Cliquez sur AUTHENTIFIER.

  7. Sélectionnez une table dans la liste ou saisissez une requête personnalisée.

Sélectionnez l'option REQUÊTE PERSONNALISÉE pour fournir une requête SQL au lieu d'établir une connexion à un seul tableau. Looker Studio utilise ce code SQL personnalisé comme instruction de sélection interne pour chaque requête générée vers la base de données.

Par exemple, la requête suivante ne fonctionnera pas, car elle comporte plusieurs instructions 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;

Les requêtes dans Looker Studio peuvent expirer au bout de trois à cinq minutes. Si vos requêtes personnalisées expirent, essayez les approches suivantes pour résoudre le problème:

  • Simplifiez la requête pour qu'elle s'exécute plus rapidement.
  • Exécutez la requête dans votre base de données et stockez les résultats dans une table distincte. Connectez la nouvelle table dans votre source de données.
  1. Cliquez sur ASSOCIER.

La page listant les champs de la source de données va bientôt s'afficher. Cliquez sur CRÉER UN RAPPORT pour commencer à visualiser vos données.

Remarques

Trouver le nom de connexion de votre instance

Le nom de connexion de l'instance identifie votre instance sur Google Cloud. Vous pouvez l'obtenir en utilisant la console Google Cloud ou la ligne de commande.

Utiliser la console

  1. Accédez à https://console.cloud.google.com/sql/instances.
  2. Cliquez sur l'ID de l'instance à laquelle vous souhaitez vous connecter.
  3. Le nom de la connexion s'affiche à gauche, dans la section "Se connecter à cette instance".

Utiliser la ligne de commandes

Pour trouver le nom de la connexion via l'interface de ligne de commande Cloud, utilisez la commande suivante:


gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

Autorisations

Vous devez disposer au moins de l'autorisation cloudsql.client dans le projet Cloud SQL pour MySQL pour établir la connexion. Si vous ne disposez pas de cet accès (ou ne parvenez pas à l'obtenir), vous pouvez utiliser le connecteur MySQL à la place.

Connectivité réseau

Le connecteur Cloud SQL pour MySQL accepte les connexions aux instances Cloud SQL pour MySQL avec une connectivité IP publique ou privée.

Vous devez configurer une connectivité IP publique ou une connectivité IP privée pour votre instance Cloud SQL pour MySQL avant d'utiliser le connecteur Cloud SQL pour MySQL.

Pour autoriser Looker Studio à accéder aux données dans Cloud SQL et à les interroger avec une connexion privée, sélectionnez l'option Chemin d'accès privé pour les services Google Cloud dans les paramètres d'instance Cloud SQL pour MySQL.

Types de données

Looker Studio mappe les types de données intégrés de votre base de données avec un ensemble unifié de types de données. Lorsque Looker Studio trouve une colonne de votre tableau ou une requête dont le type n'est pas compatible, aucun champ n'est créé pour cette colonne.

Remarque : Looker Studio n'est pas compatible avec les extensions de données spatiales de MySQL.

Limites du connecteur Cloud SQL pour MySQL

  • Ce connecteur vous permet de lancer une requête sur 150 000 lignes par requête au maximum. Si vous dépassez cette limite, les données seront tronquées.
  • Les en-têtes de colonne (noms de champs) ne doivent contenir que des caractères ASCII. Aucun autre caractère n'est accepté.

Dépannage

Consultez le guide de dépannage de Looker Studio pour obtenir la liste des messages d'erreur courants et la marche à suivre pour les résoudre.