Utiliser les feuilles connectées pour Looker

Les feuilles connectées pour Looker permettent aux utilisateurs d'explorer de manière interactive les données de modèles LookML via l'interface familière des feuilles de calcul Google Sheets. Les utilisateurs de Sheets auront accès aux données gouvernées à partir 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 les structures Sheets standards, comme les tableaux croisés dynamiques, les graphiques et les formules, ce qui permet d'effectuer des analyses de façon flexible via des constructions connues.

Activer les feuilles connectées

Pour utiliser les feuilles connectées:

  • Dans Looker (classique), votre administrateur Looker doit activer l'option Connecteurs d'informatique décisionnelle Looker ou Feuilles connectées 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 doit être hébergée sur 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 que celle de son compte Looker que celle utilisée pour son compte Google Workspace. Si leurs adresses e-mail de compte Workspace et Looker sont différentes, une 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 en savoir plus, consultez l'article Gérer l'accès aux services qui ne sont pas contrôlés individuellement.

Connexion à 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 l'instance Looker ou sélectionnez le nom de l'instance à laquelle vous vous êtes récemment connecté, puis cliquez sur Continuer.

  3. Dans les boîtes de dialogue suivantes, sélectionnez le modèle Looker et la fonction Explorer que vous souhaitez utiliser pour votre requête, puis cliquez sur Connect (Connecter).

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

  1. Dans la feuille affichant votre exploration, cliquez sur Tableau croisé dynamique.

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

    Un tableau croisé dynamique vide est créé et la fenêtre de l'éditeur s'ouvre. Dans cet exemple, 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 dans la section Explorer de Looker:

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

    • Les lignes sont équivalentes aux dimensions Looker.
    • Les colonnes équivaut 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 Synthétiser par.
    • Les filtres sont équivalents aux filtres Looker.

    Vous trouverez également une liste des vues incluses dans l'exploration, sur laquelle vous pouvez cliquer pour afficher les dimensions et mesures incluses.

  3. Cliquez sur Ajouter pour ajouter une ligne, une colonne, une valeur ou un filtre. Les feuilles connectées affichent la liste des vues disponibles dans la section "Explorer". Cliquez sur le nom d'une vue pour afficher la liste des dimensions et des mesures, puis sélectionnez le champ qui fournit les données pour votre ligne, colonne, valeur ou filtre. Dans le cas des filtres, vous pouvez spécifier la manière dont vous souhaitez filtrer les données dans ce champ:

  4. Une fois que vous avez ajouté les champs et filtres Looker pour créer votre requête, cliquez sur Appliquer. La feuille est alors alimentée avec les données de votre instance Looker:

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

Actualiser vos données dans Google Sheets

Les données de votre tableau croisé dynamique sont statiques, mais vous pouvez les actualiser à tout moment. Si vous actualisez vos données, Looker interrogera votre base de données et mettra à jour votre tableau croisé dynamique avec vos données les plus récentes.

Le tableau croisé dynamique et la feuille montrant votre exploration affichent l'heure de la dernière actualisation:

Cliquez sur Actualiser pour mettre à jour les données dans votre tableau croisé dynamique.

Programmer des actualisations régulières

Vous pouvez également programmer des mises à jour automatiques de vos données à l'aide de la boîte de dialogue Actualisation programmée:

Vous pouvez accéder à la boîte de dialogue Actualisation programmée en cliquant sur le menu à trois points dans votre tableau croisé dynamique et en sélectionnant Options d'actualisation ou en cliquant sur Options d'actualisation dans votre feuille Explorer.

Modifier les paramètres de votre tableau croisé dynamique

Pour modifier les lignes, les colonnes, les valeurs ou les filtres à inclure dans votre tableau croisé dynamique, cliquez sur l'icône en forme de crayon à côté du menu à trois points.

Surveiller les feuilles connectées

Un administrateur Looker peut afficher l'utilisation des feuilles connectées à l'aide du groupe de propriétés clientes de l'API Query dans la section Explorer 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 Propriétés client de l'API Query comprend trois nouveaux champs pour les feuilles connectées:

  • API Client Name (Nom du client API) : ce champ indique toujours Connected Sheets pour identifier les entrées de feuilles connectées.
  • ID de la feuille de calcul des feuilles connectées : ce champ indique l'ID de la feuille de calcul incluse 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 a cliqué sur le bouton Actualiser de 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

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. En revanche, les filtres du tableau croisé dynamique imposent une sensibilité à la casse dans les situations 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 bénéficier d'un accès Éditeur à la feuille, tous les utilisateurs qui doivent modifier ou actualiser le tableau croisé dynamique doivent 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 pour afficher les 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 avec OAuth auprès d'une base de données BigQuery, il peut avoir besoin d'autorisations sur la base de données sous-jacente.

Limites des lignes et des données des feuilles connectées

Les requêtes créées avec des feuilles connectées sont limitées à 30 000 lignes au maximum. Si le résultat de la requête contient plus de lignes, une erreur s'affichera dans Sheets. Si l'utilisateur ne dispose pas de l'autorisation download_without_limit, le résultat sera tronqué à 5 000 lignes au maximum,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 génèrent également une erreur.

Si vous rencontrez l'une de ces erreurs, envisagez d'ajouter des filtres ou d'utiliser des dimensions moins nombreuses et/ou 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 à partir de Google Sheets. Cette section décrit ces problèmes et explique comment les résoudre.

Erreur: Une erreur s'est produite lors de la connexion à votre instance Looker. Veuillez réessayer. Si le problème persiste, veuillez nous 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 réessayez 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 hôte par défaut de l'API. 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. 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 ne s'affiche après la connexion à une instance Looker

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

Un utilisateur Looker doté du rôle Lecteur ne dispose pas des autorisations nécessaires pour créer des connexions dans Sheets, tout comme il ne dispose pas des autorisations nécessaires pour utiliser l'interface utilisateur Explorer dans Looker. Si l'utilisateur souhaite utiliser les feuilles connectées pour Looker, il doit disposer de l'autorisation explore. Les rôles Administrateur, Développeur et Utilisateur incluent l'autorisation explore. Un administrateur Looker peut accorder à l'utilisateur l'autorisation explore. Il doit ainsi 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 à 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 de feuilles connectées n'a pas été activé. Un administrateur Looker doit activer l'option Connecteurs d'informatique décisionnelle Looker ou Feuilles connectées dans le panneau Connecteurs d'informatique décisionnelle de la section Plate-forme du menu Administration de Looker.