LIST STAGE FILES

列出 stage 中的文件。

另请参阅：

• LIST_STAGE：此函数用于列出 stage 中的文件，并允许你根据文件扩展名筛选 stage 中的文件，同时获取每个文件的详细信息。
• PRESIGN：TiDB Cloud Lake 建议使用 Presigned URL 方法将文件上传到 stage。
• REMOVE STAGE FILES：从 stage 中删除文件。

语法

LIST { userStage | internalStage | externalStage } [ PATTERN = '<regex_pattern>' ]

PATTERN 使用正则表达式筛选已暂存的文件。它匹配 @<stage_name>[/<path>] 之后的文件路径部分。参见 使用 PATTERN 筛选已暂存文件。

示例

下面的 stage 包含一个名为 books.parquet 的文件和一个名为 2023 的文件夹。

默认情况下，LIST 命令会列出 stage 中的所有文件：

LIST @my_internal_stage;
+-----------------+------+------------------------------------+-------------------------------+---------+
|      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    |
| 2023/readme.txt | 1193 | "8c0fbbebfedf26f93324541f97f5ac14" | 2023-04-19 20:23:24.000 +0000 | NULL    |
| books.parquet   |  998 | "88432bf90aadb79073682988b39d461c" | 2023-04-19 20:08:42.000 +0000 | NULL    |
+-----------------+------+------------------------------------+-------------------------------+---------+

要列出 2023 文件夹中的文件，请运行以下命令：

LIST @my_internal_stage/2023/;
+-----------------+------+------------------------------------+-------------------------------+---------+
|      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    |
| 2023/readme.txt | 1193 | "8c0fbbebfedf26f93324541f97f5ac14" | 2023-04-19 20:23:24.000 +0000 | NULL    |
+-----------------+------+------------------------------------+-------------------------------+---------+

要列出 stage 中所有扩展名为 .log 的文件，请运行以下命令：

LIST @my_internal_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    |
+----------------+------+------------------------------------+-------------------------------+---------+