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

Paramètres d'administration - Tables dérivées persistantes

Les 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 de PDT sur la page Tables dérivées persistantes auxquelles les administrateurs et les utilisateurs disposant des autorisations appropriées peuvent accéder depuis la section Base de données du panneau Administration de Looker. Pour en savoir plus sur le dépannage des tables dérivées persistantes, consultez la page de documentation Tableaux dérivés dans Looker.

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

La PDT est définie dans un fichier de vue en production, sauf si vous êtes en mode développement, auquel cas vous pouvez utiliser l'onglet Development pour afficher la version de développement des tables persistantes.
La PDT fait partie d'un modèle correctement configuré.
La PDT 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 des événements PDT interne, décrit dans la section Modèle de journal des é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 disposez d'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:

Cliquez sur la flèche à côté de All Connections (Toutes les connexions) pour afficher uniquement les tables dérivées persistantes d'une connexion spécifique. Le sélecteur n'affiche que les connexions pour lesquelles les tables dérivées persistantes sont activées et auxquelles vous avez accès.
Saisissez des mots clés dans le champ de recherche pour limiter la liste des PDT aux PDT dont les noms incluent le mot clé. Le tableau affiche les tables dérivées persistantes avec le terme de recherche correspondant en gras. Cliquez sur X dans la barre de recherche pour effacer les termes de votre requête de recherche.
Cliquez sur l'icône Filtres pour définir un filtre pour le tableau.
Cliquez sur l'icône Fermer/Ouvrir pour afficher ou masquer la section Aperçu.
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.
Cliquez sur l'icône Sélectionner les colonnes à afficher pour masquer ou afficher les colonnes dans le tableau.
Utilisez le sélecteur d'affichage pour choisir le nombre de résultats à afficher sur une seule page. Si le tableau est plus long qu'une seule page, vous pouvez cliquer sur les flèches en bas au centre de la page pour accéder à la page suivante ou précédente.

Filtrage

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

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

Cliquez sur l'icône Filtres.
Sélectionnez une option de filtrage dans le premier sélecteur de filtre du menu "Filtre". Les options suivantes sont disponibles :
- Déclenchée dans la dernière : filtre la page 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éclenchée dans la dernière : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes déclenchées en un certain nombre d'heures et de minutes.
- Modèle : filtre sur la page Tables dérivées persistantes les PDT incluses dans un modèle spécifié.
- Règle de persistance : filtre la page Tables dérivées persistantes par type de persistance PDT.
- Last tent Status (État de la dernière tentative) : filtre la page Persistent Derived Tables (Tables dérivées persistantes) en fonction d'un état de 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 Yes pour les PDT publiées en tant que vue stable, et No pour les PDT qui n'ont pas été publiées 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 supérieure à la durée maximale) : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes dont la compilation a pris plus de quelques secondes.
- Project (Projet) : filtre la page Tables dérivées persistantes en fonction des tables dérivées persistantes du projet LookML spécifié.
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 Non déclenché au cours de la période ou Déclenchée dans la dernière période, saisissez un nombre d'heures ou de minutes. Pour l'option Last Build Duration Longer Than (Durée de la dernière compilation supérieure à), indiquez un nombre de secondes.
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 d'autres filtres, cliquez sur Effacer au-dessus du filtre à supprimer.
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 PDT

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 Développement, la table Tables dérivées persistantes comporte deux onglets:

L'onglet Production est sélectionné par défaut et affiche les tables dérivées persistantes de la production. Il s'agit des tables dérivées persistantes déployées en production sur votre instance. Elles fournissent les données nécessaires aux requêtes Explorer 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'affiche aucun onglet et n'affiche des informations que pour les tables dérivées persistantes de production.
L'onglet Development (Développement) affiche les PDT de développement. Les tables dérivées persistantes du développement n'ont pas encore été transférées vers l'environnement de production.

Looker crée une PDT de développement lorsqu'un développeur LookML en mode Développement apporte des modifications qui affectent les données de la PDT ou la manière dont la PDT est interrogée. Ces modifications invitent Looker à créer la PDT de développement, mais elle ne la compile pas réellement, sauf si elle est interrogée 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é compilés.

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

Section Aperçu

La section Aperçu affiche un résumé visuel de l'état des tables dérivées persistantes actuellement affichées dans le tableau. 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 restreindre le tableau à une connexion spécifique, la section Aperçu réduit les résultats pour qu'ils correspondent à ceux affichés dans le tableau des tables PDT.

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

Colonnes de table

Les sections suivantes décrivent les colonnes de la page Tables dérivées persistantes. Vous pouvez cliquer 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 de la PDT

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

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

Old Build (Ancienne compilation) indique que la ligne affiche des informations sur une ancienne compilation de PDT. Pour plus d'informations sur ce message, consultez le pop-up PDT Details (Détails du PST) du menu Options.
Incremental indique que la PDT est une PDT incrémentielle.
La vue matérialisée indique que la PDT est une vue matérialisée de votre base de données.

État de la dernière tentative

La colonne État de la dernière tentative affiche l'état de la dernière tentative de compilation de chaque PDT indiquée:

