Notez que vous consultez actuellement la documentation de Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

Création de tableaux de bord LookML

Les tableaux de bord LookML sont créés par des développeurs LookML et stockés sous forme de fichiers avec contrôle des versions. Par défaut, ils apparaissent dans le dossier Tableaux de bord LookML de votre instance Looker.

Pour comparer et différencier les tableaux de bord LookML et les tableaux de bord définis par l'utilisateur, consultez la page de documentation Comparaison des tableaux de bord LookML et des tableaux de bord définis par l'utilisateur.

Pour créer un tableau de bord LookML, vous devez disposer des autorisations Looker suivantes:

De plus, vous devez avoir accès aux modèles LookML pour toutes les données que vous souhaitez utiliser dans le tableau de bord.

Création d'un fichier de tableau de bord LookML

Pour créer un tableau de bord LookML, commencez par créer un fichier de tableau de bord ayant l'extension .dashboard.lookml (bien que la partie .lookml de l'extension soit silencieuse dans l'IDE). Pour ce faire, procédez comme suit:

Activez le mode Développement.
Dans le menu Develop (Développer), accédez à votre projet.
Sélectionnez l'icône Plus Ajouter un fichier ou un dossier en haut du panneau de l'explorateur de fichiers dans l'IDE Looker pour créer un fichier de tableau de bord LookML en dehors des dossiers du projet existants. Vous pouvez également cliquer sur le menu à trois points Options du dossier pour créer le fichier dans le dossier. Cliquez sur Créer un tableau de bord pour créer le fichier du tableau de bord.
Une fenêtre Créer un fichier s'affiche. Dans la fenêtre, nommez le fichier du tableau de bord dans le champ d'écriture, puis sélectionnez le bouton Create (Créer).

Modification des fichiers de tableau de bord LookML

Lorsque vous créez un fichier de tableau de bord LookML, Looker le préremplit avec plusieurs paramètres de tableau de bord de base, qui implémentent des paramètres pour l'ensemble du tableau de bord. Le fichier est également prérempli avec plusieurs exemples de paramètres d'élément de tableau de bord. Ceux-ci sont regroupés sous le paramètre elements et définissent la fonction et l'apparence des vignettes, du texte et des boutons du tableau de bord. Un fichier .dashboard.lookml nouvellement créé contient le code LookML du tableau de bord semblable à celui-ci:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Vous pouvez modifier comme vous le souhaitez le fichier du tableau de bord dans l'IDE, à condition d'être en mode Développement.

Vous disposez de plusieurs options pour créer votre tableau de bord:

Création manuelle:vous pouvez créer manuellement un tableau de bord à l'aide de paramètres de tableau de bord et d'élément de tableau de bord.
Copier un tableau de bord défini par l'utilisateur:vous pouvez créer une copie d'un tableau de bord défini par l'utilisateur en supprimant le code LookML du tableau de bord prérempli du fichier, en copiant le code LookML du tableau de bord à partir d'un tableau de bord défini par l'utilisateur, puis en le collant dans votre fichier de tableau de bord.
Copier le code LookML du tableau de bord:vous pouvez copier le code LookML du tableau de bord à partir d'une exploration ou d'un Look et le coller dans le fichier de votre tableau de bord.

Lorsque vous créez un tableau de bord, gardez à l'esprit les meilleures pratiques de construction de tableau de bord. Pour obtenir des informations et des recommandations sur la création de tableaux de bord performants, consultez la page des bonnes pratiques Éléments à prendre en compte lors de la création de tableaux de bord Looker performants.

Ajout d'une visualisation à un tableau de bord LookML existant

Le moyen le plus simple d'ajouter une visualisation à un tableau de bord LookML existant consiste à utiliser la page Explore (Explorer) pour créer une requête que vous souhaitez transformer en élément de tableau de bord:

Une fois que vous avez créé la requête et la visualisation que vous souhaitez ajouter à un tableau de bord, cliquez sur le menu en forme de roue dentée Actions d'exploration de l'exploration.
Sélectionnez Obtenir le code LookML pour exposer le code LookML.
Une fenêtre Obtenir le code LookML s'affiche. Sélectionnez Dashboard (Tableau de bord) dans la fenêtre, puis sélectionnez l'ensemble du code LookML et copiez-le.

