Connecteur Looker – Tableau BI

Le connecteur Looker – Tableau BI vous permet d'utiliser une exploration Looker comme source de données dans Tableau. Le connecteur Looker-Tableau BI est basé sur l'interface SQL ouverte de Looker, qui permet d'accéder aux modèles LookML et aux explorations pour les applications qui utilisent JDBC pour se connecter aux sources de données. Pour en savoir plus, consultez la documentation sur l'interface Open SQL.

Avant de commencer

Votre instance Looker doit répondre aux exigences suivantes pour pouvoir utiliser le connecteur Looker – Tableau BI:

  • Vous utilisez Looker 24.14 ou une version ultérieure.
  • Activé pour le connecteur d'informatique décisionnelle Tableau Desktop. Un administrateur Looker doit activer l'option Tableau Desktop sur la page Connecteurs d'informatique décisionnelle de Looker.
  • Contient un projet LookML qui utilise les données d'une connexion Google BigQuery :
    • Le projet LookML doit être configuré de sorte que le champ Connexions autorisées soit défini sur l'option Uniquement ces connexions, avec au moins une connexion Google BigQuery sélectionnée. Pour en savoir plus sur la configuration d'un modèle et consulter les connexions autorisées pour celui-ci, consultez la page de documentation Accéder et modifier les informations du projet.
    • Le projet LookML doit comporter un fichier de modèle qui spécifie une connexion BigQuery dans son paramètre connection.

De plus, chaque personne qui utilise le connecteur d'informatique décisionnelle Looker-Tableau doit disposer d'un compte Looker avec un rôle utilisateur qui inclut l'autorisation explore sur le modèle LookML auquel elle souhaite accéder depuis Tableau.

Configurer Tableau Desktop pour se connecter à Looker

Une fois que vous avez rempli toutes les conditions requises, vous pouvez configurer Tableau Desktop pour vous connecter aux données Looker.

Chaque utilisateur qui souhaite accéder au connecteur Looker-Tableau BI doit télécharger le fichier avatica-<release_number>-looker.jar et le fichier de connecteur Tableau (TACO) empaqueté, puis les enregistrer dans des répertoires spécifiques sur son ordinateur. Les sections suivantes fournissent des instructions pour télécharger ces fichiers et les placer sur votre ordinateur:

Fichier du connecteur Tableau (TACO)

Le fichier du connecteur Tableau est appelé looker_v1.0.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_v1.0.0.taco.
  2. Une fois le téléchargement terminé, déplacez le fichier looker_v1.0.0.taco vers le sous-répertoire Connectors du répertoire My Tableau Repository. Voici les chemins d'accès aux répertoires par défaut:

    • Windows:

      C:\Users\\Windows user\Documents\My Tableau Repository\Connectors
      
    • MacOS:

      /Users/Mac 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

Se connecter aux données Looker depuis Tableau Desktop

Une fois que vous avez téléchargé et enregistré les fichiers looker_v1.0.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 Se connecter de gauche, dans la section À un serveur, sélectionnez l'option Plus.
  2. Dans le champ de recherche, saisissez Looker by Google.
  3. Sélectionnez l'option Looker by Google (Looker 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
    • Authentification: OAuth
    • URL de l'instance OAuth: saisissez l'URL complète de l'instance Looker avec 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é, connectez-vous à Looker. Si vous êtes déjà connecté, un message s'affiche 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 la fermer.
  7. Une fois que vous vous êtes authentifié dans Looker, Tableau ouvre la page Source de données avec une connexion à votre instance Looker.
  8. Dans le menu déroulant Schéma, sélectionnez un modèle Looker contenant les données que vous souhaitez afficher dans Tableau Desktop. Tableau insère dans la liste Table les explorations Looker du modèle Looker que vous avez sélectionné.
  9. Pour commencer à explorer les données, sélectionnez un objet dans la liste Tables et faites-le glisser vers le canevas.

Identifier les requêtes du connecteur d'informatique décisionnelle Looker-Tableau dans l'UI de Looker

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

Les requêtes du connecteur Looker-Tableau BI ont une valeur Source de "sql_interface" ou "SQL Interface".

Utiliser le connecteur Looker-Tableau BI sur Tableau Server

Le connecteur d'informatique décisionnelle Looker-Tableau n'est pas disponible sur Tableau Exchange, mais vous pouvez l'installer sur Tableau Server en suivant les procédures décrites dans les sections suivantes:

