Utiliser des feuilles connectées pour Looker

Les feuilles connectées pour Looker permettent aux utilisateurs d'explorer de manière interactive les données des modèles LookML via l'interface familière de feuilles de calcul de Google Sheets. Les utilisateurs de Sheets auront accès aux données gouvernées de plus de 50 bases de données compatibles avec Looker. L'exploration est intuitive, car les feuilles connectées présentent une vue organisée du modèle avec des vues, des champs et des mesures tels qu'ils ont été définis dans Looker. Les données Looker via les feuilles connectées peuvent être utilisées dans des constructions Sheets standards, comme les tableaux croisés dynamiques, les graphiques et les formules, ce qui permet une analyse flexible avec des constructions familières.

Activer les feuilles connectées

Pour utiliser les feuilles connectées:

  • Dans Looker (version initiale), votre administrateur Looker doit activer les connecteurs d'informatique décisionnelle pour Looker ou l'option Feuilles connectées du panneau "Connecteurs d'informatique décisionnelle" de la section Plate-forme du menu Administration de Looker. Dans Looker (Google Cloud Core), ces options sont activées par défaut.
  • Votre instance Looker doit être hébergée par Looker.
  • Votre instance Looker doit exécuter Looker 22.20 ou une version ultérieure si elle est hébergée sur Google Cloud. Si votre instance Looker n'est pas hébergée sur Google Cloud, elle doit exécuter Looker 23.4 ou une version ultérieure.
  • Chaque utilisateur souhaitant se connecter à votre instance Looker depuis Google Sheets doit utiliser la même adresse e-mail dans son compte utilisateur Looker que pour son compte Google Workspace. Si les adresses e-mail de leurs comptes Workspace et Looker sont différentes, un message d'erreur s'affiche lorsqu'ils tentent de se connecter à Looker depuis Sheets.
  • L'accès aux services qui ne sont pas contrôlés individuellement doit être activé dans la console d'administration Google Workspace. Cette option est généralement activée par défaut. Pour plus d'informations, consultez l'article d'aide Gérer l'accès aux services qui ne sont pas contrôlés individuellement.

Se connecter à Looker depuis Google 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 que vous avez récemment connectée, puis cliquez sur Continuer.

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

Lorsque Sheets se connecte à votre instance Looker, Sheets ouvre une nouvelle feuille indiquant la structure de l'exploration sélectionnée, y compris les vues, les dimensions, les mesures et les descriptions de champ 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:

  1. Dans la feuille contenant 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éé. 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 l'exploration Looker.

    Les lignes, colonnes, valeurs et filtres de l'éditeur de tableau croisé dynamique sont équivalents à vos dimensions et mesures Looker aux points suivants:

    • Les lignes correspondent aux dimensions Looker.
    • Les colonnes correspondent aux dimensions croisées 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 une liste des vues faisant partie de votre exploration, que vous pouvez sélectionner pour afficher les dimensions et mesures incluses dans cette vue.

  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 la ligne, la colonne, la valeur ou le filtre.

  4. Une fois que vous avez ajouté vos champs et filtres Looker pour créer votre requête, sélectionnez Appliquer. Les données de votre instance Looker seront alors insérées dans la feuille.

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

Options de filtrage

De nouvelles options de filtrage ont été ajoutées depuis la version initiale des feuilles connectées pour Looker.

Filtrer par valeur (ajout en août 2023)

Il est possible de filtrer les dimensions Looker dans les feuilles connectées pour les tableaux croisés dynamiques Looker en affichant une liste des valeurs et en sélectionnant ou désélectionnant les valeurs qui vous intéressent. Auparavant, lorsque vous utilisiez le filtrage basé sur une condition, vous deviez saisir manuellement les valeurs du filtre.

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

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

Vous pouvez ensuite effectuer une recherche parmi les éléments, choisir de sélectionner ou de supprimer tous les éléments, ou de les trier par fréquence ou par ordre alphabétique. Lorsque vous cliquez sur OK en bas de la page, Sheets stocke vos choix. Vous pouvez ensuite cliquer sur Appliquer pour actualiser le tableau croisé dynamique comme d'habitude, en appliquant votre nouveau filtre.

Filtres utilisant des expressions de filtre Looker – ajouté en septembre 2023

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

Pour utiliser les expressions de filtre Looker:

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

  2. Cliquez sur la liste déroulante État pour afficher les options de filtrage, puis sélectionnez Expression de filtre.

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

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

  4. Cliquez sur OK.

