Cette page a été traduite par l'API Cloud Translation.

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

La page d'administration des tables dérivées persistantes de Looker indique 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. Consultez la page de documentation Tables dérivées dans Looker pour en savoir plus sur le dépannage des tables persistantes.

Les administrateurs et les utilisateurs de Looker 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:

Cliquez sur l'icône du menu principal de Looker et sélectionnez Admin si le menu Admin ne s'affiche pas déjà. (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 de retour pour afficher le menu Administration.)
Dans le menu Administration, sélectionnez Tables dérivées persistantes.

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

La table persistante 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 Développement pour afficher la version de développement des tables persistantes.
La table persistante fait partie d'un modèle correctement configuré.
La table persistante 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 de tables PDT interne, décrit dans la section Explorer le 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 des tables persistantes pour toutes les connexions pour lesquelles vous disposez d'un accès aux données sur l'instance Looker. Il existe plusieurs façons de modifier les données affichées dans le tableau:

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 tables PDT et pour lesquelles vous avez accès aux données.
Saisissez des mots clés dans le champ de recherche pour limiter la liste de tables persistantes aux tables persistantes dont les noms incluent le mot clé. Le tableau affiche les tables 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.
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 des 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 comporte plusieurs pages, vous pouvez cliquer sur les flèches situées en bas au centre de la page pour accéder à la page précédente ou suivante.

Filtrage

Vous pouvez utiliser l'icône Filtres située à 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 rencontrent une erreur de compilation, ou filtrer par Modèle pour limiter les tables persistantes affichées pour un modèle spécifique.

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

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 :
- Not Triggered in the Last (Non déclenché dans la dernière période) : filtre la page Tables dérivées persistantes en fonction des tables persistantes qui n'ont pas été déclenchées dans un nombre spécifié d'heures et de minutes.
- Déclenchée dans les derniers: filtre la page Tables dérivées persistantes en fonction des tables persistantes qui ont été déclenchées dans un nombre spécifié d'heures et de minutes.
- Model: filtre la page Tables dérivées persistantes pour n'afficher que 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 d'un état de table persistant.
- Publié en tant que vue stable: une 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, comme déterminé par leur valeur de paramètre publish_as_db_view.
- Last Build Duration Longer Than (Durée de la dernière compilation supérieure à) : filtre la page Tables dérivées persistantes en fonction des tables persistantes dont les compilations ont pris plus d'un nombre de secondes spécifié.
- Project (Projet) : filtre la page Tables dérivées persistantes en fonction des tables 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 des derniers ou Déclenchement dans les 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 à), 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 les filtres sélectionnés et recommencer à tout moment, cliquez sur Tout effacer.
- Pour supprimer des filtres supplémentaires, cliquez sur l'option Effacer correspondant au 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 "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, la table Tables dérivées persistantes comportera deux onglets:

L'onglet Production est sélectionné par défaut et affiche les tables de production persistantes. Il s'agit des tables persistantes qui ont été déployées en production sur votre instance. Ces tables persistantes fournissent les données des requêtes d'exploration de vos utilisateurs. (Si vous êtes en mode Production ou si vous ne disposez pas des autorisations develop, la page Tables dérivées persistantes n'affichera aucun onglet, et la page affichera uniquement des informations pour 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 la table persistante est interrogée. Ces modifications incitent Looker à créer la table persistante de développement, mais Looker ne la construit en réalité que si la table persistante est interrogée après les modifications. L'onglet Développement peut vous aider à déterminer quelles tables persistantes de développement ont été créées par Looker, et si elles ont été créées.

Consultez la page de documentation Tables dérivées dans Looker pour savoir ce qui pousse Looker à créer des tables persistantes de développement et pendant combien de temps ces tables sont conservées dans votre base de données.

Section "Aperçu"

La section Aperçu affiche un résumé visuel de l'état des tables persistantes affichées dans la table persistante. Si vous avez défini des filtres pour le tableau ou si vous avez utilisé la flèche située à côté de Toutes les connexions en haut de la page pour limiter le tableau à une connexion spécifique, la section Aperçu restreindra les résultats pour qu'ils correspondent à ce qui est affiché dans le tableau persistant.

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 figurant 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 PDT Name (Nom du PDT) affiche le nom de la table persistante tel que défini dans le paramètre view du fichier de vue LookML de la table persistante.

La colonne PDT Name (Nom du PDT) affiche les informations supplémentaires suivantes sous le nom de la table persistante, le cas échéant:

Old Build (Ancien build) 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 PDT Details (Détails de l'heure d'importation) du 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 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 table persistante répertoriée:

