LIST

A következőkre vonatkozik:Databricks SQL Databricks Runtime 10.4 LTS és a Unity Catalog felett csak

Felsorolja az URL-címen azonnal található objektumokat.

Szintaxis

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

Paraméterek

• URL-cím

  Egy STRING literál, amely a felhőtárhely helyét abszolút URL-ként írja le.

• credential_name

  Az URL-cím eléréséhez használható, nem kötelezően megadandó elnevezett hitelesítő adat. Ha hitelesítő adatokat ad meg, elegendőnek kell lennie az URL-cím eléréséhez. Ha nem ad meg hitelesítő adatokat, az URL-címet olyan külső helyen kell tárolni, amelyhez hozzáféréssel rendelkezik.

• korlát

  A visszaadott objektumok számának korlátozására szolgáló opcionális INTEGER állandó.

  A Databricks Runtime 10.4 LTS-ben az alapértelmezett korlát, 1001 és csak az 1 és 1001 közötti értékek támogatottak.

Visszatérítések

Eredményhalmaz a következő oszlopokkal:

• path STRING NOT NULL: A tárobjektum teljes URI-ja.
• name STRING NOT NULL: A tárobjektum neve, beleértve annak bővítményét is.
• size BIGINT NOT NULL: Az objektum mérete bájtban. 0 könyvtárak esetében.
• modification_time BIGINT NOT NULL: Az objektum utolsó módosítási idejének Unix-időbélyege ezredmásodpercben. Az érték típussá TIMESTAMP alakításához használja CAST(modification_time / 1000 AS TIMESTAMP) vagy to_timestamp(modification_time / 1000).

Példák

> 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

Kapcsolódó cikkek

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