Paramètres d'administration : tables dérivées persistantes

Les fonctions de tables dérivées persistantes de Looker vous permettent d'effectuer des analyses complexes dans Looker. Looker affiche plusieurs fonctionnalités d'administration qui peuvent aider à suivre et à résoudre les problèmes de comportement des tables dérivées persistantes sur la page Tables dérivées persistantes, à laquelle les administrateurs et les utilisateurs disposant des autorisations appropriées peuvent accéder depuis la section Base de données du panneau Admin de Looker. (Pour savoir comment résoudre les problèmes liés aux tables dérivées, consultez la page de documentation Tables dérivées dans Looker.)

Remarque :Pour accéder à toutes les pages d'administration de Looker, vous devez disposer du rôle Administrateur. Si vous disposez d'une autorisation qui n'active que certaines parties du panneau Administration, comme manage_schedules ou manage_themes, mais que vous ne disposez pas du rôle Administrateur, il est possible que Looker n'affiche pas la ou les pages décrites dans cet article dans le panneau Administration. En outre, l'autorisation see_admin accorde un accès en lecture seule à la plupart (mais pas à toutes) des pages d'administration. Pour en savoir plus, consultez la description de see_admin.

La page Tables dérivées persistantes n'affiche que les connexions pour lesquelles les tables dérivées persistantes sont activées et les tables dérivées persistantes qui répondent aux critères suivants:

• La table PDT est définie dans un fichier de vue en production, sauf si vous êtes en mode Développement. Dans ce cas, vous pouvez utiliser l'onglet "Development" (Développement) pour afficher la version de développement des tables persistantes.
• La table PDT fait partie d'un modèle correctement configuré.
• Le PDT fait partie d'un modèle auquel vous avez accès aux données.

Les informations de cette page sont basées sur un journal des événements de table de données de référence interne, décrit dans la section Modèle de journal des événements de table de données de référence de cette page.

Personnaliser le tableau

Par défaut, la page Tables dérivées persistantes affiche un maximum de 25 tables dérivées persistantes et charge les tables dérivées persistantes pour toutes les connexions auxquelles vous avez accès aux données sur l'instance Looker. Vous pouvez modifier les données affichées dans le tableau de différentes manières:

1. Cliquez sur la flèche à côté de Toutes les connexions pour afficher les PDT d'une connexion spécifique uniquement. Le sélecteur n'affiche que les connexions pour lesquelles les tables PDT sont activées et auxquelles vous avez accès aux données.
2. Saisissez des mots clés dans le champ de recherche pour affiner la liste des PDT dont le nom inclut le mot clé. Le tableau affiche les PMD avec le terme de recherche correspondant en gras. Cliquez sur le X dans la barre de recherche pour effacer les termes de votre requête de recherche.
3. Cliquez sur l'icône Filtres pour définir un filtre pour le tableau.
4. Cliquez sur l'icône de fermeture/ouverture pour afficher ou masquer la section Aperçu.
5. Cliquez sur le nom d'une colonne pour trier le tableau en fonction de cette colonne. Cliquez une deuxième fois sur le nom de la colonne pour inverser l'ordre de tri.
6. Cliquez sur l'icône Sélectionner les colonnes à afficher pour masquer ou afficher des colonnes dans le tableau.
7. Utilisez le sélecteur d'affichage pour choisir le nombre de résultats à afficher par page. Si le tableau s'étend sur plusieurs pages, vous pouvez cliquer sur les flèches situées en bas au centre de la page pour accéder à la page précédente ou suivante.

Filtrage

Vous pouvez utiliser l'icône Filtres à côté de la barre de recherche pour choisir les tables dérivées persistantes à afficher sur la page Tables dérivées persistantes. Par exemple, vous pouvez filtrer par Last Build Status (État de la dernière compilation) pour afficher uniquement les PDT qui rencontrent une erreur de compilation, ou par Model (Modèle) pour limiter les PDT affichés à un modèle spécifique.

Pour filtrer la page Tables dérivées persistantes:

