Connecteur Looker-Excel

Le connecteur Looker-Excel vous permet d'exporter des requêtes d'une exploration Looker vers un format reconnu par Microsoft Excel. Lorsque le connecteur Looker-Excel est activé, les explorations Looker affichent l'option Ouvrir dans Excel dans le menu en forme de roue dentée de l'exploration. Lorsque vous sélectionnez cette option, Looker exporte la requête d'exploration vers un fichier ODC sur votre PC Windows. Si le pilote ODBC est installé, vous pouvez ouvrir le fichier ODC dans Microsoft Excel pour Windows.

Avant de commencer

Pour utiliser le connecteur Looker-Excel, vous devez disposer des éléments suivants :

  • Un PC Windows 64 bits ou 32 bits.
  • Une instance Looker qui répond aux exigences suivantes :
    • Exécuter Looker 25.16 ou une version ultérieure.
    • Activé pour le connecteur BI Microsoft Excel. Un administrateur Looker doit activer le client Microsoft Excel préconfiguré depuis l'onglet Bibliothèque d'applications de la page Gérer les clients OAuth (Admin > Authentification > Gérer les clients OAuth) ou activer le bouton Microsoft Excel sur la page Connecteurs d'informatique décisionnelle de Looker.
  • Un compte Looker avec un rôle utilisateur incluant l'autorisation explore sur le modèle LookML auquel l'utilisateur souhaite accéder avec le connecteur Looker-Excel.

Vous devez également installer le pilote ODBC, comme décrit dans la section suivante.

Installer le pilote ODBC

Le pilote ODBC pour Looker est un logiciel qui doit être installé sur la machine locale de chaque utilisateur du connecteur Looker-Excel. Le pilote ODBC permet aux clients compatibles ODBC de se connecter à votre instance Looker comme s'il s'agissait d'une base de données SQL.

Pour utiliser un pilote ODBC, vous devez avoir installé un programme de gestion ODBC. Windows est généralement préinstallé avec un programme appelé Sources de données ODBC comme outil de gestion. Pour en savoir plus, consultez la documentation Microsoft sur l'administrateur de sources de données ODBC.

Pour installer le pilote ODBC, procédez comme suit :

  1. Utilisez les liens suivants pour télécharger le dernier programme d'installation ODBC pour l'architecture de votre système Windows (64 bits ou 32 bits) :

  2. Ouvrez le fichier d'installation ODBC et suivez les instructions à l'écran.

  3. Une boîte de dialogue Windows peut s'afficher avec le message Windows a protégé votre ordinateur. Si cette boîte de dialogue s'affiche, cliquez sur le lien Informations complémentaires, puis sur le bouton Exécuter quand même.

La première fois que vous ouvrez un fichier ODC après avoir installé le pilote ODBC sur votre PC Windows, Windows vous invite à créer un nom de source de données (DSN) pour vous permettre d'utiliser le pilote ODBC avec des clients ODBC tels qu'Excel. Le DSN est une configuration enregistrée qui contient les informations de votre instance Looker et vos identifiants d'authentification.

Utiliser le connecteur Looker-Excel

