適用於：
Databricks SQL 執行時間 18 LTS 及以上
Important
這項功能位於 測試版 (Beta) 中。 工作區管理員可以從 「預覽 」頁面控制對此功能的存取。 請參閱 管理 Azure Databricks 預覽。
回傳 FILE 一個值，參考該檔案在 path，或 NULL 是檔案不存在或無法存取時。
Syntax
try_to_file(path)
Arguments
-
path： 一個STRING表示式，指定檔案路徑，例如 Unity 目錄磁碟區中的路徑。
Returns
一個 FILE 參考檔案在 path，或 NULL 是檔案不存在或無法存取時的值。
這個函數是函數的容錯版本to_file。 為了收集檔案元資料，Azure Databricks 會遠端呼叫檔案的儲存位置。 如果檔案不存在或無法存取，這個函式會回傳 NULL 而非錯誤。
常見錯誤條件
TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED
欲了解更多資訊，請參閱 Azure Databricks 中的錯誤條件。
Examples
要從卷中的路徑建立 FILE 參考：
SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');
若路徑不存在或無法存取，則 try_to_file 回傳 NULL：
SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');
NULL