Connecteur Looker-Tableau (version Preview publique)

Le connecteur Looker-Tableau vous permet d'utiliser Tableau Desktop pour vous connecter aux données d'une exploration Looker. Le connecteur Looker-Tableau s'appuie sur l'interface Open SQL de Looker, qui permet d'accéder aux modèles LookML et aux explorations pour les applications utilisant JDBC pour se connecter à des sources de données. Pour en savoir plus, consultez la documentation sur l'interface SQL ouverte.

Ce guide est destiné à la version Preview publique du connecteur Looker-Tableau. Pour poser des questions ou partager vos commentaires, envoyez un e-mail à l'adresse tableau-looker@google.com.

Conditions requises

Les composants suivants sont requis pour utiliser le connecteur Looker-Tableau:

De plus, vous devez effectuer les étapes suivantes avant de configurer le connecteur Looker-Tableau:

Configuration de Tableau Desktop pour se connecter à Looker

Pour utiliser le connecteur Looker-Tableau dans la version Preview publique, vous devez procéder comme suit:

  1. Ajouter l'application Tableau OAuth à votre instance Looker: un administrateur Looker doit utiliser l'API Looker pour enregistrer l'application Tableau OAuth pour le connecteur Looker-Tableau sur votre instance Looker. L'application Tableau OAuth ne doit être enregistrée qu'une seule fois pour chaque instance Looker et s'applique à tous les utilisateurs de l'instance Looker.
  2. Téléchargez et enregistrez le fichier Tableau Connector et le fichier de pilote JDBC: chaque utilisateur qui souhaite accéder au connecteur Looker-Tableau doit télécharger le fichier avatica-<release_number>-looker.jar et le fichier du connecteur Tableau empaqueté (.taco), puis enregistrer les fichiers dans des répertoires spécifiques sur son ordinateur.

Les sections suivantes décrivent ces étapes en détail.

Ajouter l'application Tableau OAuth à votre instance Looker

Le connecteur Looker-Tableau nécessite que vous disposiez de l'application Tableau OAuth sur votre instance Looker. Le moyen le plus simple d'enregistrer l'application Tableau OAuth sur votre instance Looker consiste à utiliser l'explorateur d'API de Looker.

Si APIs Explorer est déjà installé sur votre instance Looker, vous pouvez y accéder avec ce format d'URL:

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

Si votre instance Looker ne dispose pas d'APIs Explorer, vous pouvez l'installer à partir du Marketplace Looker. Pour en savoir plus, consultez la page Utiliser l'explorateur d'API.