Avant de commencer

Votre instance Looker doit répondre aux conditions suivantes pour utiliser le connecteur Looker-Tableau BI sur Tableau Server:

  • Vous utilisez Looker 24.14 ou une version ultérieure.
  • Contient un projet LookML qui utilise les données d'une connexion Google BigQuery :
    • Le projet LookML doit être configuré de sorte que le champ Connexions autorisées soit défini sur l'option Uniquement ces connexions, avec au moins une connexion Google BigQuery sélectionnée. Pour en savoir plus sur la configuration d'un modèle et consulter les connexions autorisées pour celui-ci, consultez la page de documentation Accéder et modifier les informations du projet.
    • Le projet LookML doit comporter un fichier de modèle qui spécifie une connexion BigQuery dans son paramètre connection.

De plus, chaque personne qui utilise le connecteur Looker-Tableau BI doit disposer d'un compte Looker avec un rôle utilisateur qui inclut l'autorisation explore sur le modèle LookML auquel elle souhaite accéder depuis Tableau.

Configurer OAuth pour le connecteur Looker – Tableau BI

Pour utiliser le connecteur Looker-Tableau BI pour Tableau Server, vous devez configurer l'intégration OAuth sur votre instance Looker.

Vous pouvez utiliser l'explorateur d'API Looker pour configurer l'intégration OAuth du connecteur Looker-Tableau BI:

  • Si l'explorateur d'API est déjà installé dans votre instance Looker, vous pouvez y accéder avec le format d'URL suivant:

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
    
  • Si l'explorateur d'API n'est pas disponible dans votre instance Looker, vous pouvez l'installer depuis la place de marché Looker. Pour en savoir plus, consultez la page Utiliser l'API Explorer.

Pour configurer l'intégration OAuth sur votre instance Looker à l'aide de l'explorateur d'API, procédez comme suit:

  1. Ouvrez l'API Explorer Looker (pour en savoir plus, consultez la page Utiliser l'API Explorer).
  2. Dans le champ Rechercher d'API Explorer, saisissez Register OAuth App (Enregistrer une application OAuth).
  3. Dans les résultats de recherche, cliquez sur Enregistrer une application OAuth.
  4. Sur la page Register OAuth App (Enregistrer une application OAuth), cliquez sur le bouton Run It (Exécuter).
  5. Dans l'onglet Request (Demande) de la boîte de dialogue Run It (Exécuter), saisissez les informations suivantes dans les champs correspondants:

    • client_guid:
    tableau-server
    
    • body:
    {
      "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
      "display_name": "Looker-Tableau-Server (manual)",
      "description": "Client for Looker-Tableau Server integration (manually added)",
      "enabled": true,
      "group_id": ""
    }
    
  6. Cochez la case Je comprends que ce point de terminaison d'API modifiera les données.

  7. Cliquez sur Exécuter.

  8. Vous pouvez vérifier que vous avez bien configuré l'authentification à l'aide de la méthode Get OAuth Client App dans l'explorateur d'API:

    • Dans le champ Rechercher de l'explorateur d'API, saisissez Obtenir l'application cliente OAuth.
    • Cliquez sur Exécuter.
    • Dans le champ client_guid, saisissez la valeur suivante: tableau-server.

    Si vous avez correctement configuré OAuth, l'onglet Réponse affichera les valeurs que vous avez saisies lorsque vous avez enregistré l'application.

Installer le connecteur Looker-Tableau BI sur Tableau Server

Pour installer le connecteur Looker – Tableau BI sur Tableau Server, procédez comme suit:

  1. Téléchargez le fichier du connecteur Tableau en cliquant sur le lien suivant: looker_v1.0.0.taco.
  2. Téléchargez la dernière version du fichier avatica-<release_number>-looker.jar sur https://github.com/looker-open-source/calcite-avatica/releases.
  3. Installez les fichiers TACO et JAR sur la machine hôte de Tableau Server. L'emplacement des fichiers dépend du système d'exploitation du serveur. Les chemins d'installation par défaut de Tableau sont indiqués dans le tableau suivant:
Emplacement du fichier TACO Emplacement du fichier JAR
Serveur Linux
/opt/tableau/connectors
/opt/tableau/tableau_driver/jdbc
Windows Server
C:\Program Files\Tableau\Connectors
C:\Program Files\Tableau\Drivers

