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


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.

Примеры

> 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    ...
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table1 table1 0    ...