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 vous aider à suivre et à résoudre les problèmes liés au comportement des tables dérivées persistantes, sur la page Tables dérivées persistantes. Les administrateurs et les utilisateurs disposant des autorisations appropriées peuvent y accéder depuis la section Base de données du panneau Administration de Looker. (Consultez la page de documentation Tables dérivées dans Looker pour savoir comment résoudre les problèmes liés aux tables dérivées persistantes.)

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

• Le PDT est défini dans un fichier de vue en production, sauf si vous êtes en mode Développement, auquel cas vous pouvez utiliser l'onglet Développement pour afficher la version de développement des tables persistantes.
• Le PDT fait partie d'un modèle correctement configuré.
• Ce modèle fait partie d'un modèle pour lequel vous disposez d'un accès aux données.

Les informations de cette page sont basées sur un journal d'événements PDT interne, décrit dans la section Modèle de journal d'événements PDT de cette page.

Personnaliser le tableau

Par défaut, la page Tables dérivées persistantes affiche un maximum de 25 PDT sur la page et charge les PDT pour toutes les connexions pour lesquelles vous avez un accès aux données sur l'instance Looker. Vous pouvez modifier les données affichées dans le tableau de plusieurs façons:

1. Cliquez sur la flèche à côté de All Connections (Toutes les connexions) pour afficher uniquement les PDT d'une connexion spécifique. Le sélecteur n'affiche que les connexions pour lesquelles les PDT sont activées et pour lesquelles vous avez accès aux données.
2. Saisissez des mots clés dans le champ de recherche afin d'affiner la liste de termes, dont les noms incluent le mot clé. Le tableau affiche alors les tables dérivées persistantes 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.
3. Cliquez sur l'icône Filtres pour définir un filtre pour le tableau.
4. Cliquez sur l'icône de fermeture pour ouvrir 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 seconde 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 les colonnes du tableau.
7. Cliquez sur les flèches situées en bas de la page pour accéder à la page suivante ou précédente (si le tableau est plus long qu'une seule page).
8. Utilisez le sélecteur d'affichage pour choisir le nombre de résultats à afficher sur une seule page.

Filtrage

Vous pouvez utiliser l'icône Filtres à côté de la barre de recherche pour sélectionner les PDT à afficher sur la page Tables dérivées persistantes. Par exemple, vous pouvez filtrer par Dernier état de compilation pour afficher uniquement les PDT qui rencontrent une erreur de compilation, ou par 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 filtrage dans le premier sélecteur de filtre du menu des filtres. Les options suivantes sont disponibles :
   • Not Triggered in the Last : filtre la page Persistent Derived Tables (Tables dérivées persistantes) en fonction des tables dérivées persistantes qui n'ont pas été déclenchées dans le nombre d'heures et de minutes spécifié.
   • Déclenchement dans la dernière : filtre la page Tables dérivées persistantes en fonction du nombre de tables dérivées persistantes déclenchées dans 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 PDT.
   • Dernière tentative : filtre la page Tables dérivées persistantes en fonction d'un état PDT spécifié.
   • Publié en tant que vue stable : booléen qui filtre la page Tables dérivées persistantes pour les PDT et affiche Oui pour les PDT publiés en tant que vue stable, et Non pour les PDT qui n'ont pas été publiés en tant que vue stable, comme déterminé par la valeur de leur paramètre publish_as_db_view.
   • Last Build Duration Longer Than (Durée de la dernière compilation) : filtre la page Persistent Derived Tables (Tables dérivées persistantes) en fonction des tables dérivées persistantes dont la compilation a duré plus d'un certain nombre de secondes.
   • Projet : filtre la page Tables dérivées persistantes en fonction du paramètre PDT du projet LookML spécifié.
3. Choisissez la valeur sur laquelle vous souhaitez filtrer la page Tables dérivées persistantes dans le deuxième sélecteur de filtre. Pour les options Déclenchement dans la dernière ou Déclenchement dans la dernière, saisissez un nombre d'heures ou de minutes. Pour l'option Durée de la dernière compilation plus longue, saisissez un nombre de secondes.
4. Cliquez sur Ajouter un filtre pour en ajouter d'autres, puis répétez les étapes 2 et 3 pour chaque filtre ajouté.
   • Pour effacer les filtres sélectionnés et recommencer depuis le début, cliquez sur Tout effacer.
   • Pour supprimer d'autres filtres, cliquez sur Effacer au-dessus de celui-ci.
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 signe X à côté d'un filtre appliqué pour le supprimer de la page Tables dérivées persistantes. Cliquez sur Tout effacer pour effacer tous les filtres.

Comprendre la page dédiée

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

Onglets "Production" et "Développement"

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

• L'onglet Production est sélectionné par défaut et affiche les champs "PDT" de production. Il s'agit des PDT qui ont été déployés en production sur votre instance. Ces PDT fournissent les données à vos utilisateurs. Explorez les requêtes. Si vous êtes en mode production ou que vous ne disposez pas des autorisations develop, la page Tables dérivées persistantes n'affiche aucun onglet et fournit des informations sur les tables dérivées persistantes de production uniquement.

• L'onglet Development (Développement) affiche les PDT de développement. Ces PDT sont créés pendant le développement et n'ont pas encore été transférés vers l'environnement de production:

Looker crée un PDT de développement lorsqu'un développeur LookML en mode développement apporte des modifications qui affectent les données du PDT ou la manière dont le PDT est interrogé. Ces modifications invitent Looker à créer le PDT de développement, mais Looker ne le crée pas réellement, sauf si le PDT est interrogé après les modifications. L'onglet Development (Développement) peut vous aider à déterminer quels PDT de développement ont été créés par Looker, et s'ils ont été créés.

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

Consultez la page de documentation Tables dérivées dans Looker pour en savoir plus sur ce qui invite Looker à créer des PDT de développement et sur la durée de conservation des PDT de développement sur votre base de données.

Section "Aperçu"

La section Aperçu affiche un récapitulatif visuel de l'état des tables dérivées persistantes affichées dans le tableau. Si vous avez défini des filtres pour la table ou si vous avez utilisé la flèche à côté de All Connections (Toutes les connexions) en haut de la page pour réduire le tableau à une connexion spécifique, la section At a Glance (Aperçu) réduit les résultats pour qu'ils correspondent à ceux affichés dans le tableau des tables dérivées persistantes.

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 de la page Tables dérivées persistantes. Cliquez sur l'icône Sélectionner les colonnes à afficher pour masquer ou afficher certaines colonnes du tableau. Pour en savoir plus, consultez la section Personnaliser le tableau de cette page.

Nom du PDT

La colonne Nom du PDT affiche le nom du PDT tel que défini dans le paramètre view du fichier de vue LookML de PDT.

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

• Old Build (Ancien build) : indique que la ligne affiche des informations sur un ancien build PDT. Pour plus d'informations sur ce message, consultez le pop-up PDT Details (Détails du tableau de bord) dans le menu Options (Options).
• Incrémentiel indique que le PDT est un PDT incrémentiel.
• La vue matérialisée indique que le disque persistant est une vue matérialisée de votre base de données.

Statut de la dernière tentative

La colonne État de la dernière tentative affiche l'état de la dernière tentative de création de chaque disque persistant répertorié:

• Nouvelle génération en cours indique que le PDT peut être interrogé et qu'une table mise à jour est en cours de création. Un horodatage indique le début de la compilation du PDT.
• Success (Opération réussie) indique qu'un PDT a bien été créé.
  
• Building indique un PDT en cours de compilation et ne peut pas être interrogé tant que la compilation n'est pas terminée.
• Not Build (Non construit) : aucun disque persistant n'est actuellement créé.
  
• Erreur de compilation : indique qu'une erreur s'est produite lors d'une compilation. Vous pouvez cliquer sur Build Error (Compiler l'erreur) pour voir la source de l'erreur et accéder au LookML PDT si vous disposez des autorisations appropriées pour afficher LookML. Pour en savoir plus sur la résolution des problèmes liés aux tables dérivées persistantes (PDT), consultez la section Menu d'options de 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 du fichier.