Une fois que les conditions préalables sont remplies et que le pilote ODBC est installé sur votre ordinateur, vous pouvez ouvrir les données Looker dans Microsoft Excel en procédant comme suit :

  1. Sur votre PC Windows, ouvrez votre instance Looker dans un navigateur.
  2. Ouvrez une exploration et exécutez une requête.
  3. Cliquez sur le menu en forme de roue dentée de l'exploration, puis sélectionnez l'option Ouvrir dans Excel.

  4. Dans la boîte de dialogue Ouvrir dans Excel, sélectionnez l'une des options suivantes pour Nombre de lignes et de colonnes à inclure :

    • Tableau de résultats actuel : sélectionnez cette option pour inclure toutes les lignes et colonnes du tableau de résultats actuel dans l'exploration. Le nombre de lignes est limité par la valeur Limite de lignes de l'exploration.
    • Tous les résultats : sélectionnez cette option pour inclure tous les résultats renvoyés par la requête dans votre base de données. L'option Tous les résultats est généralement désactivée pour les requêtes pour lesquelles l'option Totaux des lignes est activée, ou qui récupèrent des données à partir d'un dialecte de base de données qui ne peut pas diffuser les résultats, ou qui contiennent les types de mesures suivants : pourcentage du total, pourcentage du précédent ou totaux cumulés. Avertissement : Même lorsque l'option Tous les résultats est disponible, vous devez rester prudent lorsque vous téléchargez tous les résultats. Certaines requêtes sont très volumineuses et contiennent des milliers ou des millions de lignes, ce qui peut surcharger la plupart des tableurs, voire votre instance Looker.
    • Personnalisé : sélectionnez cette option pour spécifier manuellement le nombre de lignes et de colonnes à inclure dans le téléchargement du fichier ODC.
    • Les utilisateurs disposant de l'autorisation download_without_limit peuvent saisir une taille de ligne allant jusqu'à 100 000 et une taille de colonne allant jusqu'à 200.
    • Les utilisateurs disposant de l'autorisation download_with_limit peuvent saisir une taille de ligne allant jusqu'à 5 000 lignes et une taille de colonne allant jusqu'à 200.
    • Pour les utilisateurs ne disposant ni de l'autorisation download_with_limit, ni de l'autorisation download_without_limit, l'option Ouvrir dans Excel ne s'affiche pas.

  5. Dans la boîte de dialogue Ouvrir dans Excel, cliquez sur Télécharger. Un fichier ODC sera téléchargé sur votre ordinateur.

  6. Ouvrez le fichier ODC avec Microsoft Excel.

  7. Microsoft Excel affiche un avis de sécurité concernant les connexions de données bloquées. Cliquez sur Activer pour activer la connexion de données.

  8. Windows affiche une boîte de dialogue permettant de configurer le DSN Google Looker. Configurez le DSN en procédant comme suit :

    1. Dans le menu déroulant Type d'authentification, sélectionnez OAuth. Bien qu'OAuth soit l'option privilégiée, vous pouvez sélectionner Authentification de base si nécessaire. Si vous sélectionnez Basic Auth, vous devrez saisir les identifiants de l'API Looker. Consultez la section S'authentifier à l'aide de l'authentification de base sur cette page.
    2. Cliquez sur Login (Connexion). Un navigateur Web s'ouvre pour vous authentifier dans votre compte Looker. Une fois que le navigateur Web indique que la connexion a réussi, fermez-le et revenez à la boîte de dialogue "DSN".
    3. Cliquez sur OK dans la boîte de dialogue DSN.
    4. Si vous y êtes invité, cliquez sur OK pour accepter d'écraser le DSN.

Excel exécute la requête et insère les données dans un nouvel objet de tableau croisé dynamique. Vous pouvez ensuite utiliser les données dans des calculs et des visualisations.

Si vous souhaitez récupérer des données actualisées, vous pouvez effectuer l'une des opérations suivantes :

  • Pour réexécuter la même requête afin d'obtenir les dernières données de Looker, cliquez sur le bouton Actualiser dans le ruban Excel.
  • Pour modifier la requête, utilisez l'UI d'exploration Looker pour mettre à jour la requête, puis sélectionnez l'option Ouvrir dans l'exploration pour télécharger un nouveau fichier ODC (en d'autres termes, recommencez à partir de l'étape 1 de cette procédure). Par défaut, Excel ouvre un nouveau fichier ODC dans un nouveau classeur Excel. Si vous souhaitez déplacer un tableau croisé dynamique d'un classeur à un autre, vous pouvez cliquer sur la feuille et la faire glisser entre les classeurs Excel, ou copier et coller le tableau croisé dynamique d'un classeur à un autre.

Limites

