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

La page d'administration Tables dérivées persistantes de Looker affiche l'état des tables persistantes de l'instance Looker (qui incluent à la fois les tables dérivées persistantes et les tables agrégées).

La page d'administration Tables dérivées persistantes affiche plusieurs fonctionnalités d'administration qui peuvent vous aider à suivre et à résoudre les problèmes liés au comportement des tables persistantes. Pour savoir comment résoudre les problèmes liés aux tables persistantes, consultez la page de documentation Tables dérivées dans Looker.

Les administrateurs Looker et les utilisateurs disposant de l'autorisation see_pdts peuvent accéder à la page Tables dérivées persistantes.

Pour ouvrir la page Tables dérivées persistantes, procédez comme suit :

  1. Cliquez sur l'icône Menu principal Looker , puis sélectionnez Admin si le menu Admin n'est pas déjà affiché. (Si vous vous trouvez dans la section Explorer ou Développer du menu principal de Looker, vous devrez peut-être cliquer sur la flèche "Retour" pour afficher le menu Admin.)
  2. Dans le menu Admin, sélectionnez Tables dérivées persistantes.

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

  • La table persistée 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 persistées.
  • La table persistée fait partie d'un modèle correctement configuré.
  • La table persistante 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 interne des événements PDT, décrit dans la section Exploration du 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 tables persistantes et charge les tables persistantes pour toutes les connexions pour lesquelles vous disposez d'un accès aux données dans l'instance Looker. Vous pouvez modifier les données affichées dans le tableau de plusieurs façons :

  1. Pour afficher les tables persistantes d'une connexion spécifique uniquement, cliquez sur la flèche à côté de Toutes les connexions, puis sélectionnez le nom de la connexion spécifique. Le sélecteur n'affiche que les connexions activées pour les PDT et pour lesquelles vous avez accès aux données.
  2. Saisissez des mots clés dans le champ de recherche pour limiter la liste des tables persistantes à celles dont le nom inclut le mot clé. Le tableau affiche les tables persistantes dont le nom correspond au terme de recherche en gras. Cliquez sur la 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 Fermer/Ouvrir pour afficher ou masquer la section En un coup d'œil.
  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 affichés sur une même page. Si le tableau s'étend sur plusieurs pages, 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 choisir les tables persistantes à 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 tables persistantes qui présentent une erreur de compilation, ou filtrer par Modèle pour limiter les tables persistantes affichées à un modèle spécifique.

Pour filtrer la page Tables dérivées persistantes, procédez comme suit :

  1. Cliquez sur l'icône Filtres .
  2. Sélectionnez une option de filtre dans le premier sélecteur de filtre du menu "Filtre". Les options suivantes sont disponibles :
    • Non déclenchées au cours des : filtre la page Tables dérivées persistantes en fonction des tables 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 : filtre la page Tables dérivées persistantes par tables persistantes 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 afficher les tables persistantes incluses dans un modèle spécifié.
    • Règle de persistance : filtre la page Tables dérivées persistantes par type de persistance.
    • État de la dernière tentative : filtre la page Tables dérivées persistantes en fonction de l'état d'une table persistante spécifiée.
    • Publiée en tant que vue stable : valeur booléenne qui filtre la page Tables dérivées persistantes pour les tables persistantes et affiche Oui pour les tables persistantes qui ont été publiées en tant que vue stable, et Non pour les tables persistantes qui n'ont pas été publiées en tant que vue stable, en fonction de la valeur de leur paramètre publish_as_db_view.
    • Durée de la dernière compilation supérieure à : filtre la page Tables dérivées persistantes par tables persistantes dont la compilation a duré plus longtemps qu'un nombre de secondes spécifié.
    • Projet : filtre la page Tables dérivées persistantes par tables persistantes 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 Non déclenché au cours des ou Déclenché au cours des, 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 un filtre supplémentaire, cliquez sur l'option Effacer correspondant au filtre à 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 cette page. Cliquez sur Tout effacer pour supprimer tous les filtres.