Dernier build réussi

La colonne Last Success Build (Dernière compilation réussie) indique l'heure de la dernière compilation réussie de l'outil PDT.

Durée du dernier build

La colonne Last Build Duration (Durée de la dernière compilation) affiche la durée (en secondes) requise pour la dernière compilation de ce disque persistant, ainsi que le temps moyen nécessaire pour le créer.

Règle de persistance

La colonne Règle de persistance affiche le type de persistance appliquée à un disque persistant, tel que défini dans le fichier de vue du disque persistant. Il indique également la dernière fois où un PDT a bien été créé (pour le type de déclencheur PDT) ou lorsqu'un PDT créé avec succès doit expirer (pour le type PDT persistant). Il existe deux types de persistance affichés dans la colonne Persistence Rule (Règle de persistance) :

• L'option Persistance pour: (heure) s'affiche pour les tables persistantes persistantes persistantes avec le paramètre persist_for.
• Déclencheur: (nom du groupe de données) s'affiche pour les tables persistantes persistantes persistantes 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.
• Trigger: 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.
• La vue matérialisée s'affiche pour les vues matérialisées, qui exploitent les fonctionnalités de votre base de données pour conserver les tables dérivées de 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 l'option All Connections (Toutes les connexions) est sélectionnée, la colonne Connection (Connexion) affiche le nom de la connection 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 disque persistant est inclus.