Terminer la configuration sur Tableau Server

Après avoir configuré OAuth pour le connecteur Looker-Tableau BI et installé le connecteur Looker-Tableau BI, vous pouvez terminer la configuration en procédant comme suit sur votre machine hôte Tableau Server:

Éléments à prendre en compte

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

  • Le connecteur Looker-Tableau BI est basé sur l'interface SQL ouverte de Looker. Il présente les mêmes limites LookML et SQL que l'interface SQL ouverte. Pour en savoir plus, consultez la documentation sur l'interface Open SQL.
  • 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 BI. Vous pouvez désactiver les mises à jour automatiques dans Tableau. Pour en savoir plus, consultez la documentation Tableau.
  • Vous ne pouvez pas utiliser Tableau pour joindre deux explorations Looker. Si vous souhaitez joindre des explorations, utilisez Looker pour créer les jointures dans votre modèle Looker. Pour en savoir plus sur l'utilisation des jointures dans Looker, consultez les pages de documentation Looker Utiliser des jointures dans LookML et Paramètres de jointure.
  • Le connecteur Looker-Tableau BI est conçu pour fonctionner avec une connexion en direct dans Tableau. Le mode d'extraction de données de Tableau extrait les mesures Looker avec une valeur de "null" et ne produit donc pas de résultats précis. Si vous souhaitez utiliser le mode d'extraction, vous pouvez créer des champs agrégables dans Tableau directement à partir des champs de dimension Looker au lieu d'utiliser des mesures Looker.

Passer de la version Preview publique du connecteur Looker-Tableau BI

Si vous avez participé à l'aperçu public du connecteur Looker-Tableau BI, votre configuration existante continuera de fonctionner telle quelle. Toutefois, nous vous recommandons de passer à la dernière version du connecteur Looker-Tableau BI.

Pour passer à la dernière version du connecteur Looker-Tableau BI, un administrateur Looker doit effectuer les tâches suivantes:

  1. Vérifiez que l'instance Looker répond aux exigences.
  2. Dans l'instance Looker, activez l'option Tableau Desktop sur la page Connecteurs d'informatique décisionnelle.

Une fois qu'un administrateur Looker a activé l'option Tableau Desktop dans l'instance Looker, les utilisateurs de votre instance Looker peuvent procéder comme suit pour utiliser le dernier connecteur Looker-Tableau BI:

Une fois que l'utilisateur a téléchargé et enregistré le fichier du connecteur Tableau et le fichier du pilote JDBC, il peut se connecter aux données Looker depuis Tableau Desktop. Les utilisateurs devront s'authentifier dans leur compte Looker dans le connecteur Looker-Tableau BI mis à niveau.

Une fois que tous les utilisateurs de votre instance Looker auront migré vers le nouveau connecteur Looker-Tableau BI, vous pourrez suivre la procédure pour supprimer l'application OAuth Tableau que vous avez ajoutée à votre instance Looker lors de la configuration de la version Preview publique.

Supprimer l'application OAuth Tableau (facultatif)

Cette procédure n'est pas obligatoire. Toutefois, une fois que tous les utilisateurs de votre instance Looker auront migré vers le fichier de connecteur Tableau looker_v1.0.0.taco, vous pourrez supprimer la version Preview privée de l'application OAuth Tableau de votre instance Looker en procédant comme suit:

  1. Ouvrez l'API Explorer Looker (pour en savoir plus, consultez la page Utiliser l'API Explorer).
  2. Dans le champ Rechercher de l'explorateur d'API, saisissez Supprimer l'application cliente OAuth.
  3. Dans les résultats de recherche, cliquez sur Supprimer l'application cliente OAuth.
  4. Sur la page Supprimer l'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 OAuth Tableau. Pour la version Preview publique du connecteur Looker – Tableau BI (v0.2.0), la valeur client_guid est la suivante:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
    
  6. Cochez la case Je comprends que ce point de terminaison d'API modifiera les données.

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

    • Dans le champ Rechercher de l'explorateur d'API, saisissez Obtenir l'application cliente OAuth.
    • Cliquez sur Exécuter.
    • Dans le champ client_guid, saisissez la valeur de l'application OAuth Tableau: 35FBB268-0CB0-4822-AFE3-28638C1C6269.

    Si vous avez bien supprimé l'application OAuth Tableau, l'onglet Réponse affichera des valeurs de corps vides.