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