LIST

Aplica-se a: SQL do Databricks Databricks Runtime 10.4 LTS e superior Somente Catálogo do Unity

Lista os objetos imediatamente contidos na URL.

Sintaxe

LIST url [ WITH ( CREDENTIAL credential_name ) ] [ LIMIT limit ]

Parâmetros

• url

  Um literal STRING com o local do armazenamento em nuvem descrito como uma URL absoluta.

• credential_name

  Uma credencial nomeada opcional usada para acessar essa URL. Se você fornecer uma credencial, ela deverá ser suficiente para acessar a URL. Se você não fornecer uma credencial, a URL deverá estar contida em um local externo ao qual você tem acesso.

• limite

  Uma constante INTEGER opcional usada para limitar o número de objetos retornados.

  No Databricks Runtime 10.4 LTS, o limite padrão é 1001 e há suporte apenas para valores entre 1 e 1001.

Devoluções

Um conjunto de resultados com as seguintes colunas:

• path STRING NOT NULL: o URI completo do objeto de armazenamento.
• name STRING NOT NULL: o nome do objeto de armazenamento, incluindo sua extensão.
• size BIGINT NOT NULL: o tamanho do objeto em bytes. 0 para diretórios.
• modification_time BIGINT NOT NULL: o carimbo de data/hora Unix da última modificação do objeto em milissegundos. Para converter esse valor em um TIMESTAMP tipo, use CAST(modification_time / 1000 AS TIMESTAMP) ou to_timestamp(modification_time / 1000).

Exemplos

> LIST 'abfss://container@storageaccount.dfs.core.windows.net/some_dir' WITH (CREDENTIAL azure_some_dir) LIMIT 2
  path                                                                  name   size modification_time
  --------------------------------------------------------------------- ------ ---- -----------------
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table1 table1 0    1706105124000
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table2 table2 1024 1706201562000

Artigos relacionados

• ALTER EXTERNAL LOCATION
• CREATE EXTERNAL LOCATION
• DESCRIBE EXTERNAL LOCATIONS
• DROP EXTERNAL LOCATION