À partir de là, collez le code LookML dans le fichier LookML de votre tableau de bord. Lorsque vous modifiez le fichier LookML du tableau de bord, veillez à:

Vérifiez que vous êtes en mode Développement afin de pouvoir modifier le fichier du tableau de bord.
Collez le code LookML sous le paramètre elements du tableau de bord.
Utilisez le retrait approprié lorsque vous collez le code LookML dans le fichier du tableau de bord. Si possible, faites correspondre le retrait aux éléments existants déjà dans le fichier du tableau de bord.

Si vous le souhaitez, vous pouvez ajuster les paramètres LookML à l'aide des paramètres décrits dans les pages de documentation de chaque type d'élément.

Ajouter des filtres

Une fois que des éléments de tableau de bord sont enregistrés dans le fichier de votre tableau de bord, vous pouvez ajouter des filtres, ce qui permet aux lecteurs du tableau de bord de filtrer tout ou partie des éléments d'un tableau de bord. Les filtres peuvent être utiles pour de nombreuses raisons, par exemple:

Ajuster la période affichée
Ajuster la catégorie de produits spécifique, le type de client, etc. affichés
Fournir une fonctionnalité de type "lookup" pour un client ou un client

Veillez à créer le type de filtre souhaité. Les deux types sont les suivants:

Filtres que vous codez en dur dans les éléments du tableau de bord, que les lecteurs du tableau de bord ne peuvent pas modifier
Filtres de tableau de bord, que les lecteurs d'un tableau de bord peuvent modifier

Filtres codés en dur dans les éléments du tableau de bord

Les filtres que vous codez en dur dans les éléments du tableau de bord, que les utilisateurs ne peuvent pas modifier, sont généralement créés automatiquement lors de l'étape de copie du code LookML pour une visualisation ou pour un tableau de bord. Dans un tableau de bord LookML, ces filtres utilisent le paramètre d'élément du tableau de bord filters et ressemblent à ceci:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filtres du tableau de bord

Vous pouvez créer des filtres de tableau de bord qu'un utilisateur peut modifier en deux étapes:

Créez le filtre du tableau de bord lui-même à l'aide du paramètre de tableau de bord filters et de ses sous-paramètres.
Appliquez le filtre du tableau de bord à des éléments du tableau de bord à l'aide du paramètre d'élément listen.

Création d'un filtre de tableau de bord

La première étape consiste à créer les filtres avec lesquels les utilisateurs interagissent. Pour ce faire, ajoutez une section filters au fichier de votre tableau de bord, qui ressemblera à ceci:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

Les options et paramètres de ces filtres sont décrits plus en détail sur la page de documentation Paramètres du tableau de bord. L'un des points les plus importants à garder à l'esprit est le type d'entrée que vous attendez de vos utilisateurs. Vous pouvez attribuer un type au filtre pour qu'il accepte un type d'entrée spécifique, tel que des nombres, des dates ou des chaînes. Vous pouvez également utiliser le filtre type pour associer un filtre à un champ LookML sous-jacent. Dans ce cas, Looker sélectionne automatiquement le type d'entrée approprié et, si le champ LookML sous-jacent est défini sur type: string, fournit des suggestions de filtre aux lecteurs du tableau de bord.

Comme décrit sur la page de documentation Paramètres du tableau de bord, seuls les filtres avec type: field filter utilisent les paramètres explore et field. Si vous incluez les paramètres explore et field avec un autre type de filtre, vous obtiendrez des erreurs de validation LookML.

Appliquer un filtre de tableau de bord aux éléments d'un tableau de bord

Une fois que vous avez créé un filtre de tableau de bord, vous devez l'appliquer aux éléments appropriés à l'aide du paramètre listen. L'idée est que l'élément "écoute" un ou plusieurs filtres de saisie utilisateur, puis s'ajuste en conséquence. Ce paramètre s'applique à tous les types d'éléments, à l'exception de type: text et type: button. Des détails sur son utilisation sont disponibles dans les pages de documentation de chaque type de visualisation. Pour obtenir un exemple représentatif du fonctionnement de listen, consultez la section Paramètres du graphique en aires pour les tableaux de bord LookML.

