Utiliser des feuilles connectées pour Looker

Les feuilles connectées pour Looker permettent aux utilisateurs d'explorer de façon interactive les données de modèles LookML via l'interface de feuilles de calcul familière Google Sheets. Les utilisateurs de Sheets auront accès à des données issues de plus de 50 bases de données gérées par Looker. L'exploration est intuitive, car les feuilles connectées présentent une vue organisée du modèle avec les vues, les champs et les mesures tels qu'ils ont été définis dans Looker. Les données Looker peuvent être utilisées via les feuilles connectées dans des fonctions Sheets standards, comme des tableaux croisés dynamiques, des graphiques et des formules, ce qui permet d'effectuer des analyses de façon souple dans un environnement familier.

Activer les feuilles connectées

Pour utiliser les feuilles connectées, votre instance doit remplir les conditions suivantes :

  • Dans Looker (original), votre administrateur Looker doit activer le client Feuilles connectées 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 Tous les connecteurs d'informatique décisionnelle Looker ou Google Sheets dans le panneau Connecteurs d'informatique décisionnelle de la section Plate-forme du menu Admin de Looker. Dans Looker (Google Cloud Core), ces options sont activées par défaut.
  • Votre instance Looker (version initiale) doit être hébergée par Looker.
  • Si une liste d'autorisation d'adresses IP est configurée pour votre instance Looker (original), vous devez la désactiver pour utiliser les feuilles connectées. Il n'existe pas de liste statique spécifique ou organisée d'adresses IP Google Sheets pouvant être ajoutées à la liste d'autorisation.
  • Dans Looker (Google Cloud Core), les feuilles connectées sont activées par défaut. Toutefois, si vous utilisez une instance Looker (Google Cloud Core) pour laquelle une liste d'autorisation d'adresses IP est configurée, la case Associer des services Google à cette instance doit être cochée dans l'onglet Détails de la page Instance de l'instance dans la console Google Cloud pour vous connecter aux feuilles connectées.
  • Chaque utilisateur qui souhaite se connecter à votre instance Looker depuis Google Sheets doit utiliser la même adresse e-mail dans son compte utilisateur Looker que celle qu'il utilise pour son compte Google Workspace. Si les adresses e-mail de leurs comptes Google Workspace et Looker sont différentes, un message d'erreur s'affiche lorsqu'ils essaient de se connecter à Looker depuis Sheets.
  • L'accès aux services qui ne sont pas contrôlés individuellement doit être activé dans votre console d'administration Google Workspace. Ce paramètre est généralement activé par défaut. Pour en savoir plus, consultez l'article d'aide Gérer l'accès aux services qui ne sont pas contrôlés individuellement.

Se connecter à une présentation à partir de Google Sheets

Dans Looker, un Look est une requête unique qui a été enregistrée précédemment. Vous pouvez ajouter les résultats d'un Look à une feuille, puis interagir avec le résultat du Look dans Sheets.

  1. Dans le menu Données de Google Sheets, sélectionnez Connecteurs de données, puis Se connecter à Looker.

  2. Dans la boîte de dialogue Se connecter à Looker, saisissez le nom de votre instance Looker ou sélectionnez le nom d'une instance à laquelle vous vous êtes récemment connecté, puis sélectionnez Se connecter à un look.

  3. Dans la boîte de dialogue qui s'affiche, sélectionnez le Look que vous souhaitez ajouter à Google Sheets, puis sélectionnez Connect (Connecter). Vous pouvez utiliser le champ Rechercher une présentation pour rechercher une présentation enregistrée par son nom ou son ID, ou filtrer la liste des présentations affichées dans la boîte de dialogue en saisissant une sous-chaîne contenue dans le nom de la présentation.

  4. Dans la boîte de dialogue Se connecter à un look, indiquez si vous souhaitez créer une feuille pour la sortie du look ou ajouter la sortie du look à une feuille existante, puis sélectionnez Créer.

