列表

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 10.4 LTS 及更高版本 勾选“是” 仅 Unity Catalog

列出 URL 中立即包含的对象。

语法

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

参数

  • url

    将云存储的位置描述为绝对 URL 的 STRING 文本。

  • credential_name

    用于访问此 URL 的可选命名凭据。 如果提供凭据,则该凭据必须足以访问 URL。 如果未提供凭据,则必须将 URL 包含在你有权访问的外部位置。

  • 限制

    一个可选的 INTEGER 常量,用来限制返回的对象数。

    在 Databricks Runtime 10.4 LTS 中,默认限制为 1001,仅支持介于 1 和 1001 之间的值。

示例

> LIST 'abfss://container@storageaccount.dfs.core.chinacloudapi.cn/some_dir' WITH (CREDENTIAL azure_some_dir) LIMIT 2
  path                                                                  name   size modification_time
  --------------------------------------------------------------------- ------ ---- -----------------
  abfss://container@storageaccount.dfs.core.chinacloudapi.cn/some_dir/table1 table1 0    ...
  abfss://container@storageaccount.dfs.core.chinacloudapi.cn/some_dir/table1 table1 0    ...