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.

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

Les fonctions de tables dérivées persistantes (PDT) de Looker vous permettent d'effectuer des analyses complexes au sein de Looker. Looker affiche plusieurs fonctionnalités d'administration qui peuvent vous aider à suivre et à résoudre les problèmes de comportement des PDT 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. Pour en savoir plus sur la résolution des problèmes liés aux PDT, consultez la page de documentation Tables dérivées dans Looker.

La page Tables dérivées persistantes affiche uniquement les connexions pour lesquelles les PDT sont activées et uniquement les PDT 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. Dans ce cas, vous pouvez utiliser l'onglet Développement 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 avez 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 et charge des PDT pour toutes les connexions pour lesquelles vous avez accès aux données sur l'instance Looker. Il existe plusieurs façons de modifier les données affichées dans le tableau:

Cliquez sur la flèche à côté de Toutes les connexions pour afficher les PDT d'une connexion spécifique uniquement. Le sélecteur affiche uniquement les connexions pour lesquelles les PDT sont activées et auxquelles vous avez accès aux données.
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 PDT 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.
Cliquez sur l'icône Filtres afin de 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 du tableau.
Utilisez le sélecteur d'affichage pour choisir le nombre de résultats à afficher sur une seule page. Si le tableau comporte plus d'une page, vous pouvez cliquer sur les flèches situées en bas et 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 choisir les tables PDT à afficher sur la page Tables dérivées persistantes. Par exemple, vous pouvez filtrer par État de la dernière compilation pour n'afficher que les PDT qui rencontrent une erreur de compilation, ou par Modèle pour limiter les PDT affichées auprès d'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 filtre dans le premier sélecteur de filtre du menu des filtres. Les options suivantes sont disponibles :
- Non déclenché au cours de la dernière : filtre la page Tables dérivées persistantes en fonction des PDT qui n'ont pas été déclenchées au cours d'un nombre d'heures et de minutes spécifié.
- Déclenchement au cours de la dernière : filtre la page Tables dérivées persistantes en fonction des PDT qui ont été déclenchées au cours d'un nombre d'heures et de minutes spécifié.
- Modèle : filtre la page Tables dérivées persistantes pour les PDT incluses dans un model spécifié.
- Règle de persistance : filtre la page Tables dérivées persistantes par type de persistance des PDT.
- État de la dernière tentative : filtre la page Tables dérivées persistantes en fonction d'un état de PDT spécifié.
- Publiée en tant que vue stable : valeur booléenne qui filtre la page Tables dérivées persistantes pour les PDT et affiche Oui pour les PDT publiées en tant que vue stable et Non pour les PDT qui n'ont pas été publiées en tant que vue stable, comme déterminé par la valeur du paramètre publish_as_db_view.
- Last Build Duration Longer Than : filtre la page Tables dérivées persistantes en fonction des PDT dont les compilations ont pris plus d'un nombre de secondes spécifié.
- Project : filtre la page Tables dérivées persistantes en fonction des PDT issues 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é lors des derniers ou Déclenchement au cours des derniers, 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 à), saisissez un nombre de secondes.
Cliquez sur Ajouter un filtre pour ajouter d'autres filtres, et répétez les étapes 2 et 3 pour chaque filtre que vous ajoutez.
- Pour effacer les sélections de filtres et recommencer à tout moment, cliquez sur Tout effacer.
- Pour supprimer un filtre supplémentaire, 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.

Sur la page Tables dérivées persistantes, cliquez sur le X à côté d'un filtre appliqué pour supprimer le filtre 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 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 PDT qui ont été déployées en production sur votre instance. Ces PDT 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'affiche aucun onglet, et la page affiche des informations sur les PDT de production uniquement.)
L'onglet Développement affiche les PDT de développement. Les PDT de 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 façon dont la PDT est interrogée. Ces modifications invitent Looker à créer la PDT de développement, mais ne la compile pas réellement, sauf si la PDT est interrogée une fois les modifications apportées. L'onglet Développement peut vous aider à déterminer les PDT de développement que Looker a créées et si elles ont été compilées.

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

Section "Aperçu"

La section Aperçu affiche un résumé visuel de l'état des PDT actuellement affichées dans le tableau des PDT. 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 limiter le tableau à une connexion spécifique, la section Aperçu limite les résultats pour qu'ils correspondent à ce qui est affiché dans le tableau des 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 table 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 plus d'informations, 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 que défini dans le paramètre view du fichier de vue LookML de la table PDT.

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

