LIST

Se aplica a:marcado sí Databricks SQL marcado sí Databricks Runtime 10.4 LTS y superiores marcado sí Solo catálogo de Unity

Enumera los objetos contenidos inmediatamente en la dirección URL.

Sintaxis

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

Parámetros

  • url

    Literal STRING con la ubicación del almacenamiento en la nube descrita como dirección URL absoluta.

  • credential_name

    Credencial con nombre opcional que se usa para acceder a esta dirección URL. Si proporciona una credencial, debe ser suficiente para acceder a la dirección URL. Si no proporciona una credencial, la URL debe estar contenida en una ubicación externa a la que tenga acceso.

  • límite

    Constante opcional INTEGER usada para limitar el número de objetos devueltos.

    En Databricks Runtime 10.4 LTS, el límite predeterminado es 1001 y solo se admiten valores entre 1 y 1001.

Devoluciones

Un conjunto de resultados con las columnas siguientes:

  • path STRING NOT NULL: La URI completa del objeto de almacenamiento.
  • name STRING NOT NULL: El nombre del objeto de almacenamiento, incluida su extensión.
  • size BIGINT NOT NULL: El tamaño del objeto en bytes. 0 para directorios.
  • modification_time BIGINT NOT NULL: La marca temporal de Unix de la última hora de modificación del objeto en milisegundos. Para convertir este valor en un TIMESTAMP tipo, use CAST(modification_time / 1000 AS TIMESTAMP) o to_timestamp(modification_time / 1000).

Ejemplos

> 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