La nouvelle génération indique que la PDT peut être interrogée et qu'une table mise à jour est en cours de compilation. Un horodatage indique le début de la compilation de la PDT.
Succès indique que la PDT a été correctement compilée.
Building (Compilation) indique qu'une PDT est en cours de compilation et ne peut pas être interrogée tant que la compilation n'est pas terminée.
Non compilé indique qu'aucune PDT n'est actuellement créée.
Erreur de compilation : indique qu'une erreur s'est produite lors d'une compilation. Vous pouvez cliquer sur Erreur de compilation pour afficher la source de l'erreur et accéder au LookML de la PDT si vous disposez des autorisations appropriées pour afficher LookML. Consultez la section Menu d'options de cette page pour savoir comment résoudre les problèmes de 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 PDT.

Dernière compilation réussie

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

Durée de la dernière compilation

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

Règle de persistance

La colonne Règle de persistance affiche le type de persistance appliquée à une PDT, tel que défini dans le fichier de vue de la PDT. Cela indique également la dernière fois qu'une PDT a bien été vérifiée (pour les PDT de type déclencheur) ou lorsqu'une PDT correctement compilée doit expirer (pour les PDT de type persistant). Il existe deux types de persistance affichés dans la colonne Règle de persistance:

L'option Persistance pour: (heure) s'affiche pour les tables dérivées persistantes qui sont conservées avec le paramètre persist_for.
Déclencheur: (nom du groupe de données) s'affiche pour les tables dérivées persistantes qui sont conservées 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 tables persistantes persistantes 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 celle-ci.

Projet

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

Connexion

Si All Connections (Toutes les connexions) est sélectionné dans la sélection de connexion, la colonne Connection (Connexion) affiche le nom de la connexion sur laquelle la PDT est activée.

Modèle

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

Si un fichier de vue de 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 de PDT est inclus dans plusieurs fichiers de modèle avec différentes connexions, il apparaîtra également dans les autres listes de PDT de connexion.

Il est important d'être explicite lorsque vous incluez des fichiers de vue dans les modèles, car l'inclusion de 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 Options à trois points est particulièrement utile pour résoudre les problèmes liés à un comportement inattendu. Les options présentées vous permettent de vérifier quand les tables ont été compilées pour la dernière fois, de vérifier la durée de la compilation, de comparer la dernière date de compilation par rapport à la durée moyenne de compilation et de vérifier si les déclencheurs fonctionnent correctement. Vous avez le choix parmi les options suivantes:

Accéder à LookML : ouvre le fichier de vue dans lequel la PDT est définie si vous disposez des autorisations appropriées pour afficher LookML.
PDT Activity Dashboard (Tableau de bord des activités PDT) : ouvre le tableau de bord des activités PDT, qui est filtré afin d'afficher les activités correspondant à la PDT sélectionnée au cours des quatre dernières semaines.
PDT Details (Détails de la PDT) : ouvre un pop-up contenant plus d'informations et de statistiques pour une PDT spécifique. Pour en savoir plus, consultez la section modale PDT des détails de cette page.

Pour obtenir des conseils de dépannage, consultez la section Surveillance et dépannage des tables dérivées persistantes de la page de documentation Tableaux dérivés dans Looker.

Détails de la fenêtre PDT

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

Les informations dans la fenêtre modale dépendent de la configuration de la PDT. Les informations suivantes peuvent s'afficher:

