Catégories :: Information Schema , Fonctions de table

DYNAMIC_TABLE_GRAPH_HISTORY¶

Cette fonction de table renvoie des informations sur toutes les tables dynamiques du compte actuel. Ces informations comprennent les dépendances entre les tables dynamiques et les tables de base. Une utilisation courante consiste à identifier toutes les tables dynamiques qui font partie d’un pipeline.

Dans la sortie de cette fonction, chaque ligne représente une table dynamique. Les colonnes VALID_FROM et VALID_TO précisent l’intervalle de temps au cours duquel la description d’une table dynamique était valable (c’est-à-dire qu’elle décrivait correctement la table dynamique).

Les modifications apportées à une table dynamique, telles que la modification du TARGET_LAG, entraînent la création de nouvelles entrées.

Cette fonction de table ne fournit que des descriptions dont la valeur VALID_TO se situe à moins d’un jour de l’heure actuelle.

Syntaxe¶

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)

Copy

Arguments¶

Tous les arguments sont facultatifs. Si aucun argument n’est fourni, seule la description la plus récente des tables dynamiques existants sera renvoyée.

AS_OF => constant_expr: Heure (au format TIMESTAMP_LTZ) à laquelle retourner l’état du graphique. Vous pouvez spécifier une heure qui correspond à une valeur dans la colonne REFRESH_VERSION dans la sortie de la fonction DYNAMIC_TABLE_REFRESH_HISTORY.
HISTORY_START => constant_expr , . HISTORY_END => constant_expr: Plage de dates/heures de l’historique d’actualisation de la table dynamique. HISTORY_START spécifie la date/heure la plus ancienne, inclusivement, à laquelle les données doivent être renvoyées. HISTORY_END qui doit être spécifié avec HISTORY_START, spécifie la date/heure de fin de renvoi des données.

Sortie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
NAME	TEXT	Nom de la table dynamique.
SCHEMA_NAME	TEXT	Nom du schéma contenant la table dynamique.
DATABASE_NAME	TEXT	Nom de la base de données contenant la table dynamique.
QUALIFIED_NAME	TEXT	Nom complet de la table dynamique tel qu’il apparaît dans le graphique des tables dynamiques. Vous pouvez l’utiliser pour joindre la sortie à la sortie de la fonction DYNAMIC_TABLE_REFRESH_HISTORY.
INPUTS	ARRAY de OBJECTs	Chaque OBJECT représente une table, une vue ou une table dynamique qui sert d’entrée à cette table dynamique, et se compose des éléments suivants : `name` (TEXT) : nom complet. `kind` (TEXT) : type d’entrée (TABLE, VIEW ou DYNAMIC TABLE).
TARGET_LAG_TYPE	TEXT	Une des options : USER_DEFINED - Déterminé par le paramètre TARGET_LAG spécifié pour la table dynamique. DOWNSTREAM - Indique une table dynamique avec DOWNSTREAM TARGET_LAG. Reportez-vous à Présentation de l’actualisation des tables dynamiques pour plus d’informations.
TARGET_LAG_SEC	NUMBER	Le temps de latence cible en secondes de cette table dynamique. Il s’agit de la valeur spécifiée dans le paramètre TARGET_LAG de la table dynamique.
QUERY_TEXT	TEXT	L’instruction SELECT pour cette table dynamique.
VALID_FROM	TIMESTAMP_LTZ	La description de la table dynamique est valable après ce délai.
VALID_TO	TIMESTAMP_LTZ	Si elle est présente, la description de la table dynamique est valable jusqu’à ce moment. Si elle est nulle, la description est toujours exacte.
SCHEDULING_STATE	OBJECT	OBJECT composé de : `state` (TEXT) : état de planification (RUNNING ou SUSPENDED). `reason_code` (TEXT) : raison facultative de la raison si l’état n’est pas RUNNING. `reason_message` (TEXT) : description textuelle de la raison pour laquelle la table dynamique ne fonctionne pas. Ne s’applique que si l’état n’est pas en cours d’exécution. `suspended_on` (TIMESTAMP_LTZ) : horodatage facultatif auquel la table dynamique a été suspendue. `resumed_on` (TIMESTAMP_LTZ) : horodatage facultatif de la dernière reprise si la table dynamique est RUNNING.

Notes sur l’utilisation¶

Lors de l’appel d’une fonction de table Information Schema, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.