Catégories :

Information Schema , Fonctions de table

STAGE_DIRECTORY_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 de répertoire, 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

STAGE_DIRECTORY_FILE_REGISTRATION_HISTORY (
      STAGE_NAME => '<string>'
      [, START_TIME => <constant_expr> ] )
Copy

Arguments

Obligatoire :

STAGE_NAME => 'string'

Une chaîne spécifiant le nom d’une zone de préparation qui a une table de répertoire.

Facultatif :

START_TIME => constant_expr

Horodatage (au format TIMESTAMP_LTZ), au cours des 14 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 14 derniers jours.

  • Si l’heure de début est en dehors des 14 derniers jours, la fonction renvoie des résultats vides.

Notes sur l’utilisation

  • Renvoie les résultats pour le propriétaire de la zone de préparation (c’est-à-dire le rôle avec le privilège OWNERSHIP sur la zone de préparation) 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 zone de préparation avec une table de répertoire et tout privilège sur la zone de préparation.

  • 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 de répertoire 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 table Information Schema, 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 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 de répertoire.

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 zone de préparation mystage :

SELECT *
  FROM TABLE(information_schema.stage_directory_file_registration_history(
  STAGE_NAME=>'MYSTAGE'));
Copy

Récupérer les événements d’enregistrement pour la table de répertoire sur la zone de préparation mydb.public.mystage qui ont commencé dans la dernière heure :

SELECT *
  FROM TABLE(information_schema.stage_directory_file_registration_history(
    START_TIME=>DATEADD('hour',-1,current_timestamp()),
    STAGE_NAME=>'mydb.public.mystage'));
Copy