Поделиться через

LIST

Область применения:флажок Да Databricks SQL флажок Да Databricks Runtime 10.4 LTS и выше флажок Да только для Unity Catalog

Возвращает список объектов, непосредственно содержащихся в URL-адресе.

Синтаксис

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

Параметры

  • url

    Литерал STRING с расположением облачного хранилища в формате абсолютного URL-адреса.

  • credential_name

    Необязательные именованные учетные данные для доступа к этому URL-адресу. Предоставленных учетных данных должно быть достаточно для доступа к URL-адресу. Если вы не предоставите учетные данные, URL-адрес должен располагаться во внешнем местоположении, к которому у вас есть доступ.

  • limit

    Необязательная INTEGER константа, используемая для ограничения количества возвращаемых объектов.

    В Databricks Runtime 10.4 LTS ограничение по умолчанию равно 1001 , а поддерживаются только значения от 1 до 1001.

Возвраты

Результирующий набор со следующими столбцами:

  • path STRING NOT NULL: полный универсальный код ресурса (URI) объекта хранилища.
  • name STRING NOT NULL: имя объекта хранилища, включая его расширение.
  • size BIGINT NOT NULL: размер объекта в байтах. 0 для каталогов.
  • modification_time BIGINT NOT NULL: метка времени последнего изменения объекта в миллисекундах. Чтобы преобразовать это значение в TIMESTAMP тип, используйте CAST(modification_time / 1000 AS TIMESTAMP) или to_timestamp(modification_time / 1000).

Примеры

> 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