Dela via

LIST

gäller för:kontrollera markerat ja Databricks SQL kontrollera markerat ja Databricks Runtime 10.4 LTS och senare kontrollera markerat ja Endast Unity Catalog

Visar en lista över objekt som omedelbart finns på URL:en.

Syntax

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

Parametrar

  • URL

    En STRING literal med platsen för molnlagringen beskriven som en absolut URL.

  • credential_name

    En valfri namngiven autentiseringsuppgift som används för att komma åt den här URL:en. Om du anger en autentiseringsuppgift måste den vara tillräcklig för att komma åt URL:en. Om du inte anger någon autentiseringsuppgift måste URL:en finnas på en extern plats som du har åtkomst till.

  • gräns

    En valfri INTEGER konstant som används för att begränsa antalet returnerade objekt.

    I Databricks Runtime 10.4 LTS är standardgränsen 1001 och endast värden mellan 1 och 1001 stöds.

Retur

En resultatuppsättning med följande kolumner:

  • path STRING NOT NULL: Lagringsobjektets fullständiga URI.
  • name STRING NOT NULL: Namnet på lagringsobjektet, inklusive dess tillägg.
  • size BIGINT NOT NULL: Storleken på objektet i byte. 0 för kataloger.
  • modification_time BIGINT NOT NULL: Unix-tidsstämpeln för objektets senaste ändringstid i millisekunder. Om du vill konvertera det här värdet till en TIMESTAMP typ använder du CAST(modification_time / 1000 AS TIMESTAMP) eller to_timestamp(modification_time / 1000).

Exempel

> 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