Comprendre la page "Tables dérivées persistantes"

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, le tableau Tables dérivées persistantes comporte deux onglets :

  • L'onglet Production est sélectionné par défaut et affiche les tables persistantes de production. Il s'agit des tables persistantes qui ont été déployées en production sur votre instance. Elles fournissent les données pour les requêtes Explore 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 présentera que des informations sur les tables persistantes de production.)

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

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

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

Section "En bref"

La section En un coup d'œil affiche un récapitulatif visuel de l'état des tables persistées qui sont affichées dans le tableau des tables persistées. 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 En un coup d'œil limitera les résultats pour qu'ils correspondent à ce qui est affiché dans le tableau persistant.

Vous pouvez afficher ou masquer la section En un coup d'œil en cliquant sur l'icône Fermer/Ouvrir 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. 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 de la PDT

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

Le cas échéant, la colonne Nom du tableau persistant dérivé affiche ces informations supplémentaires sous le nom du tableau persistant :

  • Ancienne compilation indique que la ligne affiche des informations sur une ancienne compilation de table persistante. Pour en savoir plus sur ce message, consultez la boîte de dialogue Détails du PDT dans le menu Options.
  • Incrémentiel indique que la table persistante est une PDT incrémentielle.
  • Vue matérialisée indique que la table persistante 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 affiche l'état de la dernière tentative de création de chaque table persistée listée :

  • Régénération indique que la table persistante peut être interrogée et qu'une table mise à jour est en cours de création. Horodatage indiquant le début de la création de la table persistée.
  • Success (Réussite) indique qu'une table persistante a été créée.
  • En cours de création indique qu'une table persistante est en cours de création et qu'elle ne peut pas être interrogée tant que la création n'est pas terminée.
  • Non créée indique qu'une table persistante n'est pas créée.
  • Erreur de compilation : une erreur s'est produite lors de la compilation. Vous pouvez cliquer sur Erreur de compilation pour afficher la source de l'erreur et accéder au code LookML de la table persistante si vous disposez des autorisations appropriées pour afficher le code LookML. Consultez la section Menu "Options" de cette page pour en savoir plus sur la résolution des problèmes liés aux tables persistantes à 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 création de table persistante.

Dernière compilation réussie

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

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 table persistante et la durée moyenne en secondes de la compilation de la table persistante.

Règle de persistance

La colonne Règle de persistance affiche le type de persistance appliqué à une table persistante, tel qu'il est spécifié dans la définition LookML de la table persistante. Elle indique également la dernière fois qu'une table persistée créée avec succès a été vérifiée (pour les tables persistées de type "trigger") ou la date d'expiration d'une table persistée créée avec succès (pour les tables persistées de type "persist"). Deux types de persistance sont affichés dans la colonne Règle de persistance :

  • L'option Persister pendant : (durée) s'affiche pour les tables persistantes qui le sont avec le paramètre persist_for.
  • Déclencheur : (nom du groupe de données) s'affiche pour les tables persistantes qui sont 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.
  • Déclencheur : SQL s'affiche pour les tables persistantes qui sont rendues persistantes avec un paramètre sql_trigger_value. Vous pouvez cliquer sur le lien pour afficher le relevé sql_trigger_value.
  • Vue matérialisée s'affiche pour les vues matérialisées, qui exploitent la fonctionnalité de votre base de données pour rendre persistantes les tables dérivées dans votre base de données.

Projet

La colonne Projet indique le nom du projet LookML dans lequel la table persistante est définie.

Connexion

Si l'option Toutes les connexions est sélectionnée dans le sélecteur de connexion, la colonne Connexion s'affiche et indique le nom de la connexion sur laquelle la table persistante est activée.

Modèle

La colonne Modèle affiche le nom du fichier de modèle associé à la table persistante. Pour une PDT, il s'agit généralement du fichier de modèle qui inclut le fichier de vue dans lequel la PDT est définie. Pour un tableau agrégé, il s'agit généralement du fichier de modèle dans lequel le tableau agrégé est défini.

Menu 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 durée de la dernière 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 persistante est définie si vous disposez des autorisations appropriées pour afficher le code 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é de la table persistante sélectionnée au cours des quatre dernières semaines.
  • Détails du tableau persistant dérivé : ouvre une boîte de dialogue contenant plus d'informations et de statistiques pour un tableau persistant spécifique. Pour en savoir plus, consultez la section Modal de détails sur les PDT sur cette page.

