Catégories :

Information Schema , Fonctions de table

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>' )
Copy

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'));
Copy