Partilhar via

LIST

Aplica-se a:marcado como sim ao Databricks SQL marcado como sim ao Databricks Runtime 10.4 LTS e superior marcado como sim somente ao Unity Catalog

Lista os objetos imediatamente contidos na URL.

Sintaxe

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

Parâmetros

  • URL

    Um STRING literal com a localização do armazenamento em nuvem descrito como um URL absoluto.

  • 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ê tenha acesso.

  • limit

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

    No Databricks Runtime 10.4 LTS o limite padrão é 1001 e apenas valores entre 1 e 1001 são suportados.

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 a sua extensão.
  • size BIGINT NOT NULL: O tamanho do objeto em bytes. 0 para diretórios.
  • modification_time BIGINT NOT NULL: O carimbo temporal do Unix do último tempo de modificação do objeto em milissegundos. Para converter este valor para 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
  • Last updated on