Old 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 PDT Details dans le menu Options.
Incrémental 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 répertoriée:

Le message Nouvelle génération indique que la PDT peut être interrogée et qu'une table mise à jour est en cours de création. Un code temporel indique le début de la création de la PDT.
Success indique qu'une table PDT a bien été compilée.
Building (Compilation) indique qu'une PDT est en cours de création et ne peut pas être interrogée tant que la compilation n'est pas terminée.
Non compilée indique qu'une table PDT n'est pas compilée actuellement.
Erreur de compilation indique qu'une erreur s'est produite lors d'une compilation. Vous pouvez cliquer sur Build Error (Erreur de compilation) pour voir la source de l'erreur et accéder au code LookML de la table PDT si vous disposez des autorisations appropriées pour consulter le code LookML. Consultez la section Menu d'options de cette page pour en savoir plus sur le dépannage des PDT à partir 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 de PDT.

Dernière compilation réussie

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

Durée de la dernière compilation

La colonne Durée de la dernière compilation affiche la durée (en secondes) nécessaire pour la dernière compilation de cette PDT et le temps moyen nécessaire pour générer la PDT (en secondes).

Règle de persistance

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

Persistance pendant: (durée) s'affiche pour les tables PDT conservées avec le paramètre persist_for.
Trigger: (datagroup name) (Déclencheur : nom du groupe de données) s'affiche pour les tables PDT 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 PDT conservées 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 la fonctionnalité de votre base de données pour conserver les tables dérivées dans votre base de données.

Projet

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

Connexion

Si l'option Toutes les connexions est sélectionnée, la colonne Connexion apparaît et 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 table PDT est inclus.

Menu "Options"

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

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

Consultez la section Surveillance et dépannage des tables dérivées persistantes sur la page de documentation Tables dérivées dans Looker pour obtenir des conseils de dépannage.

Fenêtre des détails des PDT

Cliquez sur l'option PDT Details (Détails de la table PDT) dans le menu à trois points Options pour afficher la fenêtre modale "PDT Details".

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

