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