Catégories :: Information Schema , Fonctions de table

EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY¶

Cette fonction de table peut être utilisée pour rechercher des informations sur l’historique des métadonnées d’une table externe, notamment :

Les fichiers ajoutés ou supprimés automatiquement dans le cadre d’une actualisation de métadonnées.
Toute erreur trouvée lors de l’actualisation des métadonnées.

Syntaxe¶

EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY (
      TABLE_NAME => '<string>'
      [, START_TIME => <constant_expr> ] )

Copy

Arguments¶

Obligatoire :

TABLE_NAME => 'string': Une chaîne spécifiant un nom de table externe.

Facultatif :

START_TIME => constant_expr

Horodatage (au format TIMESTAMP_LTZ), au cours des 30 derniers jours, marquant le début de la période de récupération des événements de mise à jour des métadonnées.

Note

Si aucune heure de début n’est spécifiée, la fonction renvoie tous les événements de mise à jour au cours des 30 derniers jours.
Si l’heure de début est en dehors des 30 derniers jours, la fonction renvoie des résultats au cours des 30 derniers jours.
Si l’heure de début n’est pas un horodatage, elle est ignorée.

Notes sur l’utilisation¶

Renvoie les résultats pour le propriétaire de la table externe (c’est-à-dire le rôle avec le privilège OWNERSHIP sur la table externe) ou un rôle supérieur, ou un rôle qui a le privilège USAGE sur la base de données et le schéma qui contiennent une table externe et tout privilège sur la table externe.
La fonction de table ne peut pas extraire les métadonnées relatives aux fichiers de données en zone de préparation tant que la table externe n’est pas actualisée (c.-à-d. synchronisée) de sorte à inclure les fichiers de données dans ses métadonnées.
Lors de l’appel d’une fonction de la table de schémas d’informations, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.

Sortie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
JOB_CREATED_TIME	TIMESTAMP_LTZ	Horodatage lors de l’opération
FILE_NAME	TEXT	Nom du fichier source mis en zone de préparation et chemin d’accès relatif au fichier
OPERATION_STATUS	TEXT	Statut : REGISTERED_NEW, REGISTERED_UPDATE, REGISTER_SKIPPED, REGISTER_FAILED, UNREGISTERED, ou UNREGISTER_FAILED
MESSAGE	TEXT	Message accompagnant le statut de l’opération
FILE_SIZE	NUMBER	Taille du fichier (en octets) ajoutée à la table externe
LAST_MODIFIED	TIMESTAMP_LTZ	Horodatage de la dernière mise à jour du fichier dans la zone de préparation

Exemples¶

Récupérer les métadonnées stockées pour tous les fichiers de données référencés par la table externe mytable :

select *
from table(information_schema.external_table_file_registration_history(TABLE_NAME=>'MYTABLE'));

Copy

Récupérer les événements d’enregistrement pour une table externe mydb.public.external_table_name ayant démarré au cours de la dernière heure :

select *
  from table(information_schema.external_table_file_registration_history(
    start_time=>dateadd('hour',-1,current_timestamp()),
    table_name=>'mydb.public.external_table_name'));

Copy

Récupérer les événements d’enregistrement pour la table externe mydb.public.external_table_name à partir de minuit le 25 avril 2022 :

select *
  from table(information_schema.external_table_file_registration_history(
    start_time=>cast('2022-04-25' as timestamp),
    table_name=>'mydb.public.external_table_name'));

Copy