LIST

適用於： 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 之間的值。

退貨

具有下列欄位的結果集：

• path STRING NOT NULL：儲存物件的完整 URI。
• name STRING NOT NULL：儲存物件的名稱，包括其擴展。
• size BIGINT NOT NULL：物件的大小（以位元組為單位）。 0 用於目錄。
• modification_time BIGINT NOT NULL：物件最後修改時間的 Unix 時間戳，單位為毫秒。 若要將此值轉換為型 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

相關文章

• ALTER EXTERNAL LOCATION
• CREATE EXTERNAL LOCATION
• DESCRIBE EXTERNAL LOCATIONS
• DROP EXTERNAL LOCATION