Utilisez APIs Explorer pour enregistrer l'application Tableau OAuth sur votre instance Looker, comme décrit dans les étapes suivantes:

  1. Ouvrez l'explorateur d'API Looker (pour en savoir plus, consultez la page Utiliser l'explorateur d'API).
  2. Dans le champ Search (Rechercher) de l'explorateur d'API, saisissez Register OAuth App (Enregistrer une application OAuth).
  3. Dans les résultats de recherche, cliquez sur Register OAuth App (Enregistrer une application OAuth).
  4. Sur la page Register OAuth App (Enregistrer l'application OAuth), cliquez sur le bouton Run It (Exécuter).

  5. Dans l'onglet Request (Requête) de la boîte de dialogue Run It (Exécuter), saisissez les informations suivantes dans les champs correspondants:

    • client_guid:

      35FBB268-0CB0-4822-AFE3-28638C1C6269

    • body:

      {
"redirect_uri": "http://localhost:55556/Callback",
"display_name": "Tableau Desktop",
"description": "Tableau Desktop client for JDBC Server",
"enabled": true,
"group_id": ""
}

  6. Cochez la case Je comprends que ce point de terminaison de l'API modifiera les données.

  7. Cliquez sur Exécuter.

  8. Vous pouvez vérifier que vous avez bien enregistré l'application Tableau OAuth à l'aide de la méthode Get OAuth Client App dans APIs Explorer:

    • Dans le champ Search (Rechercher) de l'explorateur d'API, saisissez Get OAuth Client App (Obtenir une application cliente OAuth).
    • Cliquez sur Exécuter.

    • Dans le champ client_guid, saisissez la valeur de l'application Tableau OAuth:

      35FBB268-0CB0-4822-AFE3-28638C1C6269

    Si vous avez réussi à enregistrer l'application Tableau OAuth, l'onglet Response (Réponse) affiche les valeurs que vous avez saisies lors de l'enregistrement de l'application.

Cette étape n'est pas nécessaire. Toutefois, si à l'avenir vous n'utilisez plus le connecteur Looker–Tableau et que vous souhaitez supprimer l'application Tableau OAuth, consultez la section Suppression de l'application OAuth.

Télécharger et enregistrer les fichiers du connecteur

Pour utiliser le connecteur Looker-Tableau, chaque utilisateur de Tableau doit télécharger ces deux fichiers:

Les sections suivantes expliquent comment télécharger ces fichiers et où les placer sur votre ordinateur.

Fichier du connecteur Tableau (.taco)

Le fichier du connecteur Tableau s'appelle looker-jdbc-v0.2.0.taco. Chaque utilisateur doit télécharger le fichier .taco et l'enregistrer sur son ordinateur en procédant comme suit:

  1. Pour télécharger le fichier du connecteur Tableau, cliquez sur le lien suivant: looker-jdbc-v0.2.0.taco.

  2. Une fois le téléchargement terminé, déplacez le fichier looker-jdbc-v0.2.0.taco vers le sous-répertoire Connectors du répertoire My Tableau Repository. Voici les chemins d'accès par défaut aux répertoires:

    • Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors

    • MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors

Fichier du pilote JDBC (looker.jar)

Le pilote JDBC s'appelle avatica-<release_number>-looker.jar. Chaque utilisateur doit télécharger le fichier looker.jar depuis GitHub et l'enregistrer sur son ordinateur en procédant comme suit:

  1. Accédez à https://github.com/looker-open-source/calcite-avatica/releases.
  2. Téléchargez la dernière version du fichier avatica-<release_number>-looker.jar.

  3. Enregistrez le fichier avatica-<release_number>-looker.jar sur l'ordinateur de chaque utilisateur à l'emplacement suivant:

    • Windows: C:\Program Files\Tableau\Drivers

    • MacOS: /Library/JDBC ou ~/Library/JDBC

Connexion aux données Looker depuis Tableau Desktop

Après avoir ajouté l'application Tableau OAuth à votre instance Looker et téléchargé les fichiers looker-jdbc-v0.2.0.taco et avatica-<release_number>-looker.jar, vous pouvez utiliser Tableau Desktop pour vous connecter aux données de votre instance Looker en procédant comme suit:

  1. Dans Tableau Desktop, dans le volet Connecter de gauche, dans la section To a Server (À un serveur), sélectionnez l'option More... (Plus).
  2. Dans le champ de recherche, saisissez Looker JDBC by Google.
  3. Sélectionnez l'option Looker JDBC by Google.
  4. Dans la boîte de dialogue, saisissez les paramètres suivants :
    • Serveur: saisissez l'URL de votre instance Looker sans le https://. Par exemple : example.cloud.looker.com.
    • Port : 443
    • Authentication (Authentification) : OAuth
    • OAuth Instance Url (URL de l'instance OAuth) : saisissez l'URL complète de votre instance Looker avec le https://. Par exemple : https://example.cloud.looker.com.
  5. Sélectionnez Se connecter. Tableau ouvre une fenêtre de navigateur pour se connecter à votre instance Looker et authentifier votre compte avec OAuth.
  6. Si vous y êtes invité, saisissez vos identifiants OAuth. Si vous êtes déjà connecté, vous verrez un message dans la fenêtre du navigateur indiquant que Tableau a utilisé la fenêtre du navigateur pour s'authentifier dans Looker et que vous pouvez maintenant fermer la fenêtre du navigateur.
  7. Une fois que vous vous êtes authentifié dans Looker, Tableau ouvre une page Source de données avec une connexion à votre instance Looker.
  8. Utilisez le menu déroulant Schema (Schéma) pour sélectionner un model Looker avec les données que vous souhaitez afficher dans Tableau Desktop. Tableau remplit la liste Table avec les explorations Looker à partir du modèle Looker que vous avez sélectionné.
  9. Pour commencer à explorer les données, sélectionnez un objet de la liste Tables et faites-le glisser sur la toile.

Identifier les requêtes du connecteur Looker-Tableau dans l'interface utilisateur de Looker

Les requêtes de Tableau sont effectuées via l'interface Open SQL. Les administrateurs Looker peuvent l'utiliser pour identifier les requêtes qui proviennent de l'interface Open SQL, comme décrit dans la documentation de l'interface SQL ouverte.

Les requêtes du connecteur Looker–Tableau ont une valeur Source de "sql_interface" ou "Sql Interface".

Éléments à prendre en compte

Lorsque vous explorez des données Looker avec Tableau Desktop, tenez compte des points suivants:

  • Le connecteur Looker–Tableau s'appuie sur l'interface Open SQL de Looker et présente les mêmes limitations LookML que l'interface Open SQL. Pour en savoir plus, consultez la documentation sur l'interface SQL ouverte.
  • Tableau interroge automatiquement la base de données chaque fois qu'une modification est apportée à la requête, y compris lorsque des champs sont ajoutés et supprimés à l'aide du connecteur Looker-Tableau. Vous pouvez désactiver les mises à jour automatiques dans Tableau: consultez la documentation Tableau pour en savoir plus.
  • Vous ne pouvez pas utiliser Tableau pour joindre deux explorations Looker. Pour joindre des explorations, utilisez Looker pour créer les jointures dans votre modèle Looker. Consultez les pages Utiliser des jointures dans LookML et les paramètres de jointure de la documentation Looker pour en savoir plus sur l'utilisation des jointures dans Looker.

Pour signaler un bug

Pour signaler un bug, envoyez un e-mail à l'adresse tableau-looker@google.com avec les informations suivantes:

  • Une liste détaillée des étapes que vous avez suivies
  • Le comportement attendu
  • Le comportement réel (avec une capture d'écran, si possible)

Supprimer l'application Tableau OAuth (facultatif)

Cette étape n'est pas obligatoire. Toutefois, si à l'avenir vous n'utilisez plus le connecteur Looker-Tableau et que vous souhaitez supprimer l'application Tableau OAuth de votre instance Looker, vous pouvez le faire avec APIs Explorer en procédant comme suit:

  1. Ouvrez l'explorateur d'API Looker (pour en savoir plus, consultez la page Utiliser l'explorateur d'API).
  2. Dans le champ Rechercher de l'explorateur d'API, saisissez Delete OAuth Client App (Supprimer l'application cliente OAuth).
  3. Dans les résultats de recherche, cliquez sur Supprimer une application cliente OAuth.
  4. Sur la page Supprimer une application cliente OAuth, cliquez sur le bouton Exécuter.

  5. Dans l'onglet Request (Requête) de la boîte de dialogue Run It (Exécuter), saisissez la valeur client_guid de l'application Tableau OAuth:

    35FBB268-0CB0-4822-AFE3-28638C1C6269

  6. Cochez la case Je comprends que ce point de terminaison de l'API modifiera les données.

  7. Vous pouvez vérifier que vous avez bien supprimé l'application Tableau OAuth à l'aide de la méthode Get OAuth Client App dans APIs Explorer:

    • Dans le champ Search (Rechercher) de l'explorateur d'API, saisissez Get OAuth Client App (Obtenir une application cliente OAuth).
    • Cliquez sur Exécuter.

    • Dans le champ client_guid, saisissez la valeur de l'application Tableau OAuth:

      35FBB268-0CB0-4822-AFE3-28638C1C6269

    Si vous avez réussi à supprimer l'application Tableau OAuth, l'onglet Response (Réponse) affichera des valeurs de corps vides.