1. Cliquez sur l'icône Filtres .
2. Sélectionnez une option de filtre dans le premier sélecteur de filtre du menu des filtres. Les options suivantes sont disponibles :
   • Pas déclenchées au cours des dernières : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes qui n'ont pas été déclenchées au cours d'un nombre d'heures et de minutes spécifié.
   • Déclenchées au cours des dernières : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes déclenchées au cours d'un nombre spécifié d'heures et de minutes.
   • Modèle : filtre la page Tables dérivées persistantes pour afficher les tables dérivées persistantes incluses dans un modèle spécifié.
   • Règle de persistance : filtre la page Tables dérivées persistantes par type de persistance des tables dérivées persistantes.
   • État de la dernière tentative : filtre la page Tables dérivées persistantes en fonction d'un état de PDT spécifié.
   • Published as Stable View (Publiée en tant que vue stable) : valeur booléenne qui filtre la page Persistent Derived Tables (Tables dérivées persistantes) pour les tables PDT et affiche Yes (Oui) pour les tables PDT publiées en tant que vue stable et No (Non) pour les tables PDT qui ne l'ont pas été, comme déterminé par la valeur du paramètre publish_as_db_view.
   • Durée de la dernière compilation supérieure à : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes dont la compilation a pris plus de temps qu'un nombre de secondes spécifié.
   • Projet : filtre la page Tables dérivées persistantes par PDT du projet LookML spécifié.
3. Dans le deuxième sélecteur de filtre, choisissez la valeur sur laquelle vous souhaitez filtrer la page Tables dérivées persistantes. Pour les options Pas déclenché au cours des dernières ou Déclenché au cours des dernières, saisissez un nombre d'heures ou de minutes. Pour l'option Durée de la dernière compilation supérieure à, saisissez un nombre de secondes.
4. Cliquez sur Ajouter un filtre pour ajouter d'autres filtres, puis répétez les étapes 2 et 3 pour chaque filtre que vous ajoutez.
   • Pour effacer vos sélections de filtres et recommencer à tout moment, cliquez sur Tout effacer.
   • Pour supprimer des filtres supplémentaires individuels, cliquez sur l'option Effacer du filtre que vous souhaitez supprimer.
5. Pour appliquer les critères de filtre sélectionnés à la page Tables dérivées persistantes, cliquez sur Appliquer.

Les filtres appliqués s'affichent en haut de la page Tables dérivées persistantes.

Cliquez sur le X à côté d'un filtre appliqué sur la page Tables dérivées persistantes pour le supprimer de la page Tables dérivées persistantes. Cliquez sur Tout effacer pour supprimer tous les filtres.

Comprendre la page "PDT"

Les sections suivantes décrivent les informations de la page Tables dérivées persistantes.

Onglets "Production" et "Développement"

Si vous êtes un développeur LookML en mode Développement, la table Tables dérivées persistantes comporte deux onglets:

• L'onglet Production est sélectionné par défaut et affiche les PDT de production. Il s'agit des tables PDT qui ont été déployées en production sur votre instance. Elles fournissent les données pour les requêtes d'exploration de vos utilisateurs. (Si vous êtes en mode Production ou si vous ne disposez pas des autorisations develop, la page Tables dérivées persistantes n'affichera aucun onglet et ne contiendra que des informations sur les tables PDT de production.)

• L'onglet Développement affiche les tables de données de développement. Les PDT de développement n'ont pas encore été transférés vers l'environnement de production.

Looker crée une table PDT de développement lorsqu'un développeur LookML en mode Développement apporte des modifications affectant les données de la table PDT ou la façon dont elle est interrogée. Ces modifications invitent Looker à créer la table PDT de développement, mais Looker ne la génère pas réellement, sauf si la table PDT est interrogée après les modifications. L'onglet Développement peut vous aider à déterminer quelles tables PDT de développement Looker a créées et si elles ont été générées.

Conseil :Vous pouvez également afficher les PDT non compilées dans votre projet à l'aide de l'IDE Looker.

Pour en savoir plus sur les éléments qui déclenchent la création de tables de développement par Looker et la durée de leur persistance dans votre base de données, consultez la page de documentation Tables dérivées dans Looker.

Section "Aperçu"

La section Un aperçu présente un résumé visuel de l'état des tables dérivées persistantes actuellement affichées dans le tableau des tables dérivées persistantes. Si vous avez défini des filtres pour le tableau ou si vous avez utilisé la flèche à côté de Toutes les connexions en haut de la page pour affiner le tableau à une connexion spécifique, la section Un aperçu affinera les résultats pour qu'ils correspondent à ce qui est affiché dans le tableau PDT.

