Connecteur Looker-Excel

Le connecteur Looker-Excel vous permet d'exporter des requêtes depuis une exploration Looker vers un format reconnu par Microsoft Excel. Lorsque le connecteur Looker-Excel est activé, l'option Ouvrir dans Excel s'affiche dans le menu en forme de roue dentée "Explorer" de Looker. Lorsque vous sélectionnez cette option, Looker exporte la requête Explorer dans 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 version ultérieure
    • Activée pour le connecteur BI Microsoft Excel. Un administrateur Looker doit activer le bouton Microsoft Excel sur la page Connecteurs d'informatique décisionnelle de Looker.
  • Un compte Looker avec un rôle utilisateur qui inclut 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 l'ordinateur local 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. Il est possible qu'une boîte de dialogue Windows s'affiche et indique Windows a protégé votre PC. Si cette boîte de dialogue s'affiche, cliquez sur le lien Plus d'infos, 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 nom de source de données 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 les conditions préalables remplies et le pilote ODBC 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 Outils 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 :

    • Table des résultats actuels : sélectionnez cette option pour inclure toutes les lignes et colonnes de la table des résultats actuelle 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 à 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 de résultats en continu, pourcentage du total, ou qui contiennent les types de mesures suivants : pourcentage par rapport à la période précédente ou totaux cumulés. Avertissement : Même lorsque l'option Tous les résultats est disponible, vous devez faire preuve de prudence lorsque vous téléchargez tous les résultats. Certaines requêtes sont très volumineuses et contiennent des milliers, voire des millions de lignes. Elles peuvent surcharger la plupart des tableurs, voire votre instance Looker.
    • Personnalisée : sélectionnez cette option pour spécifier manuellement le nombre de lignes et de colonnes à inclure dans le fichier ODC à télécharger.
    • 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 colonnes.
    • L'option Ouvrir dans Excel ne s'affiche pas pour les utilisateurs qui ne disposent pas des autorisations download_with_limit ni download_without_limit.

  5. Dans la boîte de dialogue Ouvrir dans Excel, cliquez sur Télécharger. Un fichier ODC est 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 nom de source de données en procédant comme suit :

    1. Dans le menu déroulant Type d'authentification, sélectionnez OAuth. Bien qu'OAuth soit l'option recommandée, vous pouvez sélectionner Authentification de base si nécessaire. Si vous sélectionnez Authentification de base, 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 et vous authentifie 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 nom de source de données.

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 récentes, vous pouvez effectuer l'une des opérations suivantes :

  • Pour réexécuter la même requête et 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 Looker Explore afin de la mettre à jour, puis sélectionnez l'option Ouvrir dans Explorer pour télécharger un nouveau fichier ODC (en d'autres termes, recommencez à 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 faire glisser la feuille 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 Explore suivantes ne sont pas compatibles avec le connecteur Looker-Excel :

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

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 nom de source de données. Si vous devez créer ou modifier manuellement le nom de la source de données (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 source de données du pilote ODBC).
  2. Cliquez sur le bouton Ajouter.
  3. Double-cliquez sur Pilote ODBC Google Looker.
  4. Dans la boîte de dialogue Configurer le nom de la source de données 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 pouvoir l'identifier facilement à 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 recommandée, vous pouvez sélectionner Authentification de base si nécessaire. Si vous sélectionnez Authentification de base, 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 et vous authentifie 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 nom de source de données.

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

OAuth est la méthode d'authentification à privilégier pour Looker. Si vous sélectionnez Authentification de base comme Type d'authentification dans la boîte de dialogue DSN, vous pouvez également vous authentifier à l'aide de la clé API ID client et du code secret du client. Pour savoir comment créer des clés API, consultez la page de documentation Paramètres d'administration – Utilisateurs.

Journaux du programme d'installation

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

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

Mettre à niveau le package redistribuable Microsoft Visual C++ (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 Google Looker ODBC 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.

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