Schéma :: ACCOUNT_USAGE

Vue DYNAMIC_TABLE_REFRESH_HISTORY¶

Cette vue Account Usage affiche des informations sur l’historique d’actualisation de la table dynamique.

Voir aussi :: DYNAMIC_TABLE_REFRESH_HISTORY (Information Schema)

Colonnes¶

Nom de la colonne	Type de données	Description
NAME	VARCHAR	Nom de la table dynamique.
SCHEMA_NAME	VARCHAR	Nom du schéma contenant la table dynamique.
DATABASE_NAME	VARCHAR	Nom de la base de données contenant la table dynamique.
ID	NUMBER	Identificateur interne généré par Snowflake pour la table dynamique.
SCHEMA_ID	NUMBER	Identificateur interne généré par Snowflake du schéma contenant la table dynamique.
DATABASE_ID	NUMBER	Identificateur interne généré par Snowflake de la base de données contenant la table dynamique.
STATE	VARCHAR	Statut de l’actualisation de la table dynamique. Il peut s’agir de l’une des valeurs suivantes : . - EXECUTING : actualisation en cours. . - SUCCEEDED: actualisation terminée correctement. . - FAILED : l’actualisation a échoué pendant l’exécution. . - CANCELLED : l’actualisation a été annulée avant l’exécution. . - UPSTREAM_FAILED : l’actualisation n’a pas été effectuée en raison d’un échec d’actualisation en amont.
STATE_CODE	VARCHAR	Code représentant l’état actuel de l’actualisation.
STATE_MESSAGE	VARCHAR	Description de l’état actuel de l’actualisation.
QUERY_ID	VARCHAR	ID de l’instruction SQL qui a produit les résultats pour la table dynamique.
DATA_TIMESTAMP	TIMESTAMP_LTZ	Horodatage transactionnel de l’évaluation de l’actualisation. (Il se peut que cette date soit légèrement antérieure à l’heure réelle de l’actualisation.) Toutes les données, dans les objets de base, qui sont arrivées avant cet horodatage sont actuellement incluses dans la table dynamique.
REFRESH_START_TIME	TIMESTAMP_LTZ	Heure à laquelle la tâche d’actualisation a commencé.
REFRESH_END_TIME	TIMESTAMP_LTZ	Heure à laquelle l’actualisation s’est achevée.
COMPLETION_TARGET	TIMESTAMP_LTZ	Délai dans lequel cette actualisation doit se terminer pour maintenir la latence sous le paramètre TARGET_LAG pour la table dynamique. Cette valeur est égale à la valeur DATA_TIMESTAMP de la dernière actualisation + TARGET_LAG.
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_GRAPH_HISTORY.
LAST_COMPLETED_DEPENDENCY	OBJECT	Contient les propriétés suivantes : . - `qualified_name` : le nom qualifié de la dernière dépendance à devenir disponible. . - `data_timestamp` : la version actualisée de cette dépendance.
STATISTICS	OBJECT	Contient les propriétés suivantes : . - `numInsertedRows` : le nombre de lignes insérées. . - `numDeletedRows` : le nombre de lignes qui ont été supprimées. . - `numCopiedRows` : le nombre de lignes qui ont été copiées sans changement. . - `numAddedPartitions` : le nombre de partitions ajoutées. . - `numRemovedPartitions` : le nombre de partitions supprimées. . Par exemple : si une instruction UPDATE met à jour 1 ligne dans une partition avec 10 lignes. Les métriques ci-dessus montrent alors que 1 ligne a été insérée, 1 a été supprimée et 9 ont été copiées. En outre, 1 partition est supprimée et 1 partition est ajoutée.
REFRESH_ACTION	TEXT	L’une des valeurs : . - NO_DATA - pas de nouvelles données dans les tables de base. Ne s’applique pas à l’actualisation initiale des tables dynamiques nouvellement créées, que les tables de base contiennent ou non des données. . - REINITIALIZE - la table de base a été modifiée ou la table source d’une table dynamique clonée a été actualisée pendant le clonage. . - FULL - Actualisation complète, car la table dynamique contient des éléments de requête qui ne sont pas incrémentables (voir SHOW DYNAMIC TABLE refresh_mode_reason) ou parce que l’actualisation complète était moins chère que l’actualisation incrémentielle. . - INCREMENTAL - actualisation incrémentielle normale.
REFRESH_TRIGGER	TEXT	L’une des valeurs : . - SCHEDULED - actualisation normale de l’arrière-plan pour respecter la latence cible ou la latence cible en aval. . - MANUAL - utilisateur/tâche utilisé(e) ALTER DYNAMIC TABLE <nom> REFRESH . - CREATION - actualisation effectuée lors de la création de l’instruction DDL déclenchée par la création de la table dynamique ou de toute table dynamique consommatrice.
TARGET_LAG	TEXT	Décrit la valeur de latence cible des tables dynamiques au moment de l’actualisation.
GRAPH_HISTORY_VALID_FROM	TIMESTAMP_NTZ	Encode l’horodatage VALID_FROM de la fonction de table DYNAMIC_TABLE_GRAPH_HISTORY au moment de l’actualisation, afin de préciser à quelle version d’une table dynamique correspond une actualisation spécifique. Cette valeur peut également être NULL si la table dynamique correspondante n’a pas été créée.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 3 heures.
Pour interroger cette vue, utilisez un rôle auquel est accordé le </sql-reference/snowflake-db-roles>rôle de base de données SNOWFLAKE.USAGE_VIEWER.

Exemples¶

Rechercher les actualisations de table dynamique ayant échoué au cours de la semaine dernière.

SELECT
    data_timestamp,
    database_name,
    schema_name,
    name,
    state,
    state_message,
    query_id
  FROM snowflake.account_usage.dynamic_table_refresh_history
  WHERE state = 'FAILED' AND data_timestamp >= dateadd(WEEK, -1, current_date())
  ORDER BY data_timestamp DESC
  LIMIT 10;

Copy