Vous pouvez afficher ou masquer la section Aperçu en cliquant sur l'icône de fermeture/ouverture en haut de la section.

Colonnes de table

Les sections suivantes décrivent les colonnes du tableau sur la page Tables dérivées persistantes. Vous cliquez sur l'icône Sélectionner les colonnes à afficher pour masquer ou afficher certaines des colonnes du tableau. Pour en savoir plus, consultez la section Personnaliser le tableau de cette page.

Nom de la PDT

La colonne Nom de la table PDT affiche le nom de la table PDT tel qu'il est défini dans le paramètre view du fichier de vue LookML de la table PDT.

La colonne Nom de la PDT affiche ces informations supplémentaires sous le nom de la PDT, le cas échéant:

• Ancien build indique que la ligne affiche des informations sur une ancienne compilation de PDT. Pour en savoir plus sur ce message, consultez le pop-up Détails de la PDT dans le menu Options.
• Incrémentiel indique que la table PDT est une table PDT incrémentielle.
• Vue matérialisée indique que la table PDT est une vue matérialisée dans votre base de données.

État de la dernière tentative

La colonne État de la dernière tentative indique l'état de la dernière tentative de compilation de chaque PDT listé:

• Régénération indique que la table PDT peut être interrogée et qu'une table mise à jour est en cours de compilation. Un code temporel indique le début de la compilation de la PDT.
• Success (Réussite) indique qu'une PDT a bien été compilée.
• En cours de compilation indique qu'une table PDT est en cours de compilation et qu'elle ne peut pas être interrogée tant que la compilation n'est pas terminée.
• Not Built (Non compilé) indique qu'une table de données de déploiement n'est pas actuellement compilée.
• Build Error (Erreur de compilation) indique qu'une erreur s'est produite lors d'une compilation. Vous pouvez cliquer sur Build Error (Erreur de compilation) pour afficher la source de l'erreur et accéder au code LookML du PDT si vous disposez des autorisations appropriées pour afficher le code LookML. Consultez la section Menu d'options de cette page pour en savoir plus sur la résolution des problèmes liés aux tables dérivées persistantes sur la page Tables dérivées persistantes.

Dernière tentative à

La colonne Dernière tentative indique l'heure de la dernière tentative de compilation de la table PDT.

Dernière compilation réussie

La colonne Dernière compilation réussie indique l'heure de la dernière compilation réussie de la PDT.

Durée de la dernière compilation

La colonne Durée de la dernière compilation indique la durée (en secondes) de la dernière compilation de cette PDT, ainsi que la durée moyenne de compilation de la PDT (en secondes).

Règle de persistance

La colonne Règle de persistance affiche le type de persistance appliqué à un PDT, tel que défini dans le fichier de vue du PDT. Il indique également la dernière fois qu'une table PDT créée avec succès a été vérifiée (pour les tables PDT de type déclencheur) ou la date à laquelle une table PDT créée avec succès doit expirer (pour les tables PDT de type persist). Deux types de persistance sont affichés dans la colonne Règle de persistance:

• Persist for: (time) (Persister pendant : (durée)) s'affiche pour les tables PDT conservées avec le paramètre persist_for.
• Déclencheur: (nom du groupe de données) s'affiche pour les PDT conservés avec un paramètre datagroup_trigger. Vous pouvez cliquer sur le lien du nom du groupe de données pour afficher la valeur sql_trigger du paramètre datagroup.
• Déclencheur: SQL s'affiche pour les PDT persistantes avec un paramètre sql_trigger_value. Vous pouvez cliquer sur le lien pour afficher l'instruction sql_trigger_value.
• Vue matérialisée s'affiche pour les vues matérialisées, qui exploitent les fonctionnalités de votre base de données pour enregistrer les tables dérivées dans votre base de données.

Projet

La colonne Project (Projet) indique le nom du projet LookML dans lequel le PDT est défini.

Connexion

Si vous sélectionnez Toutes les connexions dans le menu déroulant, la colonne Connexion s'affiche et indique le nom de la connexion sur laquelle le PDT est activé.

Modèle

