Schéma :: ACCOUNT_USAGE

Vue COPY_HISTORY¶

Cette vue Utilisation du compte peut être utilisée pour interroger l’historique de chargement de données Snowflake au cours des 365 derniers jours (1 an). La vue affiche l’activité de chargement pour les instructions COPY INTO <table> et le chargement continu de données à l’aide de Snowpipe. La vue évite la limitation de 10 000 lignes de Vue LOAD_HISTORY.

Vous pouvez également consulter les détails du chargement des données dans Snowsight. Voir Contrôler l’activité de chargement des données à l’aide de l’historique des copies.

Colonnes¶

Nom de la colonne	Type de données	Description
FILE_NAME	TEXT	Nom du fichier source et chemin d’accès relatif au fichier.
STAGE_LOCATION	TEXT	Nom de la zone de préparation où se trouve le fichier source.
LAST_LOAD_TIME	TIMESTAMP_LTZ	Date et heure de la fin du chargement du fichier.
ROW_COUNT	NUMBER	Nombre de lignes chargées à partir du fichier source.
ROW_PARSED	NUMBER	Nombre de lignes analysées à partir du fichier source : `NULL` si STATUS est `Load in progress`.
FILE_SIZE	NUMBER	Taille du fichier source chargé.
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_POS	NUMBER	Position du premier caractère d’erreur.
FIRST_ERROR_COLUMN_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.
STATUS	TEXT	Statut : `Loaded`, `Load failed`, `Partially loaded`, ou `Load skipped`.
TABLE_ID	NUMBER	Identifiant interne / généré par le système pour la table cible.
TABLE_NAME	TEXT	Nom de la table cible.TABLE_NAME
TABLE_SCHEMA_ID	NUMBER	Identifiant interne, généré par Snowflake, du schéma de la table.
TABLE_SCHEMA_NAME	TEXT	Nom du schéma dans lequel réside la table cible.
TABLE_CATALOG_ID	NUMBER	Identificateur interne/généré par le système pour la base de données de la table.
TABLE_CATALOG_NAME	TEXT	Nom de la base de données dans laquelle réside la table cible.
PIPE_CATALOG_NAME	TEXT	Nom de la base de données dans laquelle réside le canal.
PIPE_SCHEMA_NAME	TEXT	Nom du schéma dans lequel réside le canal.
PIPE_NAME	TEXT	Nom du canal définissant les paramètres de chargement ; `NULL` pour les chargements d’instruction COPY.
PIPE_RECEIVED_TIME	TIMESTAMP_LTZ	Date et heure de réception de la requête INSERT pour le fichier chargé par le canal ; `NULL` pour les chargements d’instruction COPY.
FIRST_COMMIT_TIME	TIMESTAMP_LTZ	Date et heure auxquelles le premier morceau du fichier est validé. Snowpipe peut charger un fichier en plusieurs morceaux qui sont validés séparément.

Notes sur l’utilisation¶

Dans la plupart des cas, la latence pour la vue peut atteindre 120 minutes (2 heures). La latence de l’historique des copies d’une table donnée peut aller jusqu’à 2 jours si les deux conditions suivantes sont remplies :
- Moins de 32 instructions DML ont été ajoutées à la table donnée depuis sa dernière mise à jour dans COPY_HISTORY.
- Moins de 100 lignes ont été ajoutées à la table donnée depuis sa dernière mise à jour dans COPY_HISTORY.

La vue ne comprend que les commandes COPY INTO qui ont été exécutées jusqu’à la fin, avec ou sans erreurs.
L’abandon ou la recréation d’un objet de table supprime les données historiques pour les chargements de données en masse (instructionsCOPY INTO <table>) dans la table.
L’abandon ou la recréation d’un objet de canal supprime les données historiques pour les chargements de données Snowpipe utilisant le canal.
La vue n’affiche que les objets pour lesquels le rôle actuel de la session s’est vu accorder des privilèges d’accès.

Exemples¶

Récupérez les enregistrements pour les 10 dernières commandes COPY INTO exécutées :

select file_name, error_count, status, last_load_time from snowflake.account_usage.copy_history
  order by last_load_time desc
  limit 10;

Copy