LIST (Databricks SQL)

重要

Unity Catalog 目前为公共预览版。 要使用该预览版,请联系 Azure Databricks 代表。

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

语法

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

参数

  • url

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

  • credential_name

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

  • limit

    可选的 INTEGER 常量,介于 1 和 1001 之间,用于限制返回的对象数。 默认限制为 1001

示例

> LIST 'abfss://us-east-1-dev/some_dir' WITH (CREDENTIAL azure_some_dir) LIMIT 2
  path                                  name   size modification_time is_directory
  ------------------------------------- ------ ---- ----------------- ------------
  abfss://us-east-1-dev/some_dir/table1 table1 0    ...               true
  abfss://us-east-1-dev/some_dir/table1 table1 0    ...               true