Le connecteur Looker-Excel n'est compatible qu'avec Windows, et non avec les ordinateurs Mac ou Linux.

Les fonctionnalités de requête d'exploration suivantes ne sont pas compatibles avec le connecteur Looker-Excel :

Si vous souhaitez ouvrir une requête d'exploration dans Microsoft Excel, supprimez les calculs de table et les colonnes pivotées avant de sélectionner Ouvrir dans Excel dans le menu en forme de roue dentée de l'exploration.

Dépannage

Les sections suivantes fournissent des informations sur les procédures et les outils de dépannage :

Ajouter manuellement un DSN

Lorsque vous ouvrez un fichier ODC avec Excel, Windows vous invite à créer le DSN. Si vous devez créer ou modifier manuellement le DSN, vous pouvez utiliser l'administrateur de source de données du pilote ODBC Windows.

Pour créer ou modifier manuellement le DSN, procédez comme suit :

  1. Dans le panneau de configuration de votre PC Windows, ouvrez l'application Sources de données ODBC (avant Windows 8, cette application s'appelait Administrateur de sources de données ODBC).
  2. Cliquez sur le bouton Ajouter.
  3. Double-cliquez sur Google Looker ODBC Driver.
  4. Dans la boîte de dialogue Configure Google Looker DSN (Configurer le DSN Google Looker), renseignez les champs suivants :
    • Nom de la source de données* : (facultatif) saisissez un nom pour votre source de données afin de vous aider à reconnaître ce nom de source de données à l'avenir.
    • Hôte : saisissez l'URL de votre instance Looker.
    • Port : saisissez le port auquel vous souhaitez vous connecter sur l'instance Looker. La valeur par défaut est 443.
    • Dans le menu déroulant Type d'authentification, sélectionnez OAuth. Bien qu'OAuth soit l'option privilégiée, vous pouvez sélectionner Authentification de base si nécessaire. Si vous sélectionnez Basic Auth, vous devrez saisir les identifiants de l'API Looker. Consultez la section S'authentifier à l'aide de l'authentification de base sur cette page.
  5. Cliquez sur Login (Connexion). Un navigateur Web s'ouvre pour vous authentifier dans votre compte Looker. Une fois que le navigateur Web indique que la connexion a réussi, fermez-le et revenez à la boîte de dialogue "DSN".
  6. Cliquez sur Tester pour vérifier la connexion.
  7. Cliquez sur OK dans la boîte de dialogue DSN.
  8. Si vous y êtes invité, cliquez sur OK pour accepter d'écraser le DSN.

S'authentifier à l'aide de l'authentification de base

OAuth est la méthode d'authentification privilégiée pour Looker. Si vous sélectionnez Basic Auth (Authentification de base) comme Auth Type (Type d'authentification) dans la boîte de dialogue DSN, vous pouvez vous authentifier à l'aide de l'ID client et du code secret du client de la clé API. Pour en savoir plus sur la création de clés API, consultez la page de documentation Paramètres d'administration – Utilisateurs.

Journaux du programme d'installation

Si vous avez besoin d'accéder aux journaux du programme d'installation pour résoudre les problèmes liés au connecteur Looker-Excel, vous pouvez y accéder dans le répertoire C:\Users\<username>\lookerODBCLogs. Les noms des journaux du programme d'installation utilisent le format suivant :

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

Mettre à niveau Microsoft Visual C++ Redistributable (MSVC)

Le package Microsoft Visual C++ Redistributable (MSVC) version 14 est installé automatiquement s'il n'est pas déjà présent.

Si le package MSVC est déjà installé, le programme d'installation du pilote ODBC Google Looker ne le mettra pas à niveau. Pour utiliser la version MSVC incluse avec le pilote, désinstallez le package MSVC existant avant d'exécuter le programme d'installation.

Une fois le pilote désinstallé, le package MSVC reste installé pour prendre en charge d'autres applications. Vous pouvez la désinstaller manuellement si vous n'en avez plus besoin.