Udostępnij za pośrednictwem

LIST

  • Artykuł

Dotyczy:zaznaczono jako tak Databricks SQL zaznaczono jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczono jako tak tylko Unity Catalog

Wyświetla listę obiektów znajdujących się natychmiast pod adresem URL.

Składnia

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

Parametry

  • adres URL

    Literał STRING z lokalizacją magazynu w chmurze opisany jako bezwzględny adres URL.

  • credential_name

    Opcjonalne nazwane poświadczenia używane do uzyskiwania dostępu do tego adresu URL. Jeśli podasz poświadczenie, musi być wystarczające, aby uzyskać dostęp do adresu URL. Jeśli nie podasz poświadczeń, adres URL musi znajdować się w lokalizacji zewnętrznej, do której masz dostęp.

  • ograniczenie

    Opcjonalna stała INTEGER używana do ograniczania liczby zwracanych obiektów.

    W środowisku Databricks Runtime 10.4 LTS domyślny limit wynosi 1001, a obsługiwane są tylko wartości z zakresu od 1 do 1001.

Przykłady

> 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    ...
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table1 table1 0    ...