LIST

Berlaku untuk:centang ditandai yaDatabricks SQL centang ditandai ya Databricks Runtime 10.4 LTS dan di atas centang ditandai ya Unity Catalog saja

Mencantumkan objek yang langsung ada di URL.

Sintaks

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

Parameter-parameternya

  • url

    Harfiah STRING dengan lokasi penyimpanan cloud yang digambarkan sebagai URL absolut.

  • credential_name

    Kredensial bernama opsional yang digunakan untuk mengakses URL ini. Jika Anda memberikan kredensial, itu harus cukup memadai untuk mengakses URL. Jika Anda tidak memberikan kredensial, URL harus terletak di lokasi eksternal yang dapat Anda akses.

  • batas

    Konstanta INTEGER opsional yang digunakan untuk membatasi jumlah objek yang dikembalikan.

    Dalam Databricks Runtime 10.4 LTS, batas default 1001 dan hanya nilai antara 1 dan 1001 yang didukung.

Pengembalian Barang

Hasil yang diatur dengan kolom berikut:

  • path STRING NOT NULL: URI lengkap objek penyimpanan.
  • name STRING NOT NULL: Nama objek penyimpanan, termasuk ekstensinya.
  • size BIGINT NOT NULL: Ukuran objek dalam byte. 0 untuk direktori.
  • modification_time BIGINT NOT NULL: Tanda waktu Unix dari waktu modifikasi terakhir objek dalam milidetik. Untuk mengonversi nilai ini menjadi TIMESTAMP jenis, gunakan CAST(modification_time / 1000 AS TIMESTAMP) atau to_timestamp(modification_time / 1000).

Contoh

> 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