Compartir vía

LIST

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

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 la proporciona, la dirección URL debe estar contenida en una ubicación externa a la que tenga acceso.

  • limit

    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: el URI completo del objeto de almacenamiento.
  • name STRING NOT NULL: el nombre del objeto de almacenamiento, incluida su extensión.
  • size BIGINT NOT NULL: tamaño del objeto en bytes. 0 para directorios.
  • modification_time BIGINT NOT NULL: marca de tiempo de Unix de la hora de última 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
  • Last updated on