Lorsque Sheets se connecte à votre instance Looker, Sheets ajoute le résultat du Look sélectionné.

Les Looks ne sont pas modifiables dans Sheets, mais vous pouvez actualiser leurs données à tout moment en cliquant sur Actualiser. Vous pouvez cliquer sur l'URL du Look pour l'ouvrir dans Looker. Vous pouvez également afficher le nom, l'ID et l'URL du Look dans la barre latérale du Look.

Se connecter à une exploration Looker depuis Google Sheets

Une exploration constitue le point de départ des requêtes. Une exploration affiche un ensemble spécifié de champs à partir de son fichier de vue associé. Ces champs peuvent être sélectionnés pour créer une requête dans une feuille.

  1. Dans le menu Données de Google Sheets, sélectionnez Connecteurs de données, puis Se connecter à Looker.

  2. Dans la boîte de dialogue Se connecter à Looker, saisissez le nom de votre instance Looker ou sélectionnez le nom d'une instance à laquelle vous vous êtes récemment connecté, puis sélectionnez Se connecter à l'exploration.

  3. Dans les boîtes de dialogue suivantes, sélectionnez le modèle et l'exploration Looker que vous souhaitez utiliser pour votre requête, puis sélectionnez Connecter.

Lorsque Sheets se connecte à votre instance Looker, il ouvre une nouvelle feuille qui affiche la structure de l'exploration sélectionnée, y compris les vues, les dimensions, les mesures et toutes les descriptions de champs ajoutées par votre développeur Looker.

Créer des requêtes Looker à l'aide de Google Sheets

Les requêtes Looker sont créées à l'aide d'un tableau croisé dynamique Sheets. Pour ajouter des données Looker à votre feuille de calcul :

  1. Dans la feuille qui affiche votre exploration, sélectionnez Tableau croisé dynamique.

  2. Indiquez si vous souhaitez insérer un nouveau tableau croisé dynamique dans une nouvelle feuille ou dans une feuille existante, puis sélectionnez Créer.

    Un tableau croisé dynamique vide est créé, et la fenêtre Éditeur de tableau croisé dynamique s'ouvre. Vous pouvez ajouter des lignes, des colonnes, des valeurs et des filtres pour créer votre requête en fonction des dimensions et des mesures de votre exploration Looker.

    Les lignes, colonnes, valeurs et filtres de l'éditeur de tableaux croisés dynamiques correspondent à vos dimensions et mesures Looker de la manière suivante :

    • Les lignes correspondent aux dimensions Looker.
    • Les colonnes sont l'équivalent des dimensions croisées de Looker.
    • Les valeurs sont équivalentes aux mesures Looker. Vous pouvez créer une mesure personnalisée en sélectionnant une dimension Looker et une fonction Sheets Résumer par.
    • Les filtres sont équivalents aux filtres Looker.

    L'éditeur de tableau croisé dynamique affiche également la liste des vues qui font partie de votre exploration. Vous pouvez les sélectionner pour afficher les dimensions et les mesures qu'elles contiennent.

  3. Sélectionnez Ajouter pour ajouter une ligne, une colonne, une valeur ou un filtre. Les feuilles connectées affichent la liste des vues disponibles dans votre exploration. Sélectionnez un nom de vue pour afficher la liste des dimensions et des mesures de la vue, puis sélectionnez le champ qui fournit les données pour votre ligne, colonne, valeur ou filtre.

  4. Une fois que vous avez ajouté vos champs et filtres Looker pour créer votre requête, sélectionnez Appliquer. Votre feuille sera alors renseignée avec les données de votre instance Looker.

Une fois que vous avez ajouté vos données Looker à un tableau croisé dynamique, vous pouvez utiliser Google Sheets pour les mettre en forme ou créer des formules Sheets basées sur vos données Looker.

Options de filtrage

Depuis le lancement initial des feuilles connectées pour Looker, de nouvelles options de filtrage ont été ajoutées.