Outre le filtrage par date relative, voici d'autres exemples de filtrage désormais possibles:

  • Une chaîne qui ne commence 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.

Utilisation de paramètres Looker et de champs de filtre uniquement (ajout en octobre 2023)

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

Les champs et les paramètres réservés au filtrage apparaîtront dans la section CHAMPS DE FILTRE UNIQUEMENT du sélecteur de champs dans Sheets, tout comme dans Looker. Pour les utiliser, procédez comme suit:

  1. Ajoutez les paramètres et les champs réservés au filtrage, ou faites-les glisser dans la section Filtres, comme vous le feriez pour filtrer les données en fonction d'une dimension ou d'une mesure.
  2. Pour les paramètres avec des valeurs autorisées, ces valeurs s'affichent dans une liste déroulante dans 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 le champ comporte des suggestions définies 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 obligera Looker à interroger votre base de données et à mettre à jour votre tableau croisé dynamique avec vos données les plus récentes.

Votre tableau croisé dynamique et la feuille contenant votre exploration affichent la date de leur dernière actualisation.

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

Planifier des intervalles d'actualisation réguliers

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

Modification des paramètres de votre tableau croisé dynamique

Pour modifier les lignes, les colonnes, les valeurs ou les filtres à inclure 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.

Surveiller des 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 de l'API Query dans l'exploration de l'historique de l'activité du système. Une entrée est créée dans l'exploration de l'historique chaque fois qu'une nouvelle requête est exécutée.

Dans le groupe de champs Propriétés client de l'API Query, trois nouveaux champs sont disponibles pour les feuilles connectées:

  • Nom du 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 indique l'ID de la feuille, qui est inclus dans l'URL Google Sheets de cette feuille.
  • Déclencheur des feuilles connectées : ce champ indique si la requête a été déclenchée par un utilisateur qui sélectionne le bouton Actualiser dans Sheets ou par une actualisation programmée.

Vous trouverez ci-dessous un exemple d'URL d'activité du système qui illustre 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

Bon à savoir

  • La sensibilité à la casse des données du tableau croisé dynamique est déterminée par le paramètre de sensibilité à la casse du modèle. Toutefois, les filtres du tableau croisé dynamique imposent une insensibilité à la casse dans les cas où le filtre n'est pas sensible à la casse pour les données Sheets natives.
  • Toute personne disposant d'un accès Lecteur à la feuille peut afficher les données mises en cache dans un tableau croisé dynamique.
  • En plus de disposer d'un accès Éditeur à la feuille, les utilisateurs qui doivent modifier ou actualiser le tableau croisé dynamique devront disposer 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 permettant d'afficher les données et l'accès approprié aux données via les filtres d'accès ou les 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 données et de lignes des feuilles connectées

Les requêtes créées avec des feuilles connectées sont limitées à 30 000 lignes. Si le résultat de la requête contient plus de lignes, Sheets affichera une erreur. 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.

En outre, 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 génèrent également une erreur.

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

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

Il se peut que vous rencontriez 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 n'a pas été saisi correctement. Dans ce cas, vérifiez le nom de votre instance Looker et essayez à nouveau de vous connecter.
  • 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 résoudre ce problème, laissez le champ URL de l'hôte de l'API vide 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 qu'il est éligible.

Cette erreur peut se produire pour plusieurs raisons:

  • Vous essayez de vous connecter à une nouvelle instance Looker. Il peut s'écouler jusqu'à 24 heures avant 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.

Aucun modèle ne s'affiche après la connexion à une instance Looker

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

Un utilisateur Looker disposant du rôle Lecteur ne dispose pas des autorisations nécessaires pour créer des connexions dans Sheets, de la même manière qu'il ne dispose pas des autorisations suffisantes pour utiliser l'interface utilisateur d'exploration dans Looker. Si l'utilisateur souhaite utiliser des 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'utilisateur l'autorisation explore, 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 signifie 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 à votre compte Looker. Un administrateur Looker peut également créer un compte utilisateur Looker utilisant votre adresse e-mail Google actuelle.

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

Cette erreur indique que le connecteur des feuilles connectées n'a pas été activé. Un administrateur Looker doit activer les connecteurs d'informatique décisionnelle pour Looker ou le bouton Feuilles connectées du panneau "Connecteurs d'informatique décisionnelle" de la section Plate-forme du menu Administration de Looker.

Erreur: 403 (Accès interdit)

Si une liste d'autorisation d'adresses IP est configurée pour votre instance Looker, celle-ci 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 L'adresse IP ne figure pas sur la liste d'autorisation.