Sdílet prostřednictvím


LIST

Platí pro:ano Databricks SQL ano Databricks Runtime 10.4 LTS a vyšší ano pouze Unity Catalog

Vypíše objekty okamžitě obsažené v adrese URL.

Syntaxe

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

Parametry

  • adresa URL

    Literál STRING s umístěním cloudového úložiště, které je popsáno jako absolutní URL adresa.

  • credential_name

    Volitelné pojmenované přihlašovací údaje používané pro přístup k této adrese URL. Pokud zadáte přihlašovací údaje, musí být dostačující pro přístup k adrese URL. Pokud nezadáte přihlašovací údaje, musí být adresa URL obsažena v externím umístění, ke kterému máte přístup.

  • limit

    Volitelná INTEGER konstanta používaná k omezení počtu vrácených objektů.

    Ve službě Databricks Runtime 10.4 LTS je výchozí limit 1001 a podporují se pouze hodnoty mezi 1 a 1001.

Návraty

Sada výsledků s následujícími sloupci:

  • path STRING NOT NULL: Úplný identifikátor URI objektu úložiště.
  • name STRING NOT NULL: Název objektu úložiště, včetně jeho rozšíření.
  • size BIGINT NOT NULL: Velikost objektu v bajtech. 0 pro adresáře.
  • modification_time BIGINT NOT NULL: Časové razítko unixu času poslední změny objektu v milisekundách. Chcete-li tuto hodnotu převést na TIMESTAMP typ, použijte CAST(modification_time / 1000 AS TIMESTAMP) nebo to_timestamp(modification_time / 1000).

Příklady

> 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