- Catégories :
EXTERNAL_TABLE_FILES¶
Cette fonction de table peut être utilisée pour rechercher des informations sur les fichiers de données stockés inclus dans les métadonnées d’une table externe spécifiée.
Syntaxe¶
EXTERNAL_TABLE_FILES(
TABLE_NAME => '<string>' )
Arguments¶
Obligatoire :
TABLE_NAME => 'string'
Une chaîne spécifiant un nom de table externe.
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 |
---|---|---|
FILE_NAME |
TEXT |
Nom du fichier source et chemin d’accès relatif au fichier mis en zone de préparation |
REGISTERED_ON |
TIMESTAMP_LTZ |
Horodatage lorsque les métadonnées du fichier ont été ajoutées à une table externe (c.-à-d. lorsque les métadonnées de la table externe ont été actualisées avec les détails du fichier) |
FILE_SIZE |
NUMBER |
Taille du fichier (en octets) |
LAST_MODIFIED |
TIMESTAMP_LTZ |
Horodatage de la dernière mise à jour du fichier dans la zone de préparation |
ETAG |
HEX |
ETag en-tête pour le fichier |
MD5 |
HEX |
MD5 somme de contrôle pour le fichier |
Exemples¶
Récupérez 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_files(TABLE_NAME=>'MYTABLE'));