Une nouvelle génération indique que la table persistante peut être interrogée et qu'une table mise à jour est en cours de création. Un code temporel indique quand la création de la table persistante a commencé.
Réussite indique qu'une table persistante a bien été créée.
Building indique qu'une table persistante est en cours de création et ne peut pas être interrogée tant que la compilation n'est pas terminée.
Not Build indique qu'aucune table persistante n'est créée.
Erreur de compilation indique qu'une erreur s'est produite lors d'une compilation. Vous pouvez cliquer sur Erreur de compilation pour voir la source de l'erreur et accéder au LookML de la table persistante si vous disposez des autorisations appropriées pour voir LookML. Consultez la section Menu d'options de cette page pour en savoir plus sur le dépannage des 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 la table persistante.

Dernière compilation réussie

La colonne Last Success Build (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 affiche la durée (en secondes) nécessaire à la dernière compilation de cette table persistante et le temps nécessaire pour créer cette table en moyenne, exprimée en secondes.

Règle de persistance

La colonne Règle de persistance affiche le type de persistance appliqué à une table persistante, tel que spécifié dans la définition LookML de la table persistante. Elle indique également la dernière fois qu'une table persistante créée a été vérifiée (pour les tables persistantes de type déclencheur) ou quand une table persistante créée avec succès doit expirer (pour les tables persistantes de type persistant). Deux types de persistance sont affichés dans la colonne Règle de persistance:

Persistance pendant: (durée) s'affiche pour les tables persistantes qui sont persistantes 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 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 la fonctionnalité de votre base de données pour y conserver des tables dérivées.

Projet

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

Connexion

Si Toutes les connexions est sélectionné à partir de la sélection de connexion, la colonne Connexion s'affiche et affiche 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 table PDT, il s'agit généralement du fichier de modèle qui inclut le fichier de vue dans lequel la table PDT est définie. Pour un tableau cumulé, il s'agit généralement du fichier de modèle dans lequel le tableau cumulé est défini.

Menu Options

Le menu Options à trois points est particulièrement utile pour résoudre les problèmes de comportements inattendus. Les options proposées vous permettent de vérifier la date de la dernière compilation des tables, la durée de leur compilation, de comparer la durée de la dernière compilation à la durée de compilation moyenne 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 voir LookML.
Tableau de bord des activités PDT: ouvre le tableau de bord des activités PDT filtré pour afficher l'activité de la table persistante sélectionnée au cours des quatre dernières semaines.
PDT Details (Détails PDT) : ouvre une boîte de dialogue contenant plus d'informations et de statistiques sur une table persistante spécifique. Pour en savoir plus, consultez la section Fenêtre modale de détails du PDT sur cette page.

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

Fenêtre modale des détails de la table PDT

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

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

Table Name (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.
Stable Name (Nom stable) : nom de la vue 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 de votre base de données en ajoutant l'instruction publish_as_db_view: yes à la table PDT ou à la table agrégée, ou en utilisant l'instruction materialized_view: yes pour transformer la table dérivée en vue matérialisée.
Connexion: nom de la connexion sur laquelle la table persistante est activée.
Old Build (Ancienne compilation) : Booléen affichant Yes si une compilation est une ancienne compilation de table persistante ou No 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 sont Table de l'ancienne génération et Standin.
Augmentation de tables PDT: valeur booléenne indiquant Oui si une table persistante est une PDT incrémentielle ou Non dans le cas contraire.
État: indique l'état de la dernière tentative. En cas d'échec de la compilation, fournit un message d'erreur SQL et un lien vers le code LookML du modèle si l'utilisateur dispose des autorisations appropriées pour consulter 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 dépend cette table persistante. Chaque nœud du diagramme correspond à une table dérivée. La couleur de chaque nœud correspond à l'état de cette table dérivée, comme suit :
- Un nœud vert représente une table persistante qui a été créée avec succès.
- Un nœud jaune représente une table persistante en cours de compilation ou d'incrémentation.
- Un nœud rouge représente une table persistante dont la compilation a échoué.
- Un nœud gris représente une table persistante qui n'est pas encore créée.
- Un nœud blanc représente une table dérivée temporaire que Looker ne génère pas.
Dernière compilation :
- Dernière compilation réussie: date et heure de la dernière compilation réussie de la table persistante.
- Durée de la dernière compilation: durée de la compilation la plus récente de la table persistante (en secondes ; affiche le signe – si la table n'a pas encore été créée).
- Durée moyenne de compilation: temps moyen nécessaire pour créer la table persistante (en secondes ; affiche le signe – si la table n'a pas encore été créée).
- Raison de la compilation: raison pour laquelle une table persistante a été créée (inception pour une compilation initiale ; groupe de données déclenché si la table persistante est conservée avec un groupe de données ; modification de la valeur du déclencheur si la valeur du déclencheur SQL de la table persistante a changé).
- Clé d'incrémentation: paramètre increment_key pour les tables persistantes qui utilisent des compilations incrémentielles.
- Increment Offset (Décalage d'incrémentation) : paramètre increment_offset des tables persistantes qui utilisent des compilations incrémentielles.
- Comptage d'incrémentation de lignes ajoutées/supprimées: nombre de lignes ajoutées ou supprimées 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 tables persistantes de type Persistant, il s'agit de la valeur de durée de persistance. Non applicable aux tables persistantes de type Déclencheur.
- Groupe de données: pour les tables persistantes associées au déclencheur de 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 correspondant au 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.
- Valeur de déclenchement: pour les tables persistantes de type Déclencheur, la valeur qui a déclenché la création de la table persistante (affiche – pour les tables persistantes créées avec succès qui sont persistantes avec un datagroup_trigger ; pour voir la valeur de déclenchement 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 les tables persistantes de type Déclencheur, date à laquelle la valeur du déclencheur a été vérifiée pour la dernière fois.
- Expiration: date à laquelle la table persistante expire, le cas échéant (non applicable aux déclencheurs de groupes de données).

Tableau de bord des activités des tables dérivées persistantes

Le tableau de bord Activité PDT affiche des informations sur la table persistante, ses recompilations 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 en haut du tableau de bord. Le tableau de bord Activité PDT comprend des vignettes qui affichent les informations suivantes:

Résumé de la table persistante comprenant le nom du modèle et de la vue LookML définissant 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 compilation ayant abouti et échoué de la table persistante, ainsi que le pourcentage du nombre total de tentatives de compilation ayant échoué.
Date et heure de la dernière recompilation complète de la table persistante.
Si la table persistante est une augmentation de tables PDT, date et heure de la dernière régénération incrémentielle de la table PDT.
Si la table persistante est une augmentation de tables PDT, il s'agit du nombre de régénérations incrémentielles survenues depuis la dernière recompilation complète.
Temps moyen nécessaire pour recréer la table persistante.
Visualisation qui affiche tous les événements de création qui se sont produits récemment, regroupés en fonction d'un résumé des types d'actions qui sont à l'origine de ces événements.
Liste de toutes les recompilations de tables persistantes qui ont eu lieu pendant la période du tableau de bord, y compris la date de fin de chaque recompilation, le nombre de secondes nécessaires pour terminer chaque recompilation, si les recompilations étaient des compilations incrémentielles, le déclencheur à l'origine de chaque recompilation et le nombre de compilations de tables persistantes.
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 déclencheurs de recompilation de la table persistante, y compris le numéro d'ID, la date, le type d'événement et les données incluses dans l'événement déclencheur.
Liste de tous les événements de recompilation de la table persistante, y compris le numéro d'ID, la date, le type d'événement et les données incluses dans l'événement de recompilation.
Nombre de requêtes ayant directement interrogé un champ, regroupés par source de requête et par 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 persistante interrogés, y compris la vue LookML et le modèle dans lesquels le champ est défini, le nom du champ, le nom de l'exécution d'exploration qui inclut le champ et le nombre de fois où le champ a été inclus dans une requête.

Explorer le journal des événements des tables dérivées persistantes

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

Vous pouvez accéder au modèle avec les liens Événements de build 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 du journal des événements PDT à partir de la page Connexions, sélectionnez l'option Afficher le journal des événements PDT dans le menu déroulant de l'icône en forme de roue dentée de 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 du journal des événements PDT est filtrée pour l'ensemble de la connexion. Lorsqu'on y accède depuis la page Tables dérivées persistantes, l'exploration du journal des événements PDT est filtrée sur une table persistante spécifique.

Voici un guide rapide des champs disponibles dans l'exploration du journal des événements PDT:

Champ	Description
Action	Décrit l'action qui s'est produite. Cela peut inclure une activité de régénération, de dépôt, de création et de récupération. Pour en savoir plus sur l'affichage et la compréhension des actions de journaux des tables PDT et des données d'action correspondantes, consultez la page de documentation Comprendre les actions de journaux des tables PDT.
Données d'action	Fournit des détails plus spécifiques sur une action, y compris le déclencheur en cours d'utilisation, sa valeur, le délai d'expiration d'une table persistante, la cause d'une recompilation et le texte d'un message d'erreur. Pour en savoir plus sur l'affichage et la compréhension des actions de journaux des tables PDT et des données d'action correspondantes, consultez la page de documentation Comprendre les actions de journaux des tables PDT.
Connexion	Nom de la connexion sur laquelle la table dérivée existe.
Hachage	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é la table persistante. 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. Cependant, si vous disposez d'une instance de préproduction ou d'un objet de cette nature, plusieurs ID peuvent s'afficher.
Nom du modèle	Nom du modèle à l'aide duquel la table a été générée.
Date de l'événement	La date et l'heure auxquelles l'événement s'est produit.
Date d'affichage utc de l'événement	Date et heure de l'événement (indiquées en temps UTC).
Séquence	Numéro d'étape dans la compilation de la table persistante.
Hachage court	Version tronquée du hachage du code SQL qui a été écrit pour créer la table dérivée.
Nom de la table	Nom complet de la table persistante, y compris le préfixe de type table, un hachage et le nom de la vue.
Tid	ID de la transaction.
Nom de la vue	Nom de la vue de la table dérivée.