Freigeben über

LIST

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen bei ja Nur Unity Catalog

Listet die Objekte auf, die direkt in der URL enthalten sind.

Syntax

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

Parameter

  • url

    Ein STRING-Literal mit dem Speicherort des Cloudspeichers, beschrieben als absolute URL.

  • credential_name

    Optionale benannte Anmeldeinformationen, die für den Zugriff auf die betreffende URL verwendet werden. Wenn Sie Anmeldeinformationen angeben, müssen diese für den Zugriff auf die URL ausreichend sein. Wenn Sie keine Anmeldeinformationen angeben, muss die URL in einem externen Speicherort enthalten sein, auf den Sie Zugriff haben.

  • limit

    Eine optionale INTEGER-Konstante, die zur Begrenzung der Anzahl der zurückgegebenen Objekte verwendet wird.

    In Databricks Runtime 10.4 LTS wird der Standardgrenzwert 1001 verwendet, und nur Werte zwischen 1 und 1.001 werden unterstützt.

Rückkehr

Resultset mit folgenden Spalten:

  • path STRING NOT NULL: Der vollständige URI des Speicherobjekts.
  • name STRING NOT NULL: Der Name des Speicherobjekts, einschließlich seiner Erweiterung.
  • size BIGINT NOT NULL: Die Größe des Objekts in Byte. 0 für Verzeichnisse.
  • modification_time BIGINT NOT NULL: Der Unix-Zeitstempel der letzten Änderungszeit des Objekts in Millisekunden. Um diesen Wert in einen TIMESTAMP Typ zu konvertieren, verwenden CAST(modification_time / 1000 AS TIMESTAMP) oder to_timestamp(modification_time / 1000).

Beispiele

> 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