Condividi tramite

LIST

Si applica a:segno di spunta sìSolo databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì al catalogo Unity

Elenca gli oggetti immediatamente contenuti nell'URL.

Sintassi

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

Parametri

  • url

    Valore STRING letterale con la posizione dell'archiviazione cloud descritta come URL assoluto.

  • credential_name

    Credenziale denominata facoltativa usata per accedere a questo URL. Se si specifica una credenziale, è necessario che sia sufficiente accedere all'URL. Se non si specifica una credenziale, l'URL deve essere contenuto in una posizione esterna a cui si ha accesso.

  • limit

    Costante facoltativa utilizzata INTEGER per limitare il numero di oggetti restituiti.

    In Databricks Runtime 10.4 LTS il limite predefinito è 1001 e sono supportati solo i valori compresi tra 1 e 1001.

Restituzioni

Set di risultati con le colonne seguenti:

  • path STRING NOT NULL: URI completo dell'oggetto di archiviazione.
  • name STRING NOT NULL: nome dell'oggetto di archiviazione, inclusa la relativa estensione.
  • size BIGINT NOT NULL: dimensione dell'oggetto in byte. 0 per le directory.
  • modification_time BIGINT NOT NULL: timestamp Unix dell'ora dell'ultima modifica dell'oggetto in millisecondi. Per convertire questo valore in un TIMESTAMP tipo, usare CAST(modification_time / 1000 AS TIMESTAMP) o to_timestamp(modification_time / 1000).

Esempi

> 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