Filtrer par valeur

Vous pouvez filtrer les dimensions Looker dans les tableaux croisés dynamiques des feuilles connectées pour Looker en affichant une liste de valeurs, puis en sélectionnant et en désélectionnant les valeurs qui vous intéressent. Auparavant, vous deviez saisir manuellement les valeurs de filtre lorsque vous utilisiez le filtrage par condition.

Pour utiliser cette fonctionnalité, ajoutez un champ à la section Filtres du tableau croisé dynamique, puis cliquez sur le menu déroulant État pour ouvrir les options de filtrage. Cliquez ensuite sur Ajouter un filtre :

Une barre latérale s'ouvre et Sheets récupère les 500 valeurs les plus fréquentes de Looker.

Vous pouvez ensuite effectuer une recherche parmi les éléments, choisir de tout sélectionner ou de tout effacer, ou trier les éléments par fréquence ou par ordre alphabétique. Lorsque vous cliquez sur OK en bas de l'écran, Sheets enregistre vos choix. Vous pouvez ensuite cliquer sur Appliquer pour actualiser le tableau croisé dynamique comme d'habitude, avec le nouveau filtre appliqué.

Filtres utilisant des expressions de filtre Looker

Vous pouvez appliquer des filtres de date relative, ainsi que de nombreux autres filtres avancés, dans les feuilles connectées à l'aide d'expressions de filtre Looker. Par exemple, vous pouvez appliquer des filtres tels que "est au cours des 30 dernières minutes" ou "est au cours des 10 derniers jours" dans les feuilles connectées.

Pour utiliser des expressions de filtre Looker :

  1. Ajoutez un champ à la section des filtres du tableau croisé dynamique.

  2. Cliquez sur le menu déroulant État pour afficher les options de filtre, puis sélectionnez Expression de filtre.

  3. Saisissez une expression de filtre Looker dans le champ Valeur.

    Par exemple, pour filtrer les données des sept derniers jours, vous pouvez écrire "7 jours" ou "7 derniers jours".

  4. Cliquez sur OK.

En plus du filtrage par date relative, voici d'autres exemples de filtrage désormais possibles :

  • Chaîne ne commençant pas par : -FOO%
  • Une plage numérique inclusive et exclusive : (12, 20]

Pour afficher toutes les expressions de filtre disponibles, consultez la page de documentation Expressions de filtre Looker.

Utiliser les paramètres et les champs de filtre uniquement de Looker

Vous pouvez désormais utiliser des paramètres et des champs de filtre uniquement dans les feuilles connectées.

Les champs de filtre uniquement et les paramètres s'afficheront dans la section CHAMPS DE FILTRE UNIQUEMENT du sélecteur de champs dans Sheets, comme dans Looker. Pour les utiliser, procédez comme suit :

  1. Ajoutez ou faites glisser les paramètres et les champs de filtre uniquement sélectionnés dans la section Filtres, comme vous le feriez pour filtrer une dimension ou une mesure.
  2. Pour les paramètres avec des valeurs autorisées, ces valeurs s'afficheront dans un menu déroulant de la boîte de dialogue Filtrer par condition.
  3. Pour les champs réservés au filtrage, vous pouvez utiliser la boîte de dialogue Filtrer par condition standard. Si des suggestions sont définies pour le champ dans le modèle Looker, vous pouvez également utiliser la fonctionnalité Filtrer par valeur.

Actualiser vos données dans Google Sheets

Les données de votre tableau croisé dynamique sont statiques, mais peuvent être actualisées à tout moment. L'actualisation de vos données permet à Looker d'interroger votre base de données et de mettre à jour votre tableau croisé dynamique avec vos données les plus récentes.

Votre tableau croisé dynamique et la feuille affichant votre présentation ou votre exploration indiquent l'heure de leur dernière actualisation.

Sélectionnez Actualiser pour mettre à jour les données de votre tableau croisé dynamique.

Planifier des actualisations régulières

