Se connecter à MySQL

Le connecteur MySQL vous permet d'accéder aux données de bases de données MySQL dans Looker Studio.

Se connecter à MySQL

Une source de données Looker Studio ne peut être connectée qu'à une seule table de base de données MySQL.

Le connecteur MySQL de Looker Studio est basé sur Google Cloud SQL pour MySQL. De plus, il est soumis aux mêmes restrictions concernant les versions et les fonctionnalités compatibles. En savoir plus sur Google Cloud SQL pour MySQL

Versions compatibles

Nous avons testé Looker Studio dans 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.

Pour vous connecter

Étape 1

Connectez-vous à Looker Studio.

Étape 2

Sur la page d'accueil de Looker Studio, en haut à gauche, cliquez sur  Créer, puis sélectionnez Source de données.

Étape 3

Sélectionnez le connecteur MySQL.

Étape 4

Configurez la connexion à votre base de données à l'aide d'un nom d'hôte ou d'une adresse IP, ou d'une URL JDBC.

Se connecter via un nom d'hôte ou une adresse IP

Dans la connexion, sélectionnez STANDARD . Saisissez les informations de connexion:

  • Nom d'hôte ou adresse IP
  • Port (facultatif)
  • Base de données
  • Nom d'utilisateur
  • Mot de passe

Se connecter à l'aide d'une URL JDBC

Dans la connexion, sélectionnez URL JDBC . Saisissez les informations de connexion:

  • URL JDBC

    • Exemple jdbc:mysql://HOSTNAME[:PORT];databaseName=DATABASE

  • Nom d'utilisateur
  • 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: mysql ://[2001:db8:1:1:1:1:1:1]/your_db

Étape 5

Activer SSL

Looker Studio accepte les connexions sécurisées (chiffrées) au serveur à l'aide du protocole TLS (Transport Layer Security), également désigné par l'acronyme SSL (Secure Sockets Layer). Pour activer une connexion sécurisée, cochez Activer SSL, puis fournissez vos fichiers de configuration SSL.

Ce paramètre n'est pas obligatoire pour Looker Studio, mais il peut l'être pour la configuration de votre base de données. Pour en savoir plus, contactez votre fournisseur de base de données.

Étape 6

Activer l'authentification client

Lorsque cette case est cochée, vous pouvez importer une clé privée et un certificat client si l'accès à votre base de données est requis.

Ce paramètre n'est pas obligatoire pour Looker Studio, mais il peut l'être pour la configuration de votre base de données. Pour en savoir plus, contactez votre fournisseur de base de données.

Étape 7

Cliquez sur AUTHENTIFIER.

Étape 8

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.

Étape 9

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

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.

Pare-feu et accès à la base de données

Pour autoriser Looker Studio à se connecter aux bases de données qui se trouvent derrière un pare-feu et à les interroger, vous devez ouvrir l'accès à l'une des adresses IP suivantes. Vous devrez peut-être également configurer votre base de données pour qu'elle accepte le trafic provenant de ces adresses. Pour savoir comment procéder, consultez la documentation de votre base de données.

Adresses IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (facultatif, pour les plates-formes compatibles avec IPv6)

Limites du connecteur 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.

Créer une source de données