La colonne Modèle affiche le nom du fichier de modèle dans lequel le fichier de vue du PDT est inclus.

Remarque :Si un fichier de vue PDT est inclus dans plusieurs fichiers de modèle qui partagent la même connexion, plusieurs modèles s'affichent dans la colonne Modèle. Si un fichier de vue PDT est inclus dans plusieurs fichiers de modèle avec différentes connexions, il apparaît également dans d'autres listes de PDT de connexion.

Il est important d'être explicite lorsque vous incluez des fichiers de vue dans des modèles, car inclure tous les fichiers de vue peut encombrer votre schéma de base de données et entraîner la création de plusieurs copies de fichiers PDT dans votre base de données ou dans plusieurs bases de données.

Menu d'options

Le menu à trois points Options  est particulièrement utile pour résoudre les problèmes de comportement inattendu. Les options qu'il présente vous permettent de vérifier la date de la dernière compilation des tables, la durée de la compilation, de comparer la dernière durée de compilation à la durée moyenne de compilation et de vérifier si les déclencheurs fonctionnent correctement. Vous avez le choix entre les options suivantes:

• Accéder à LookML : ouvre le fichier de vue dans lequel la table PDT est définie si vous disposez des autorisations appropriées pour afficher LookML.
• Tableau de bord des activités liées aux PDT : ouvre le tableau de bord des activités liées aux PDT, qui est filtré pour afficher l'activité du PDT sélectionné au cours des quatre dernières semaines.
• Détails de la PDT : ouvre un pop-up contenant plus d'informations et de statistiques sur une PDT spécifique. Pour en savoir plus, consultez la section Fenêtre modale d'informations sur la durée de disponibilité de cette page.

Pour obtenir des conseils de dépannage, consultez la section Surveillance et dépannage des tables PDT sur la page de documentation Tables dérivées dans Looker.

Fenêtre modale "Détails de la PDT"

Cliquez sur l'option Détails du PDT dans le menu à trois points Options  du PDT pour afficher la fenêtre modale des détails du PDT.

Les informations dans la fenêtre modale dépendent de la configuration du PDT. Voici les informations que vous pouvez voir:

• Nom de la table: hachage de la dernière table dérivée persistante créée avec succès.
• Modèle: nom du fichier de modèle dans lequel le fichier de vue du PDT est inclus.
• Nom stable: nom de la vue de base de données stable de la table PDT dans votre base de données, si la table PDT a été publiée en tant que vue stable. Vous pouvez publier une table dérivée en tant que vue stable dans votre base de données en ajoutant l'instruction publish_as_db_view: yes à la table dérivée ou en utilisant l'instruction materialized_view: yes pour transformer la table dérivée en vue matérialisée.
• Connexion: nom de la connexion sur laquelle le PDT est activé.
• Ancien build: valeur booléenne qui affiche Oui si une compilation est une ancienne compilation de PDT ou Non si ce n'est pas le cas.
  • Type de table: pour les anciennes compilations, ce champ s'affiche et indique le type de table. Les valeurs possibles incluent Table d'ancienne génération et Remplacement.
• PDT incrémentielle: valeur booléenne qui affiche Oui si une table dérivée persistante est une table dérivée persistante incrémentielle, ou Non dans le cas contraire.
• État: indique l'état de la dernière tentative. En cas d'échec de la compilation, fournit un message d'erreur SQL et un lien vers le LookML du modèle si l'utilisateur dispose des autorisations appropriées pour afficher le LookML.
• Dépendances: cliquez sur le bouton Afficher le graphique des dépendances pour afficher un diagramme des relations entre toutes les tables dérivées dont cette table dérivée persistante dépend. Chaque nœud du diagramme correspond à une table dérivée. La couleur de chaque nœud correspond à l'état de la table dérivée, comme suit :
  • Un nœud vert représente une PDT qui a bien été compilée.
  • Un nœud jaune représente une PDT en cours de compilation ou d'incrémentation.
  • Un nœud rouge représente une PDT dont la compilation a échoué.
  • Un nœud gris représente une PDT qui n'est pas encore compilée.
  • Un nœud blanc représente un tableau dérivé temporaire, que Looker ne crée pas.