Pour planifier des mises à jour automatiques de vos données, sélectionnez le menu à trois points dans votre tableau croisé dynamique, puis Options d'actualisation, ou sélectionnez Options d'actualisation dans votre feuille d'exploration. Looker affiche la boîte de dialogue Actualisation planifiée.

Modifier les paramètres de votre tableau croisé dynamique

Pour modifier les lignes, colonnes, valeurs ou filtres inclus dans votre tableau croisé dynamique, sélectionnez l'icône en forme de crayon à côté du menu à trois points pour ouvrir le panneau de l'éditeur de tableau croisé dynamique.

Surveiller les feuilles connectées

Un administrateur Looker peut consulter l'utilisation des feuilles connectées à l'aide du groupe de champs Propriétés du client API de requête dans l'exploration de l'historique d'activité du système. Une entrée est créée dans l'exploration Historique chaque fois qu'une nouvelle requête est exécutée.

Le groupe de champs Query API Client Properties (Propriétés du client API de requête) contient trois nouveaux champs pour les feuilles connectées :

  • Nom de client API : ce champ affiche toujours Connected Sheets pour identifier les entrées des feuilles connectées.
  • ID de la feuille de calcul des feuilles connectées : ce champ affiche l'ID de la feuille, qui est inclus dans l'URL Google Sheets de cette feuille.
  • Déclencheur de feuilles connectées : ce champ indique si la requête a été déclenchée par un utilisateur qui a sélectionné le bouton Actualiser dans Sheets ou par une actualisation programmée.

Voici un exemple d'URL d'activité système qui montre l'utilisation des feuilles connectées. Remplacez <instance_name.looker.com> par l'URL de votre instance.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Compatibilité avec l'API Feuilles connectées

La compatibilité de l'API avec les feuilles connectées pour Looker est accessible via AppsScript et les API Google Sheets.

Voici quelques exemples de ce que vous pouvez faire de manière programmatique avec l'API :

  • Actualisation automatique des données : vous pouvez planifier des mises à jour régulières de vos feuilles de calcul optimisées par Looker pour vous assurer d'utiliser les informations les plus récentes.
  • Workflows personnalisés : vous pouvez créer des processus complexes qui intègrent les données Looker dans vos workflows Google Sheets existants.
  • Intégration à d'autres applications : vous pouvez connecter les données Looker à des outils et services externes à l'aide des API Apps Script ou Google Sheets.

Pour spécifier Looker comme source de données avec l'API Google Sheets, utilisez l'objet looker avec la ressource REST DataSourceSpec.

Bon à savoir

  • La sensibilité à la casse des données affichées dans le tableau croisé dynamique est déterminée par le paramètre de sensibilité à la casse du modèle. Toutefois, les filtres appliqués au tableau croisé dynamique forcent l'insensibilité à la casse lorsque le filtre n'est pas sensible à la casse pour les données Sheets natives.
  • Toute personne disposant d'un accès Lecteur à la feuille pourra afficher les données mises en cache dans un tableau croisé dynamique.
  • En plus de l'accès Éditeur à la feuille, tous les utilisateurs qui doivent modifier ou actualiser le tableau croisé dynamique auront besoin des autorisations appropriées dans Looker pour accéder au modèle de données. Cela inclut l'accès au modèle sur lequel le tableau croisé dynamique est basé, les autorisations d'affichage des données et l'accès approprié aux données via des filtres d'accès ou des autorisations d'accès.
  • Si l'utilisateur s'authentifie auprès d'une base de données BigQuery avec OAuth, il peut avoir besoin d'autorisations sur la base de données sous-jacente.

Limites de lignes et de données pour les feuilles connectées

Les requêtes créées avec les feuilles connectées sont limitées à 100 000 lignes. Si le résultat de la requête contient plus de lignes, Sheets affiche une erreur à l'utilisateur. Si l'utilisateur ne dispose pas de l'autorisation download_without_limit, le résultat sera tronqué à un maximum de 5 000 lignes,quelle que soit la limite de Sheets.

