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 Open SQL de Looker, qui permet d'accéder aux modèles et aux explorations LookML pour les applications qui utilisent JDBC pour se connecter à des sources de données. Pour en savoir plus, consultez la documentation sur l'interface SQL ouverte.

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 toutes les exigences sont remplies, 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 TACO empaqueté, puis enregistrer les fichiers 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 de connecteur Tableau s'appelle looker_v1.0.0.taco. Chaque utilisateur doit télécharger le fichier TACO et l'enregistrer sur son ordinateur en suivant les étapes ci-dessous:

  1. Pour télécharger le fichier de 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 les ordinateurs 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

Après avoir 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.
  4. Dans la boîte de dialogue, saisissez les paramètres suivants:
    • Server (Serveur) : saisissez l'URL de votre instance Looker sans 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'affichera dans la fenêtre du navigateur indiquant que Tableau a utilisé la fenêtre du navigateur pour s'authentifier auprès de Looker et que vous pouvez maintenant fermer la fenêtre du navigateur.
  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 renseigne la liste Tableau avec les explorations Looker du modèle Looker que vous avez sélectionné.
  9. Pour commencer à explorer les données, sélectionnez un objet de la liste Tableaux et faites-le glisser sur le canevas.

Identifier les requêtes du connecteur d'informatique décisionnelle 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 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".

Utilisation du connecteur Looker-Tableau BI sur Tableau Server

Le connecteur Looker-Tableau BI 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 exigences 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 incluant 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 APIs Explorer est déjà installé sur votre instance Looker, vous pouvez y accéder au 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 Marketplace Looker. Consultez la page Utiliser APIs Explorer pour plus d'informations.

Pour utiliser APIs Explorer afin de configurer l'intégration OAuth sur votre instance Looker, 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 Register OAuth App (Enregistrer l'application OAuth).
  4. Sur la page Enregistrer l'application OAuth, cliquez sur le bouton 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 correctement configuré l'authentification à l'aide de la méthode Get OAuth Client App dans APIs Explorer:

    • 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 réussi à configurer 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 de 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 à l'adresse 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

Une fois que vous avez configuré OAuth pour le connecteur Looker-Tableau BI et installé le connecteur Looker-Tableau BI, vous pouvez terminer la configuration en effectuant les procédures suivantes 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 Open SQL de Looker et présente les mêmes limitations LookML et SQL que l'interface SQL ouverte. 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 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 Utiliser des jointures dans LookML et Paramètres de jointure de la documentation de Looker.
  • 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.

Mise à niveau à partir de la version Preview publique du connecteur Looker-Tableau BI

Si vous faisiez partie de la version Preview publique du connecteur Looker-Tableau BI, votre configuration existante continuera de fonctionner telle quelle. Toutefois, nous vous recommandons d'effectuer une mise à niveau vers la dernière version du connecteur Looker-Tableau BI.

Pour effectuer la mise à niveau vers 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. Sur l'instance Looker, activez le bouton Tableau Desktop sur la page BI Connectors (Connecteurs d'informatique décisionnelle).

Une fois qu'un administrateur Looker a activé le bouton d'activation/de désactivation 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 qu'un utilisateur a téléchargé et enregistré le fichier Tableau Connector et le fichier du pilote JDBC, il peut se connecter aux données Looker à partir de 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 Tableau OAuth de votre instance Looker 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 de recherche 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 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 Tableau OAuth. 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 de l'API va modifier 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 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) renverra des valeurs de corps vides.