to_file 函數

適用於：勾選標記為是 Databricks SQL 勾選 Databricks 執行時間 18 LTS 及以上

Important

這項功能位於 測試版 (Beta) 中。 工作區管理員可以從 「預覽 」頁面控制對此功能的存取。 請參閱 管理 Azure Databricks 預覽。

回傳 FILE 一個以檔案為參考的 path值。

Syntax

to_file(path)

Arguments

  • path： 一個 STRING 指定檔案路徑的表達式。 例如，Unity 目錄卷中的一條路徑。

Returns

一個 FILE 參考檔案於 path的值。

為了收集檔案元資料，Azure Databricks 會遠端呼叫檔案的儲存位置。 如果檔案不存在或無法存取，Azure Databricks 會發出錯誤。 要回來 NULL ，請使用 try_to_file 函數。

常見錯誤條件

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

欲了解更多資訊，請參閱 Azure Databricks 中的錯誤條件。

Examples

要從卷中的路徑建立 FILE 參考：

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

若路徑不存在或使用者缺乏讀取權限， to_file 則會產生錯誤：

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on