Schéma :: ORGANIZATION_USAGE

Vue COPY_HISTORY¶

Important

Cette vue n’est disponible que dans le compte de l’organisation. Pour plus d’informations, voir Vues premium dans le compte de l’organisation.

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¶

Colonnes au niveau de l’organisation

Nom de la colonne	Type de données	Description
ORGANIZATION_NAME	VARCHAR	Nom de l’organisation.
ACCOUNT_LOCATOR	VARCHAR	Identificateur du compte généré par le système.
ACCOUNT_NAME	VARCHAR	Identificateur défini par l’utilisateur pour le compte.

Colonnes supplémentaires

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 aller jusqu’à 24 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.
Supprimer ou recréer un objet de table efface les métadonnées de l’historique des charges pour la déduplication des charges de données en masse (COPY INTO <table> instructions) dans la table.
Renommer un objet de table met à jour les entrées TABLE_NAME correspondantes dans l’historique des copies.
L’abandon ou la recréation d’un objet de canal ne supprime pas les métadonnées de l’historique des charges pour 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.
Après la réplication de l’historique des copies, la vue COPY_HISTORY Account Usage affiche l’historique uniquement “après la dernière opération de troncature sur la table cible. Cette vue est différente de la vue sans réplication, qui montre un historique complet des copies.

Exemples¶

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

SELECT account_name, file_name, error_count, status, last_load_time
  FROM snowflake.organization_usage.copy-history
  ORDER BY last_load_time desc
  LIMIT 10;

Copy