EXTERNAL_TABLE_FILES¶
此表函数的用途是，查询指定 外部表 的元数据中包含的暂存数据文件相关信息。
语法¶
EXTERNAL_TABLE_FILES(
TABLE_NAME => '<string>' )
实参¶
必填：
TABLE_NAME => 'string'一个用于指定外部表名的字符串。
使用说明¶
返回外部表所有者（即对外部表具有 OWNERSHIP 权限的角色）或更高级别角色的结果，或者 对包含外部表和外部表的任何权限的数据库和架构具有 USAGE 权限的角色。
在刷新（即同步）外部表以将数据文件包含在其元数据中之前，表函数无法检索有关暂存数据文件的元数据。
当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者 函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。
输出¶
该函数返回以下列：
列名称 |
数据类型 |
描述 |
|---|---|---|
FILE_NAME |
TEXT |
源文件的名称和暂存文件的相对路径 |
REGISTERED_ON |
TIMESTAMP_LTZ |
将文件元数据添加到外部表时的时间戳（即使用文件详细信息刷新外部表元数据时的时间） |
FILE_SIZE |
NUMBER |
文件大小（以字节为单位） |
LAST_MODIFIED |
TIMESTAMP_LTZ |
上次在暂存区中更新文件的时间戳 |
ETAG |
HEX |
文件的 ETag 标头 |
MD5 |
HEX |
文件的 MD5 校验和 |
示例¶
检索为 mytable 外部表引用的所有数据文件存储的元数据：
select * from table(information_schema.external_table_files(TABLE_NAME=>'MYTABLE'));