Important
這項功能位於 測試版 (Beta) 中。 工作區管理員可以從 「預覽 」頁面控制對此功能的存取。 請參閱 管理 Azure Databricks 預覽。
該 FILE 類型代表非結構化檔案，如文件、圖片和音訊。 內建的 SQL 函式可以建立、複製並讀取檔案作為 FILE 參考。
本頁將這些函數及常見操作的參考範例總結，例如：
- 在 Unity 目錄卷
FILE中以 . 作為參考list_files資料列出檔案。 - 讀取檔案元資料，如
size和checksum（用來辨識檔案版本）。 - 透過元資料過濾檔案。
- 用
ai_parse_document解析文件內容。
關於類型參考，請參見 FILE 類型。
概念概述請參見 FILE 類型與非結構化資料。
要求
- 這些範例使用
samples.sec.contracts資料集，這是一組預設可在所有工作區提供、由美國證券交易委員會（SEC）提交的合約 PDF 集合。 要使用你自己的檔案，請將路徑指向包含這些檔案的 Unity 目錄卷。
Examples
清單檔案與擷取參考
若要在路徑上列出檔案並將參考資料儲存 FILE 在表格中，請使用 list_files table-valued 函式：
CREATE TABLE documents AS
SELECT path, size, modification_time, file
FROM list_files('/Volumes/samples/sec/contracts/');
讀取檔案元資料
要讀取uri一個size值的 、 content_type、 checksum和 FILE 欄位，請使用點符號表示：
SELECT file.uri, file.size, file.content_type, file.checksum
FROM documents;
依元資料篩選檔案
要利用檔案元資料（如路徑與大小）來篩選資料列：
SELECT file.uri
FROM documents
WHERE file.uri ILIKE '%.pdf'
AND file.size > 100000;
解析文件內容
要從文件中擷取結構化內容，請將一個 FILE 值傳入 ai_parse_document 函式：
SELECT file.uri, ai_parse_document(file) AS parsed
FROM documents
WHERE file.uri ILIKE '%.pdf';
範例筆記本
以下筆記本將前述所有範例與資料 samples.sec.contracts 集進行對照：