De plus, les requêtes des feuilles connectées sont soumises à une limite de taille des données. Les requêtes qui renvoient trop de données entraînent également une erreur.

Si l'une de ces erreurs s'affiche, envisagez d'ajouter des filtres ou d'utiliser moins de dimensions et/ou des dimensions moins précises dans votre requête.

Résoudre les problèmes liés aux feuilles connectées

Vous pouvez rencontrer des problèmes lorsque vous essayez de vous connecter à Looker depuis Google Sheets. Cette section décrit ces problèmes et explique comment les corriger.

Erreur : Une erreur s'est produite lors de la connexion à votre instance Looker. Veuillez réessayer. Si le problème persiste, veuillez envoyer des commentaires.

Cette erreur peut se produire pour plusieurs raisons :

  • Le nom de l'instance Looker a été saisi de manière incorrecte. Dans ce cas, vérifiez le nom de votre instance Looker et essayez de vous reconnecter.
  • Sheets ne peut pas se connecter à l'API Looker. Cela peut se produire si votre instance Looker n'utilise pas l'URL de l'hôte de l'API par défaut. Pour corriger ce problème, laissez vide le champ URL de l'hôte de l'API dans le panneau d'administration de l'API.

Erreur : L'instance Looker n'est pas configurée pour utiliser cette fonctionnalité. Veuillez contacter votre administrateur Looker pour vous assurer que l'instance est éligible.

Cette erreur peut se produire pour plusieurs raisons :

  • Vous essayez de vous connecter à une instance Looker que vous venez de créer. Un délai maximal de 24 heures peut être nécessaire pour qu'une nouvelle instance Looker soit disponible dans les feuilles connectées.
  • Vous essayez de vous connecter à une instance Looker qui n'est pas hébergée par Looker. Connectez-vous à une autre instance Looker hébergée par Looker.

Aucun modèle n'apparaît après la connexion à une instance Looker

Cela indique que vous ne disposez pas des autorisations requises pour afficher les modèles sur votre instance.

Un utilisateur Looker disposant du rôle Lecteur ne dispose pas des autorisations suffisantes pour créer des connexions dans Sheets, tout comme il ne dispose pas des autorisations suffisantes pour utiliser l'interface utilisateur d'exploration dans Looker. Si l'utilisateur souhaite utiliser les feuilles connectées pour Looker, il doit disposer de l'autorisation explore. Les rôles d'administrateur, de développeur et d'utilisateur incluent l'autorisation explore. Un administrateur Looker peut accorder l'autorisation explore à l'utilisateur, ce qui devrait lui permettre de voir les modèles sur l'instance.

Erreur : L'adresse e-mail de votre compte Looker associé est différente de celle de votre compte Google.

Cela indique que l'adresse e-mail de votre compte Looker ne correspond pas à celle utilisée avec votre compte Google. Assurez-vous d'être connecté à un compte Google dont l'adresse e-mail correspond à celle de votre compte Looker. Un administrateur Looker peut également créer un compte utilisateur Looker qui utilise votre adresse e-mail Google actuelle.

Erreur : Requête incorrecte : aucun client d'activation trouvé.

Cette erreur indique que le connecteur Feuilles connectées n'a pas été activé. Un administrateur Looker doit activer le client Feuilles connectées 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 Tous les connecteurs d'informatique décisionnelle Looker ou Google Sheets dans le panneau Connecteurs d'informatique décisionnelle de la section Plate-forme du menu Admin de Looker.

Erreur : 403 Accès interdit

Si une liste d'autorisation d'adresses IP est configurée pour votre instance Looker, elle peut empêcher Sheets de se connecter à l'API Looker. Pour déterminer si la liste d'autorisation est en cause, essayez d'accéder à l'URL de l'instance Looker pour voir si vous recevez une erreur Adresse IP non autorisée.