- Catégories :
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> ] )
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'));
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'));