LIST_STAGE (Lakehouse v1)

Lista os arquivos de um stage. Isso permite filtrar os arquivos de um stage com base em suas extensões e obter detalhes abrangentes sobre cada arquivo. A função é semelhante ao comando DDL LIST STAGE FILES, mas oferece a flexibilidade de obter informações específicas dos arquivos com a instrução SELECT, como nome do arquivo, tamanho, hash MD5, carimbo de data/hora da última modificação e criador, em vez de todas as informações do arquivo.

Sintaxe SQL

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

Em que:

Internalstage

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

Externalstage

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

Userstage

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

PATTERN

Consulte COPY INTO table.

Exemplos de SQL

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    │
└────────────────┴──────┴────────────────────────────────────┴───────────────────────────────┴─────────┘

-- Equivalent to the following statement:
LIST @my_stage PATTERN = '.log';