Si un fichier de vue PDT est inclus dans plusieurs fichiers de modèle partageant la même connexion, plusieurs modèles apparaissent dans la colonne Modèle. Si un fichier de vue PDT est inclus dans plusieurs fichiers de modèle avec des connexions différentes, le PDT apparaîtra également dans d'autres listes de PDT de connexion.

Il est important d'être explicite lorsque vous incluez des fichiers de vue dans les 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 tables dérivées persistantes sur votre base de données ou sur plusieurs bases de données.

Menu "Options"

Le menu à trois points Options est particulièrement utile pour résoudre des problèmes de comportement inattendu. Les options qu'il propose vous permettent de vérifier quand les tables ont été créées pour la dernière fois, de savoir combien de temps elles ont pris pour compiler, de comparer la date et l'heure de la dernière compilation par rapport à la durée moyenne, et de vérifier que les déclencheurs fonctionnent correctement. Vous avez le choix entre:

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

Pour obtenir d'autres conseils de dépannage, consultez l'article Résoudre les problèmes liés à la génération des fichiers PDT dans le centre d'aide.

Fenêtre modale sur les détails des tables dérivées persistantes

Cliquez sur l'option PDT Details (Détails du PDT) dans le menu Options à trois points associé à l'outil.

Les informations contenues dans la fenêtre modale dépendent de la configuration du PDT. Voici les informations qui peuvent s'afficher:

• Nom de la table: le hachage du dernier PDT créé.
• Modèle: nom du fichier de modèle dans lequel le fichier de vue "PDT" est inclus.
• Nom stable: nom de la vue de base de données stable de la base de données, si celle-ci a été publiée en tant que vue stable. Vous pouvez publier un disque persistant en tant que vue stable sur 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 faire de la table dérivée une vue matérialisée.
• Connection (Connexion) : nom de la connexion sur laquelle le PDT est activé.
• Old Build (Ancien build) : valeur booléenne indiquant Yes (Oui) si un build est un ancien build PDT ou No dans le cas contraire.
  • Type de table : pour les anciennes compilations, ce champ apparaît et indique le type de table. Les valeurs incluent Old Gen Table et Standin.