Nom de la table: hachage de la dernière PDT générée.
Modèle: nom du fichier de modèle dans lequel le fichier de vue de la table PDT est inclus.
Stable Name (Nom stable) : nom de la vue stable de la table PDT sur votre base de données, si la 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.
Connexion: nom de la connexion sur laquelle la PDT est activée.
Ancienne compilation: valeur booléenne qui affiche Yes (Oui) si une compilation est une ancienne compilation de PDT ou No dans le cas contraire.
- Table Type (Type de table) : pour les anciennes compilations, ce champ apparaît et indique le type de table. Les valeurs possibles sont Old Generation Table et Standin.
PDT incrémentielle: valeur booléenne qui affiche Yes (Oui) si une PDT est une PDT incrémentielle ou No dans le cas contraire.
État: indique l'état de la dernière tentative. Pour les échecs de compilation, fournit un message d'erreur SQL et un lien vers le code LookML du modèle si l'utilisateur dispose des autorisations appropriées pour consulter LookML.
Dépendances: cliquez sur le bouton Show Dependency Graph (Afficher le graphique des dépendances) pour afficher un diagramme des relations de toutes les tables dérivées dont cette 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é créée avec succès.
- Un nœud jaune représente une PDT en cours de création ou d'incrémentation.
- Un nœud rouge représente une table 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 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 réussie.
- Durée de la dernière compilation: durée de la dernière compilation de PDT (en secondes). Elle affiche – si la table n'a pas encore été créé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é créée).
- Build Reason (Motif de la compilation) : raison pour laquelle une PDT a été générée (création d'une compilation initiale ; déclenchement du groupe de données 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é).
- Clé d'incrémentation: paramètre increment_key pour les PDT qui utilisent des compilations incrémentielles.
- Décalage d'incrémentation: paramètre increment_offset pour les PDT qui utilisent des compilations incrémentielles.
- Incrémenter les lignes ajoutées/supprimées: le nombre de lignes qui ont été ajoutées ou supprimées de la table lors de la dernière incrémentation de la table (affiche – si aucune ligne n'a été ajoutée ou supprimée lorsque la stratégie de persistance de la table a déclenché un incrément pour la dernière fois).
- Dernière tentative SQL: code 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.
- Persistance pour: pour les PDT de type Persistance, il s'agit de la 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éclenchement de groupes de données, donne le nom du groupe de données.
- Bloc de code SQL: pour les tables PDT de groupes de données et de 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 code SQL du paramètre sql_trigger_value.
- Trigger Value (Valeur du déclencheur) : pour les PDT de type Trigger, la valeur ayant déclenché la compilation de la PDT (affiche – pour les PDT correctement compilées et persistantes avec un datagroup_trigger. Pour voir la valeur de déclencheur la plus récente pour un groupe de données, consultez la page Groupes de données du panneau Administration).
- Dernière vérification: pour les PDT de type Déclencheur, date à laquelle la valeur du déclencheur a été vérifiée pour la dernière fois.
- Expiration: date d'expiration de la PDT, le cas échéant (non applicable aux déclencheurs de groupes de données).

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

Le tableau de bord 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 Activité PDT comprend des vignettes qui affichent les informations suivantes:

Résumé de la PDT qui inclut le nom du modèle LookML et la vue définissant la PDT, le nom de la connexion à la base de données utilisée par la PDT, le nombre total de tentatives de compilation ayant réussi et échoué, et le pourcentage de tentatives de compilation ayant échoué.
Date et heure de la reconstruction complète la plus récente de la PDT.
Si la PDT est une augmentation de PDT, date et heure de la reconstruction incrémentielle la plus récente de la PDT.
Si la PDT est une PDT incrémentielle, il s'agit du nombre de reconstructions incrémentielles qui se sont produites depuis la dernière 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 récents, regroupés par un résumé des types d'actions qui ont provoqué les événements.
Une liste de toutes les régénérations de PDT qui se sont produites pendant la période du tableau de bord, y compris la date de fin de chaque recompilation, le nombre de secondes nécessaires pour effectuer chaque recompilation, si les recompilations étaient des compilations incrémentielles, le déclencheur qui a provoqué chaque recompilation et le nombre de générations de PDT.
Une liste de toutes les tentatives de recompilation ayant échoué, y compris la date et l'heure de début de la recompilation ayant échoué, le type d'erreur à l'origine de l'échec, le message d'erreur et le nombre d'échecs de création.
Une liste de tous les événements du déclencheur de recompilation de PDT, y compris l'ID, la date, le type et les données incluses dans l'événement déclencheur.
Une liste de tous les événements de recompilation PDT, y compris l'ID, la date, le type et les données incluses dans l'événement de recompilation.
Nombre de requêtes ayant directement interrogé un champ, regroupées en fonction de la source de la requête et du temps d'exécution moyen pour chaque source de requête.
Nombre total de requêtes exécutées sur la 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'exécution de l'exploration incluant le champ et le nombre de fois que le champ a été inclus dans une requête.

Modèle du 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 PDT. Il s'agit d'une table figurant dans le schéma temporaire d'une connexion à une base de données, qui suit l'activité de déclenchement et 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 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 de 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 avec n'importe quelle autre exploration Looker. Lorsque vous y accédez depuis la page Connexions, l'exploration du journal des événements PDT est filtrée pour l'ensemble de la connexion. Lorsque vous y accédez depuis la page Tables dérivées persistantes, l'exploration du journal des événements PDT est filtrée pour une table PDT spécifique.

Il s'agit d'un bref guide des champs disponibles dans l'exploration du journal d'événements PDT:

Champ	Description
Action	Décrit l'action qui s'est produite. Cela peut inclure l'activité de régénération, de suppression, de création et de récupération. Consultez la page de documentation Comprendre les actions du journal des PDT pour découvrir comment afficher et comprendre les actions du journal des PDT et les données d'action 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 Comprendre les actions du journal des PDT pour découvrir comment afficher et comprendre les actions du journal des PDT et les données d'action correspondantes.
Connexion	Nom de la connexion sur laquelle la table dérivée existe.
Hachage	Chaque table dérivée contient un hachage du SQL écrit pour la créer.
ID	ID unique de l'instance Looker qui a généré la PDT. Dans de nombreux cas, 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, par exemple, vous pouvez voir plusieurs ID.
Nom du modèle	Nom du modèle par lequel la table a été générée.
Date d'occurrence	Date et heure auxquelles l'événement s'est produit.
Occur Utc Display Date (Date d'affichage Utc)	Date et heure auxquelles l'événement s'est produit (format UTC).
Séquence	Numéro d'étape dans la compilation de 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 de la PDT, y compris le préfixe du type de table, un hachage et le nom de la vue.
Mare	ID de la transaction.
Nom de la vue	Nom de la vue de la table dérivée.