Par exemple, l'un de vos éléments pourrait ressembler à ceci:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'

Comme vous pouvez le constater, cet élément comporte déjà un paramètre filters qui le limite aux commandes approuvées (à l'aide du filtre order.status: 'approved'). L'utilisateur ne peut pas modifier ce paramètre.

Supposons que vous souhaitiez que l'utilisateur puisse filtrer cet élément à l'aide des filtres de tableau de bord créés précédemment dans cet exemple. Pour ce faire, ajoutez un paramètre listen comme suit:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'
  listen:
    category_name: category.name
    date: order.created_date

Si vous ne voulez pas que les utilisateurs puissent modifier la date ou la catégorie, n'ajoutez tout simplement pas le paramètre listen. Il vous suffit d'ajouter un élément listen aux éléments que vous souhaitez que l'utilisateur puisse ajuster.

Vous constaterez que la syntaxe listen fonctionne en écrivant d'abord le nom du filtre que vous avez créé, puis le nom du champ auquel vous souhaitez appliquer l'entrée utilisateur.

Un filtre de tableau de bord peut être appliqué à n'importe quel champ (du même type de données) de n'importe quel élément. Par exemple, un élément peut appliquer les données saisies par l'utilisateur à la date de création de la commande (date: order.created_date), tandis qu'un autre l'applique à la date d'expédition de la commande (date: order.ship_date):

- name: element_one
  # lots of other element parameters here
  listen:
    date: order.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: order.ship_date

Inclure le fichier du tableau de bord dans un modèle

Pour que votre tableau de bord soit prévisualisé en mode Développement ou visible en production, il doit être inclus dans le fichier de modèle sur lequel il est basé à l'aide d'une instruction include.

Une pratique courante consiste à inclure tous les tableaux de bord LookML dans un modèle à l'aide d'un caractère générique:

include: "*.dashboard.lookml"

ou, si vos tableaux de bord LookML apparaissent dans un dossier de l'IDE, utilisez le chemin d'accès à leur emplacement

 include: "/path/*.dashboard.lookml"

Vous pouvez également inclure un tableau de bord spécifique en spécifiant son nom de fichier:

include: "my_dashboard.dashboard.lookml"

Enregistrer, prévisualiser et publier le tableau de bord LookML

Pour prévisualiser le tableau de bord:

Enregistrez le fichier .dashboard.lookml en cliquant sur le bouton Save Changes (Enregistrer les modifications) en haut à droite du fichier.
Incluez le tableau de bord dans le fichier de modèle approprié, puis enregistrez les modifications apportées à ce fichier.
Dans le fichier .dashboard.lookml que vous souhaitez prévisualiser, cliquez sur la flèche vers le bas Afficher les actions sur le fichier et sélectionnez Afficher le tableau de bord.

Vous pouvez apporter d'autres modifications à votre fichier .dashboard.lookml, les enregistrer et prévisualiser à nouveau le tableau de bord.

Une fois que vous êtes satisfait de votre tableau de bord, vous pouvez le publier en production, ce qui permet à d'autres utilisateurs disposant des autorisations appropriées de le voir. La méthode de publication du tableau de bord est la même que pour publier d'autres modifications dans LookML sur votre instance et dépend des paramètres de contrôle des versions de votre instance Looker.

Dossier des tableaux de bord LookML

Une fois publiés, les tableaux de bord LookML sont enregistrés par défaut dans le dossier Tableaux de bord LookML. Le dossier Tableaux de bord LookML se trouve dans le dossier Dossiers du panneau de navigation de gauche. Le dossier Tableaux de bord LookML se distingue des autres dossiers à plusieurs égards:

Vous devez inclure un tableau de bord LookML dans au moins un fichier de modèle pour qu'il apparaisse dans le dossier Tableaux de bord LookML.
Pour afficher le dossier Tableaux de bord LookML, les utilisateurs doivent disposer de l'autorisation see_lookml_dashboards.
Pour afficher les tableaux de bord dans le dossier Tableaux de bord LookML, les utilisateurs doivent avoir accès au modèle LookML qui inclut le tableau de bord.
Pour afficher une vignette dans un tableau de bord LookML, les lecteurs de tableaux de bord doivent avoir accès au modèle LookML sur lequel la vignette est basée.
Pour modifier un tableau de bord dans le dossier Tableaux de bord LookML, vous devez disposer de l'autorisation develop sur le modèle qui inclut le tableau de bord LookML.
Pour Explorer à partir d'ici sur une vignette d'un tableau de bord, les lecteurs du tableau de bord doivent disposer de l'autorisation explore pour le modèle sur lequel se base la vignette.
Vous ne pouvez pas créer de dossier dans le dossier Tableaux de bord LookML.

Déplacement des tableaux de bord LookML en dehors du dossier des tableaux de bord LookML

Si vous disposez des autorisations Looker see_lookml_dashboards et develop, ainsi que d'un accès au modèle LookML dans lequel un tableau de bord LookML est inclus, vous pouvez déplacer un tableau de bord LookML vers n'importe quel dossier pour lequel vous disposez du niveau d'accès Gérer l'accès, Modifier.

Il existe deux façons de déplacer le tableau de bord:

Dans le dossier Tableaux de bord LookML, sélectionnez le tableau de bord à déplacer, cliquez sur le bouton Déplacer en haut de la section des tableaux de bord, puis sélectionnez le dossier dans lequel vous souhaitez déplacer le tableau de bord. Pour en savoir plus, consultez la page de documentation Organiser et gérer les contenus.
Dans le dossier Tableaux de bord LookML, cliquez sur le menu à trois points du tableau de bord, sélectionnez Déplacer dans ce menu, puis sélectionnez le dossier dans lequel vous souhaitez déplacer le tableau de bord.

Si vous êtes en mode Développement, vous ne pouvez pas déplacer les tableaux de bord LookML en dehors du dossier Tableaux de bord LookML. À la place, vous pouvez utiliser l'option Importer pour copier le tableau de bord LookML en tant que tableau de bord défini par l'utilisateur dans un autre dossier.

Un dossier contenant à la fois des tableaux de bord définis par l'utilisateur et des tableaux de bord LookML affiche les tableaux de bord LookML dans une section Tableau de bord LookML. Dans la section Tableau de bord LookML, vous pouvez déplacer un tableau de bord LookML vers un autre dossier ou épingler un tableau de bord LookML à un tableau. Toutefois, contrairement aux tableaux de bord définis par l'utilisateur, les tableaux de bord LookML ne peuvent pas être renommés ni déplacés vers la corbeille depuis un dossier.

Si la valeur du paramètre dashboard d'un tableau de bord LookML est modifiée, celui-ci est automatiquement replacé dans le dossier Tableaux de bord LookML.

Affichage du code LookML d'un tableau de bord LookML existant

Si vous disposez de l'autorisation see_lookml, vous pouvez accéder au code LookML d'un tableau de bord LookML existant en sélectionnant Accéder à LookML dans le menu à trois points Actions du tableau de bord d'un tableau de bord:

Lorsque vous sélectionnez Accéder à LookML, Looker accède au fichier du tableau de bord dans lequel le tableau de bord LookML est défini.

Étendre un tableau de bord LookML

Une fois que vous avez créé un tableau de bord LookML, vous pouvez l'étendre. Cela vous permet de créer un second tableau de bord basé sur le tableau d'origine, en ajoutant ou en remplaçant certains paramètres. Ensuite, si vous modifiez le premier tableau de bord, le second hérite automatiquement de ces modifications (sauf s'il est remplacé dans le second). Pour en savoir plus, consultez la page de documentation Réutiliser du code avec des extensions.

Amélioration des performances d'un tableau de bord à l'aide de la reconnaissance d'agrégats

Les développeurs LookML peuvent améliorer les performances des tableaux de bord LookML en utilisant la détection d'agrégats. Grâce à cette fonctionnalité, les développeurs peuvent créer des tables agrégées sous les paramètres LookML explore, ce qui permet d'optimiser les requêtes pour une ou plusieurs vignettes d'un tableau de bord.

Une fois que vous avez créé et affiché un tableau de bord LookML, vous pouvez utiliser l'option Obtenir le code LookML de la table agrégée dans le menu à trois points Actions du tableau de bord, qui s'affiche si vous disposez de l'autorisation see_lookml.

Pour en savoir plus, consultez la page de documentation du paramètre aggregate_table.