Pour obtenir des conseils de dépannage, consultez la section Surveillance et correction de 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 tableau de données persistantes dans le menu à trois points Options  du tableau de données persistantes pour afficher la fenêtre modale des détails du PDT.

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

  • Nom de la table : hachage de la dernière table persistante créée avec succès.
  • Modèle : nom du fichier de modèle dans lequel le fichier de vue de la table persistante est inclus.
  • Nom stable : nom de la vue de base de données stable de la table persistante dans votre base de données, si la table persistante a été publiée en tant que vue stable. Vous pouvez publier une table persistante en tant que vue stable dans votre base de données en ajoutant l'instruction publish_as_db_view: yes à la table PDT ou agrégé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 table persistante est activée.
  • Ancienne compilation : valeur booléenne qui affiche Oui si une compilation est une ancienne compilation de table persistante 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 Table actuelle.
  • PDT incrémentielle : valeur booléenne qui affiche Oui si une table persistante est une PDT incrémentielle ou Non si ce n'est pas le cas.
  • État : indique l'état de la dernière tentative. En cas d'échec de la compilation, un message d'erreur SQL et un lien vers le fichier LookML du modèle sont fournis si l'utilisateur dispose des autorisations appropriées pour afficher le fichier LookML.
  • Dépendances : cliquez sur le bouton Afficher le graphique des dépendances pour afficher un diagramme des relations de toutes les tables dérivées dont cette table 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 table persistante qui a été compilée avec succès.
    • Un nœud jaune représente une table persistée en cours de compilation ou d'incrémentation.
    • Un nœud rouge représente une table persistante qui n'a pas pu être créée.
    • Un nœud gris représente une table persistante qui n'a pas encore été créé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 persistée.
    • Durée de la dernière compilation : durée de la dernière compilation de la table persistante (en secondes ; s'affiche si la table n'a pas encore été compilée).
    • Durée moyenne de compilation : durée moyenne (en secondes) nécessaire pour compiler la table persistante ( s'affiche si la table n'a pas encore été compilée).
    • Raison de la création : raison pour laquelle la table persistée a été créée (inception pour une création initiale, datagroup triggered si la table persistée est persistée avec un groupe de données, trigger value change si la valeur de déclencheur SQL de la table persistée a changé).
    • Clé d'incrément : paramètre increment_key pour les tables persistantes qui utilisent des builds incrémentaux.
    • Décalage d'incrément : paramètre increment_offset pour les tables persistantes qui utilisent des compilations incrémentales.
    • Lignes ajoutées/supprimées de la compilation incrémentale : nombre de lignes ajoutées ou supprimées du tableau lors de la dernière incrémentation ( s'affiche si aucune ligne n'a été ajoutée ni supprimée lors de la dernière incrémentation de la stratégie de persistance du tableau).
    • Dernière tentative SQL : 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 sur cette page.
    • Persister pendant : valeur de la durée de persistance pour les tables persistantes de type Persister. Non applicable aux tables persistantes de type Trigger.
    • Datagroup : pour les tables persistantes déclenchées par un groupe de données, indique le nom du groupe de données.
    • Bloc de code SQL : pour les tables persistantes 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 pour le paramètre sql_trigger_value.
    • Valeur du déclencheur : pour les tables persistantes de type Déclencheur, il s'agit de la valeur qui a déclenché la création de la table persistante ( s'affiche pour les tables persistantes créées avec succès et persistantes avec datagroup_trigger). Pour afficher la valeur du déclencheur le plus récent pour un groupe de données, consultez la page Groupes de données du panneau Admin.
    • Dernière vérification : pour les tables persistantes de type Déclencheur, date de la dernière vérification de la valeur du déclencheur.
    • Expires (Expiration) : date d'expiration de la table persistante, le cas échéant (non applicable aux déclencheurs de groupe de données).

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

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

