LIST_STAGE

引入或更新: v1.2.32

列出阶段中的文件。该功能允许您根据文件扩展名过滤阶段中的文件，并获取每个文件的详细信息。此函数类似于DDL命令LIST STAGE FILES，但提供了通过SELECT语句检索特定文件信息的灵活性，例如文件名、大小、MD5哈希、最后修改时间戳和创建者，而不是所有文件信息。

语法

LIST_STAGE(
  LOCATION => '{ internalStage | externalStage | userStage }'
  [ PATTERN => '<regex_pattern>']
)

其中:

internalStage

internalStage ::= @<internal_stage_name>[/<path>]

externalStage

externalStage ::= @<external_stage_name>[/<path>]

userStage

userStage ::= @~[/<path>]

PATTERN

参见COPY INTO table。

示例

SELECT * FROM list_stage(location => '@my_stage/', pattern => '.*[.]log');
+----------------+------+------------------------------------+-------------------------------+---------+
|      name      | size |                md5                 |         last_modified         | creator |
+----------------+------+------------------------------------+-------------------------------+---------+
| 2023/meta.log  |  475 | "4208ff530b252236e14b3cd797abdfbd" | 2023-04-19 20:23:24.000 +0000 | NULL    |
| 2023/query.log | 1348 | "1c6654b207472c277fc8c6207c035e18" | 2023-04-19 20:23:24.000 +0000 | NULL    |
+----------------+------+------------------------------------+-------------------------------+---------+

-- 等效于以下语句:
LIST @my_stage PATTERN = '.log';