Nom de la table: le hachage de la dernière PDT compilée.
Modèle: nom du fichier de modèle dans lequel le fichier de vue de la PDT est inclus.
Stable Name (Nom stable) : nom de la vue stable de la base de données sur votre base de données, si celle-PDT a été publiée en tant que vue stable. Vous pouvez publier une PDT 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 faire de la table dérivée une vue matérialisée.
Connection (Connexion) : nom de la connexion sur laquelle la PDT est activée.
Ancien build: valeur booléenne indiquant Yes 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: booléen qui affiche Yes si une PDT est une PDT incrémentiel ou No dans le cas contraire.
État: indique État de la dernière tentative. Pour les compilations ayant échoué, 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 LookML.
Dépendances: cliquez sur le bouton Show Dependency Graph (Afficher le graphique de dépendances) pour afficher un diagramme de relation de toutes les tables dérivées dont la 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 une PDT qui a été correctement compilée.
- 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 une PDT qui n'est pas encore compilée.
- 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 dernière compilation de PDT.
- Last Search Build Duration (Durée de la dernière compilation) : durée de la dernière compilation de PDT (en secondes ; affiche – si la table n'a pas encore été compilée).
- Durée moyenne de compilation: durée moyenne de compilation de la PDT (en secondes ; affiche – si la table n'a pas encore été compilée).
- Motif de la compilation: raison pour laquelle une PDT a été compilée (inception pour une compilation initiale ; groupe de données déclenché si la 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 PDT a changé).
- Increment Key (Clé d'incrémentation) : paramètre increment_key pour les tables dérivées persistantes qui utilisent des builds incrémentiels.
- Incrément Offset: paramètre increment_offset pour les tables dérivées persistantes qui utilisent des builds incrémentiels.
- Incrémenter les lignes ajoutées/supprimées: nombre de lignes ajoutées à la table ou supprimées lors de sa dernière incrémentation (s'affiche – si aucune ligne n'a été ajoutée ou supprimée lors de la dernière persistance de la table).
- Dernière tentative de saisie SQL: le 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. Voir la colonne Règle de persistancede la colonne de cette page pour connaître les valeurs possibles.
- Persistance For (Persistance des données) : pour les valeurs PDS (Persistance), saisissez la valeur de durée de persistance. Non applicable pour les tables dérivées persistantes de type Déclencheur.
- Datagroup: indique le nom du groupe de données pour les tables dérivées persistantes des groupes de données.
- Bloc de code SQL: pour les tables dérivées persistantes 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 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 SQL pour le paramètre sql_trigger_value.
- Trigger Value (Valeur du déclencheur) : pour les tables dérivées persistantes du type Trigger (Déclencheur), la valeur qui a déclenché la compilation de la PDT (affiche – pour les tables dérivées persistantes correctement compilées et conservées avec un datagroup_trigger). Pour afficher la valeur du déclencheur la plus récente pour un groupe de données, consultez la page Groupes de données du panneau Administration.
- Last Verified (Dernière vérification) : pour les PDT de type Déclencheur, date de la dernière vérification de la valeur du déclencheur.
- Expiration: lorsque la PDT expire, le cas échéant (non applicable aux déclencheurs des groupes de données).

Tableau de bord des activités PDT

Le tableau de bord PDT Activity (Activité PDT) affiche des informations sur la PDT, ses recompilations 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 en haut du tableau de bord. Le tableau de bord PDT Activity (Activité PDT) contient des tuiles présentant les informations suivantes:

Résumé de la PDT incluant le nom du modèle et de la vue LookML qui définissent celle-ci, le nom de la connexion de la PDT utilisée par la PDT, le nombre total de tentatives de compilation ayant réussi et échoué, ainsi que le pourcentage de tentatives de compilation ayant échoué.
Date et heure de la dernière recompilation complète de la PDT.
Si la PDT correspond à une PDT incrémentiel, il s'agit de la date et de l'heure de la recompilation incrémentielle la plus récente.
Si la PDT est une PDT incrémentiel, il s'agit du nombre de recompilations incrémentielles qui ont eu lieu depuis la recompilation complète la plus récente.
Temps moyen nécessaire pour recréer la PDT.
Visualisation de tous les événements de création qui ont eu lieu récemment, regroupés par un résumé des types d'actions à l'origine des événements.
Liste de toutes les recompilations 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, le type de recompilation, 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, comprenant le numéro d'événement, la date de l'événement, le type d'événement et les données incluses avec l'événement déclencheur.
Liste de tous les événements de recompilation PDT, y compris le numéro d'événement, la date, le type et les données incluses avec la recompilation.
Nombre de requêtes ayant directement interrogé un champ, regroupées selon la source et la durée moyenne d'exécution de chaque source de requête.
Nombre total de requêtes exécutées sur la PDT.
Liste de tous les champs de 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 qui a inclus le champ et le nombre de fois où ce 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, une table du schéma temporaire d'une connexion à une base de données qui suit le déclencheur et l'activité de compilation des PDT. Vous pouvez accéder au modèle à l'aide des liens Événements de compilation récents et Événements déclencheurs récents situés 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 au journal des événements PDT sur la page Connexions, sélectionnez l'option Afficher le journal des événements PDT dans le menu déroulant en forme de roue dentée situé tout à droite de chaque connexion.

Vous pouvez explorer le modèle comme avec n'importe quelle autre exploration Looker. Sur la page Connexions, l'exploration du journal des événements PDT est filtrée de manière à inclure toute la connexion. Lorsque vous accédez à cette page à partir de la page Tables dérivées persistantes, l'exploration PDT Event Log est explorée en fonction d'une PDT spécifique.

Voici un bref guide des champs disponibles:

Champ	Description
Action	Décrit l'action qui s'est produite. Il peut s'agir de la régénération, de l'abandon, de la création et de la récupération de l'activité. Consultez la page de documentation sur les actions des journaux des tables PDT persistantes pour en savoir plus sur leur affichage et les données correspondantes.
Données d'action	Fournit des détails 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 sur les actions des journaux des PDT persistantes pour en savoir plus sur leur affichage et les données 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 qui a généré la PDT. Bien souvent, il n'y aura 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 autre élément de ce type, plusieurs ID peuvent apparaître.
Nom du 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 Utc d'occurrence	Date et heure auxquelles l'événement s'est produit (UTC).
Séquence	Numéro d'étape dans le build PDT.
Hachage court	Version tronquée du hachage SQL qui a été écrit pour créer la table dérivée.
Nom de la table	Nom complet de la PDT, y compris le préfixe de type table, un hachage et le nom de la vue.
Mar.	ID de la transaction.
Nom de la vue	Nom de la vue pour la table dérivée.