• Dernière compilation :
  • Dernière compilation réussie: date et heure de la dernière compilation réussie de la table PDT.
  • Durée de la dernière compilation: durée de la compilation de la table PDT la plus récente (en secondes, – s'affiche si la table n'a pas encore été créée).
  • Durée moyenne de compilation: durée moyenne de compilation de la table PDT (en secondes) (– s'affiche si la table n'a pas encore été créée).
  • Motif de création: raison pour laquelle une table PDT a été créée (début pour une création initiale ; déclenchement du groupe de données si la table PDT est conservée avec un groupe de données ; modification de la valeur du déclencheur si la valeur du déclencheur SQL de la table PDT a changé).
  • Clé d'incrément: paramètre increment_key pour les tables PDT qui utilisent des builds incrémentaux.
  • Décalage d'incrément: paramètre increment_offset pour les tables PDT qui utilisent des builds incrémentiels.
  • Lignes ajoutées/supprimées lors de la compilation incrémentielle: nombre de lignes ajoutées ou supprimées de la table lors de la dernière incrémentation de la table (– s'affiche si aucune ligne n'a été ajoutée ou supprimée lorsque la stratégie de persistance de la table a déclenché une incrémentation pour la dernière fois).
  • Dernière requête SQL tentée: requête SQL utilisée pour interroger la base de données afin de créer la dernière version de la table.
• Règle de persistance :
  • Type: type de persistance utilisé par la table. Pour connaître les valeurs possibles, consultez la section Colonne "Règle de persistance" de cette page.
  • Persist For (Persister pendant) : pour les tables dérivées persistantes de type Persist (Persister), valeur de la durée de persistance. Non applicable aux PDT de type Déclencheur.
  • Datagroup (Groupe de données) : pour les PDT de déclencheur de groupe de données, indique le nom du groupe de données.
  • Bloc de code SQL: pour les PDT de groupe de données et de déclencheur SQL, le bloc de code affiche l'instruction SQL du déclencheur. Pour les déclencheurs de groupe de données, il s'agit du code SQL du paramètre sql_trigger du groupe de données. Pour les déclencheurs SQL, il s'agit du code SQL pour le paramètre sql_trigger_value.
  • Valeur du déclencheur: pour les tables PDT de type Trigger (déclencheur), valeur qui a déclenché la création de la table PDT (– s'affiche pour les tables PDT créées avec succès qui sont conservées avec un datagroup_trigger ; pour afficher la valeur de déclencheur la plus récente pour un groupe de données, consultez la page Groupes de données dans le panneau Administration).
  • Dernière vérification: pour les tables PDT de type Déclencheur, date et heure de la dernière vérification de la valeur du déclencheur.
  • Expires (Expiration) : date d'expiration de la table PDT, le cas échéant (ne s'applique pas aux déclencheurs de groupe de données).

Tableau de bord des activités liées aux PDT

Le tableau de bord Activité de la table de données temporaire affiche des informations sur la table de données temporaire, ses reconstructions et ses requêtes.

Par défaut, le tableau de bord Activité PDT affiche les informations sur l'activité des quatre dernières semaines. Vous pouvez modifier la période affichée à l'aide de la barre de filtre située en haut du tableau de bord. Le tableau de bord Activité du PDT inclut des cartes qui affichent les informations suivantes:

• Résumé de la table de données de référence qui inclut le nom du modèle et de la vue LookML qui définissent la table de données de référence, le nom de la connexion de base de données utilisée par la table de données de référence, le nombre total d'essais de compilation réussis et échoués de la table de données de référence, ainsi que le pourcentage d'échecs parmi l'ensemble des tentatives de compilation.
• Date et heure de la dernière recompilation complète du fichier PDT.
• Si la table PDT est une table PDT incrémentielle, date et heure de la dernière reconstruction incrémentielle de la table PDT.
• Si la table dérivée persistante est une table dérivée persistante incrémentielle, nombre de regénérations incrémentielles effectuées depuis la dernière regénération complète.
• Temps moyen nécessaire pour regénérer la table PDT.
• Visualisation de tous les événements de création qui se sont produits récemment, regroupés par résumé des types d'actions qui les ont déclenchés.
• Liste de toutes les recompilations de tables de données de performances qui ont eu lieu pendant la période du tableau de bord, y compris la date de chaque recompilation, le nombre de secondes nécessaires pour chaque recompilation, si les recompilations étaient des builds incrémentaux, le déclencheur de chaque recompilation et le nombre de builds de tables de données de performances.
• Liste de toutes les tentatives de recréation ayant échoué, y compris la date et l'heure de début de la recréation, le type d'erreur à l'origine de l'échec, le message d'erreur et le nombre d'échecs de création.
• Liste de tous les événements de déclencheur de recréation de PDT, y compris l'ID de l'événement, la date de l'événement, le type d'événement et les données incluses avec l'événement de déclencheur.
• Liste de tous les événements de recréation de la PDT, y compris l'ID de l'événement, la date de l'événement, le type d'événement et les données incluses avec l'événement de recréation.
• Nombre de requêtes qui ont interrogé directement un champ, regroupées par source de la requête et durée d'exécution moyenne pour chaque source de requête.
• Nombre total de requêtes exécutées sur le PDT.
• Liste de tous les champs PDT interrogés, y compris la vue et le modèle LookML dans lesquels le champ est défini, le nom du champ, le nom de l'exploration exécutée qui inclut le champ et le nombre de fois où le champ a été inclus dans une requête.

Modèle de journal des événements PDT

Looker inclut un modèle prédéfini nommé system_activity qui permet d'explorer facilement le journal des événements de la PDT, qui est une table dans le schéma temporaire d'une connexion de base de données qui suit le déclencheur et l'activité de compilation des PDT.

Vous pouvez accéder au modèle via les liens Événements de compilation récents et Événements de déclenchement récents dans le menu à trois points Options de la page Tables dérivées persistantes, ou depuis la page Connexions du panneau Administration de Looker.

Pour accéder à l'exploration du journal des événements PDT à partir de la page Connexions, sélectionnez l'option Afficher le journal des événements PDT dans le menu déroulant de l'icône en forme de roue dentée  pour chaque connexion.

Vous pouvez explorer le modèle comme n'importe quelle autre exploration Looker. Lorsque vous accédez à l'exploration Journal des événements de la table de données depuis la page Connexions, elle est filtrée pour l'ensemble de la connexion. Lorsque vous accédez à l'exploration Journal des événements de la table dérivée persistante depuis la page Tables dérivées persistantes, elle est filtrée pour une table dérivée persistante spécifique.

Voici un bref guide des champs disponibles dans l'exploration Journal des événements PDT:

Champ	Description
Action	Décrit l'action qui s'est produite, par exemple la régénération, la suppression, la création et la récolte. Pour en savoir plus sur l'affichage et la compréhension des actions de journalisation PDT et des données d'action correspondantes, consultez la page de documentation Comprendre les actions de journalisation PDT.
Données d'action	Fournit des informations plus spécifiques sur une action, y compris le déclencheur utilisé, la valeur d'un déclencheur, la date d'expiration d'une table persistante, la cause d'une recréation, le texte d'un message d'erreur, etc. Pour en savoir plus sur l'affichage et la compréhension des actions de journalisation PDT et des données d'action correspondantes, consultez la page de documentation Comprendre les actions de journalisation PDT.
Connexion	Nom de la connexion sur laquelle se trouve la table dérivée.
Hachage	Chaque table dérivée contient un hachage de l'instruction SQL écrite pour la créer.
ID	Identifiant unique de l'instance Looker qui a généré le PDT. Dans de nombreux cas, il n'y a qu'une seule instance Looker pointant vers une base de données. Vous ne verrez donc qu'un seul ID. Toutefois, si vous disposez d'une instance de préproduction ou d'un élément de ce type, vous pouvez voir plusieurs ID.
Nom du modèle	Nom du modèle à l'aide duquel la table a été générée.
Date de l'événement	Date et heure auxquelles l'événement s'est produit.
Date d'affichage de l'événement UTC	Date et heure auxquelles l'événement s'est produit (UTC)
Séquence	Numéro d'étape dans la compilation du PDT.
Hachage court	Version tronquée du hachage du code SQL écrit pour créer la table dérivée.
Nom de la table	Nom complet du PDT, y compris le préfixe de type de table, un hachage et le nom de la vue.
Tid	ID de la transaction.
Nom de la vue	Nom de la vue pour la table dérivée.