Vue LOAD_HISTORY

Cette vue Information Schema vous permet de récupérer l’historique des données chargées dans les tables en utilisant la commande COPY INTO <table> au cours des 14 jours. La vue affiche une ligne pour chaque fichier chargé.

Note

Cette vue ne renvoie pas l’historique des données chargées à l’aide de Snowpipe. Pour ces informations historiques, interrogez plutôt la fonction de la table COPY_HISTORY.

Colonnes

Nom de la colonne

Type de données

Description

SCHEMA_NAME

TEXT

Schéma de la table cible

FILE_NAME

TEXT

Nom du fichier source

TABLE_NAME

TEXT

Nom de la table cible

LAST_LOAD_TIME

TIMESTAMP_LTZ

Horodatage de l’enregistrement du chargement

STATUS

TEXT

Statut : LOADED, LOAD FAILED, ou PARTIALLY LOADED

ROW_COUNT

NUMBER

Nombre de lignes chargées à partir du fichier source

ROW_PARSED

NUMBER

Nombre de lignes analysées à partir du fichier source

FIRST_ERROR_MESSAGE

TEXT

Première erreur du fichier source

FIRST_ERROR_LINE_NUMBER

NUMBER

Numéro de ligne de la première erreur

FIRST_ERROR_CHARACTER_POSITION

NUMBER

Position du premier caractère de l’erreur

FIRST_ERROR_COL_NAME

TEXT

Nom de colonne de la première erreur

ERROR_COUNT

NUMBER

Nombre de lignes d’erreur dans le fichier source

ERROR_LIMIT

NUMBER

Si le nombre d’erreurs atteint cette limite, annulez l’opération

Notes sur l’utilisation

  • Les données historiques des commandes COPY INTO sont supprimées de la vue lorsqu’une table est détruite.

  • La vue ne comprend que les commandes COPY INTO qui ont été exécutées jusqu’à la fin, avec ou sans erreurs. Aucun enregistrement n’est ajouté si la transaction est annulée, par exemple, ou si l’option de copie ON_ERROR = ABORT_STATEMENT est incluse dans l’instruction COPY INTO <table> et une erreur détectée dans un fichier de données fait avorter l’opération de chargement.

  • Cette vue renvoie une limite supérieure de 10 000 lignes. Pour éviter cette limitation, utilisez la vue LOAD_HISTORY (Account Usage), fonction COPY_HISTORY (Information Schema), ou la vue COPY_HISTORY (Account Usage).

  • Lorsque vous incluez une clause WHERE qui fait référence à la colonne LAST_LOAD_TIME , vous pouvez spécifier n’importe quel jour de la semaine. Par exemple, le 1er avril 2016 était un vendredi ; cependant, le fait de spécifier le dimanche à la place du vendredi n’affecte pas les résultats de la requête :

    WHERE last_load_time > 'Sun, 01 Apr 2016 16:00:00 -0800'
    
    Copy

Exemples

Récupérer l’historique des données chargées dans la table MYDB.PUBLIC.MYTABLE depuis le 1er avril 2016, en supposant que le 1er avril fasse partie des 14 derniers jours :

USE DATABASE mydb;

SELECT table_name, last_load_time
  FROM information_schema.load_history
  WHERE schema_name=current_schema() AND
  table_name='MYTABLE' AND
  last_load_time > 'Fri, 01 Apr 2016 16:00:00 -0800';
Copy

Récupérer les enregistrements des 10 commandes COPY INTO les plus récentes exécutées dans la base de données MYDB :

USE DATABASE mydb;

SELECT table_name, last_load_time
  FROM information_schema.load_history
  ORDER BY last_load_time DESC
  LIMIT 10;
Copy