• PDT incrémentiel : valeur booléenne indiquant Yes si un PDT est un PDT incrémentiel ou No dans le cas contraire.
• État: indique l'état de la dernière tentative. Pour les échecs de compilation, un message d'erreur SQL et un lien vers le LookML du modèle s'affichent si l'utilisateur dispose des autorisations appropriées pour afficher LookML.
• Dépendances: cliquez sur le bouton Show Dependency Graph (Afficher le graphique de dépendance) pour afficher un diagramme de la relation pour toutes les tables dérivées sur lesquelles ce PDT 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 un PDT qui a bien été créé.
  • Un nœud jaune représente un PDT en cours de création ou d'incrémentation.
  • Un nœud rouge représente un PDT qui n'a pas pu être compilé.
  • Un nœud gris représente un PDT qui n'est pas encore créé.
  • Un nœud blanc représente une table dérivée temporaire que Looker ne crée pas.
• Dernière compilation :
  • Dernière compilation réussie: date et heure de la compilation PDT la plus récente.
  • Last build Build Duration (Durée de la dernière compilation) : durée de la compilation PDT la plus récente (en secondes ; affiche - si la table n'a pas encore été compilée).
  • Average Build Duration (Durée moyenne de compilation) : durée moyenne de compilation du PDT (en secondes ; affiche - si la table n'a pas encore été compilée).
  • Motif de compilation : raison pour laquelle un PDT a été créé (inception pour un build initial ; datagroup triggered (groupe de données déclenché) si le PDT est conservé avec un groupe de données ; trigger value change (déclenchement de la valeur du déclencheur) si la valeur du déclencheur SQL PDT a été modifiée).
  • Increment Key (Clé d'incrémentation) : paramètre increment_key pour les PDT utilisant des builds incrémentiels.
  • Increment Offset (Décalage d'incrément) : paramètre increment_offset pour les PDT utilisant des builds incrémentiels.
  • Incrémenter des lignes ajoutées/supprimées de compilation: nombre de lignes ajoutées à une table ou supprimées de celle-ci lors de sa dernière incrémentation (affiche la valeur – si aucune ligne n'a été ajoutée ou supprimée lors de la dernière activation de la stratégie de persistance de la table).
  • Dernière tentative en SQL: SQL utilisé pour interroger la base de données afin de créer la dernière compilation de la table.
• Règle de persistance :
  • Type: type de persistance utilisé par la table. Consultez la section Colonne "Règle de persistance" de cette page pour connaître les valeurs possibles.
  • Persist For (Persistance du champ) : pour le type Persist (PDT), la valeur de la durée de la persistance. Non applicable aux PDT de type Déclencheur.
  • Datagroup : indique le nom du groupe de données pour les déclencheurs de groupe de données.
  • Bloc de code SQL: pour les PDT des groupes de données et des déclencheurs SQL, le bloc de code affiche l'instruction SQL du déclencheur. Pour les déclencheurs de groupes 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 SQL du paramètre sql_trigger_value.
  • Trigger Value (Valeur du déclencheur) : pour les PDT de type Trigger, valeur qui a déclenché la compilation PDT (affiche le caractère – pour les PDT réussis qui sont conservés avec un datagroup_trigger). Pour connaître 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 Admin.
  • Dernière vérification : pour le champ Déclencheur, saisissez PDT lorsque la valeur du déclencheur a été vérifiée pour la dernière fois.
  • Expiration : date d'expiration du PDT, le cas échéant (non applicable aux déclencheurs du groupe de données).

Tableau de bord des activités PDT

Le tableau de bord PDT Activity (Activité PDT) affiche des informations sur le PDT, ses recompilations et ses requêtes:

Le tableau de bord Activité PDT affiche par défaut les informations sur l'activité des quatre semaines précédentes. 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 PDT Activity (Activité PDT) contient des tuiles présentant les informations suivantes:

• Résumé du PDT comprenant le nom du modèle et de la vue LookML qui définissent le PDT, le nom de la connexion de la base de données utilisée par le PDT, le nombre total de tentatives de compilation réussies et échouées, ainsi que le pourcentage du nombre total de tentatives de compilation infructueuses.
• Date et heure de la dernière recompilation complète du PDT.
• Si le PDT est un PDT incrémentiel, il s'agit de la date et de l'heure de la recompilation incrémentielle la plus récente.
• Si le PDT est un PDT incrémentiel, le nombre de recompilation incrémentales effectuées depuis la recompilation complète la plus récente.
• Temps moyen nécessaire pour recréer le PDT.
• Visualisation de tous les événements de création qui ont eu lieu récemment, regroupés par récapitulatif des types d'actions à l'origine des événements.
• Liste de toutes les recompilations de PDT ayant eu lieu au cours de la période du tableau de bord, avec la date de chaque recompilation, le nombre de secondes de chaque recompilation, les incréments de PDT, le déclencheur à l'origine de chaque recompilation et le nombre de PDT.
• Liste de toutes les tentatives de recompilation ayant échoué, avec la date et l'heure de début de la recompilation, 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 du déclencheur de recompilation PDT, y compris le numéro de l'événement, la date, le type et les données incluses avec l'événement
• Liste de tous les événements de recompilation PDT, y compris le numéro 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 recompilation
• Nombre de requêtes ayant effectué une requête directe sur un champ, regroupées selon la source de la requête et l'environnement d'exécution moyen de chaque source de requête.
• Nombre total de requêtes exécutées sur le disque persistant.
• 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'exécution de l'exploration incluant ce 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 "PDT", qui est une table dans un schéma temporaire de connexion à une base de données qui suit le déclencheur et l'activité de compilation des tables dérivées persistantes. Vous pouvez accéder au modèle via les liens Événements de compilation récents et Événements de déclencheur récents du menu à trois points Options de la page Tables dérivées persistantes, ou de la page Connexions du panneau Admin de Looker. Pour accéder au journal des événements PDT : à partir de la page Connections (Connexions), sélectionnez l'option Show PDT Event Log (Afficher le journal des événements PDT) dans le menu déroulant en forme de roue dentée, à l'extrémité droite de chaque connexion :

Vous pouvez explorer le modèle comme vous le feriez avec n'importe quelle autre fonction d'exploration Looker. Lorsque vous y accédez depuis la page Connexions, l'exploration du journal des événements PDT est filtrée de manière à afficher l'ensemble de la connexion. Lorsque vous y accédez depuis la page Tables dérivées persistantes, l'exploration Journal des événements PDT est filtrée pour un PDT spécifique.

Voici un bref aperçu des champs disponibles:

Champ	Description
Action	Décrit l'action qui a eu lieu. Il peut s'agir d'activités de régénération, de suppression, de création et d'extraction. Consultez la page de documentation Comprendre les actions des journaux PDT pour en savoir plus sur l'affichage et la compréhension des actions des journaux PDT et des données d'action correspondantes.
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, le délai d'expiration d'une table persistante, la cause d'une recompilation, le texte d'un message d'erreur, etc. Consultez la page de documentation Comprendre les actions du journal PDT pour en savoir plus sur l'affichage et la compréhension des actions du journal PDT et les données d'action correspondantes.
Connexion	Nom de la connexion sur laquelle la table dérivée existe.
Hash	Chaque table dérivée contient un hachage du code SQL qui a été écrit pour la créer.
ID	ID unique de l'instance Looker ayant généré le PDT. Dans de nombreux cas, une seule instance Looker pointe vers une base de données. Vous ne voyez donc qu'un seul ID. Toutefois, si vous disposez d'une instance de préproduction, ou d'un élément de cette nature, vous pouvez voir plusieurs ID.
Nom de modèle	Nom du modèle à l'aide duquel la table a été générée.
Date d'occurrence	Date et heure auxquelles l'événement s'est produit.
Date d'affichage de l'UCT Occur	Date et heure auxquelles l'événement s'est produit (UTC).
Séquence	Numéro d'étape dans la compilation PDT.
Hachage court	Version tronquée du hachage du code SQL qui a été écrit pour créer la table dérivée.
Table Name	Nom complet du disque persistant, y compris le préfixe de type table, un hachage et le nom de la vue.
TID	ID de la transaction.
Afficher le nom	Nom de la vue pour la table dérivée.