Par défaut, le tableau de bord Activité PDT affiche 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 Activité PDT inclut des tuiles qui affichent les informations suivantes :

  • Résumé de la table persistante, y compris le nom du modèle et de la vue LookML qui définissent la table persistante, le nom de la connexion à la base de données utilisée par la table persistante, le nombre total de tentatives de création réussies et échouées de la table persistante, ainsi que le pourcentage de tentatives de création totales ayant échoué.
  • Date et heure de la dernière reconstruction complète de la table persistante.
  • Si la table persistante est une PDT incrémentielle, il s'agit de la date et de l'heure de la dernière régénération incrémentielle de la PDT.
  • Si la table persistante est une PDT incrémentielle, il s'agit du nombre de régénérations incrémentielles qui ont eu lieu depuis la dernière régénération complète.
  • Temps moyen nécessaire pour reconstruire la table persistante.
  • Visualisation qui affiche tous les événements de création récents, regroupés par un récapitulatif des types d'actions qui ont déclenché les événements.
  • Liste de toutes les régénérations de tables persistantes qui ont eu lieu au cours de la période du tableau de bord, y compris la date à laquelle chaque régénération a été effectuée, le nombre de secondes nécessaires pour la réaliser, si les régénérations étaient des générations incrémentielles, le déclencheur de chaque régénération et le nombre de générations de tables persistantes.
  • Liste de toutes les tentatives de reconstruction ayant échoué, y compris la date et l'heure de début de la reconstruction, 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éclenchement de la reconstruction de tables persistantes, y compris le numéro d'ID de l'événement, la date de l'événement, le type d'événement et les données incluses dans l'événement de déclenchement.
  • Liste de tous les événements de reconstruction de tables persistantes, y compris le numéro d'ID de l'événement, la date de l'événement, le type d'événement et les données incluses dans l'événement de reconstruction.
  • Nombre de requêtes ayant directement interrogé un champ, regroupées par source de requête et durée d'exécution moyenne pour chaque source de requête.
  • Nombre total de requêtes exécutées sur la table persistante.
  • Liste de tous les champs de table persistants 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 comprenait le champ et le nombre de fois où le champ a été inclus dans une requête.

Exploration du journal des événements PDT

Looker inclut un modèle prédéfini nommé system_activity qui permet d'explorer le journal des événements PDT. Il s'agit d'une table du schéma temporaire d'une connexion à une base de données qui suit l'activité de déclenchement et de création des tables persistantes.

Vous pouvez accéder au modèle à l'aide des 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 Admin de Looker.

Pour accéder à l'exploration Journal des événements PDT depuis 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 y accédez depuis la page Connexions, l'exploration 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'explorateur Journal des événements PDT est filtré pour une table persistante spécifique.

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

ChampDescription
ActionDécrit l'action qui s'est produite. Il peut s'agir d'une activité de régénération, de suppression, de création et de collecte.

Pour en savoir plus sur l'affichage et la compréhension des actions de journal PDT et de leurs données d'action correspondantes, consultez la page de documentation Comprendre les actions de journal PDT.
Données d'actionFournit 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 reconstruction et le texte d'un message d'erreur.

Pour en savoir plus sur l'affichage et la compréhension des actions de journal PDT et de leurs données d'action correspondantes, consultez la page de documentation Comprendre les actions de journal PDT.
ConnexionNom de la connexion sur laquelle se trouve la table dérivée.
HashChaque table dérivée contient un hachage du code SQL qui a été écrit pour la créer.
IDID unique de l'instance Looker qui a généré la table persistante. Dans de nombreux cas, une seule instance Looker pointe vers une base de données. Vous ne verrez donc qu'un seul ID. Toutefois, si vous disposez d'une instance intermédiaire ou d'un autre type d'instance, plusieurs ID peuvent s'afficher.
Nom du modèleNom du modèle à l'aide duquel le tableau a été généré.
Date de l'événementDate et heure auxquelles l'événement s'est produit.
Occur Utc Display DateDate et heure de l'événement en UTC.
SéquenceNuméro d'étape dans la création de table persistante.
Hachage courtVersion tronquée du hachage du code SQL écrit pour créer la table dérivée.
Nom de la tableNom complet de la table persistante, y compris le préfixe du type de table, un hachage et le nom de la vue.
TidID de la transaction.
Nom de la vueNom de la vue pour la table dérivée.