使用檔案輸入輸出 API 存取 FileTable

發行項
05/04/2023

適用於：SQL Server

描述檔案系統 I/O 如何在 FileTable 上運作。

開始使用 FileTable 檔案的 I/O API

FileTable 的主要用法是透過 Windows 檔案系統和檔案 I/O API。 FileTable 支援透過一系列可用檔案 I/O API 的非交易式存取。

檔案 I/O API 存取通常一開始會先取得檔案或目錄的邏輯 UNC 路徑。應用程式可以搭配 GetFileNamespacePath (Transact-SQL) 函數使用 Transact-SQL 陳述式，以取得檔案或目錄的邏輯路徑。如需詳細資訊，請參閱 Work with Directories and Paths in FileTables。
然後應用程式會使用此邏輯路徑以取得檔案或目錄控制代碼，並對物件進行操作。該路徑可傳遞至任何支援的檔案系統 API 函數，例如 CreateFile() 或 CreateDirectory()，以建立或開啟檔案並取得控制代碼。控制代碼隨後便可用於以資料流形式處理資料、列舉或組織目錄、取得或設定檔案屬性、刪除檔案或目錄等。

在 FileTable 中建立檔案和目錄

透過呼叫檔案 I/O API (例如 CreateFile 或 CreateDirectory) 在 FileTable 中建立檔案或目錄。

支援所有建立配置旗標、共用模式及存取模式。其中包括檔案建立、刪除及就地修改。另外也支援檔案命名空間更新，例如目錄建立/刪除、重新命名和移動作業。
新檔案或目錄的建立會對應到基礎 FileTable 中新資料列的建立。
若為檔案，資料流資料會儲存在 file_stream 資料行中；若為目錄，此資料行為 null。
若為檔案， is_directory 資料行內含 false。若為目錄，此資料行內含 true。
當多個並行的檔案 I/O 作業或 Transact-SQL 作業在階層中影響同一個檔案或目錄時，會強制執行共用存取及並行存取。

讀取 FileTable 中的檔案和目錄

若為所有資料流及屬性資料的檔案 I/O 存取作業，SQL Server 會強制執行讀取認可隔離語意。

寫入及更新 FileTable 中的檔案和目錄

所有 FileTable 上的檔案 I/O 寫入或更新作業都是非交易式的。也就是說，不會有任何 SQL Server 交易繫結至這些作業，而且不會提供任何 ACID 保證。
FileTable 支援所有檔案 I/O 資料流/就地更新。
透過檔案 I/O API 進行的 FILESTREAM 資料或屬性更新都將更新 FileTable 中對應的 file_stream 及對應的檔案屬性資料行。

刪除 FileTable 中的檔案和目錄

當您刪除檔案或目錄時會強制執行所有 Windows 檔案 I/O API 語意。

如果目錄中包含任何檔案或子目錄，將無法刪除目錄。
刪除檔案或目錄將會從 FileTable 中移除對應的資料列。這相當於透過 Transact-SQL 作業刪除該資料列。

支援的檔案系統作業

FileTable 支援與下列檔案系統作業相關的檔案系統 API：

目錄管理
檔案管理

FileTable 不支援下列作業：

磁碟管理
磁碟區管理
交易式 NTFS

FileTable 之檔案 I/O 存取的其他考量

使用虛擬網路名稱 (VNN) 搭配 AlwaysOn 可用性群組

當包含 FILESTREAM 或 FileTable 資料的資料庫屬於 AlwaysOn 可用性群組時，透過檔案系統 API 對 FILESTREAM 或 FileTable 資料進行的所有存取都應該使用 VNN 而非電腦名稱。如需詳細資訊，請參閱 FILESTREAM 和 FileTable 與 AlwaysOn 可用性群組 (SQL Server)。

部分更新

使用 GetFileNamespacePath (Transact-SQL) 函數在 FileTable 中取得的 FILESTREAM 資料可寫入控制代碼，可用於執行 FILESTREAM 內容的就地、部分更新。此行為與交易 FILESTREAM 存取不同，它是透過呼叫 OpenSQLFILESTREAM() 及傳遞明確交易內容所取得的控制代碼來進行。

交易式語意

當您使用檔案 I/O API 於 FileTable 中存取檔案時，這些作業不會與任何使用者交易有關聯，並且具有下列其他特性：

FileTable 中 FILESTREAM 資料的非交易式存取與任何交易無關，因此不會有任何特定的隔離語意。但 SQL Server 可能會使用內部交易，針對 FileTable 資料強制執行鎖定或並行語意。此類型的任何內部交易都已完成讀取認可隔離。
這些 FILESTREAM 資料上的非交易作業沒有任何 ACID 保證。一致性保證類似於檔案系統上應用程式所建立的檔案更新。
這些變更無法回復。

但是，FileTable 中的 FILESTREAM 資料行也可以透過呼叫 OpenSqlFileStream() ，與交易式 FILESTREAM 存取一同進行存取。這種存取可以完全為交易式，而且會接受目前一致支援的所有交易式層級。

並行控制

SQL Server 會在檔案系統應用程式之間以及檔案系統應用程式和 Transact-SQL 應用程式之間強制執行 FileTable 存取的並行存取控制。達成此並行存取控制的方式是針對 FileTable 資料列採取適當的鎖定。

觸發程序

透過檔案系統建立、修改、或刪除檔案或目錄或其屬性，將會導致 FileTable 中對應的插入、更新或刪除作業。任何關聯的 Transact-SQL DML 觸發程序都會當做這些作業的一部分引發。

FileTable 中支援的檔案系統功能

功能	支援	註解
Oplock	是	支援層級 2、層級 1、批次和篩選器 oplock。
擴充屬性	否
重新剖析點	否
持續的 ACL	否
具名資料流	否
疏鬆檔案	是	疏鬆性只能在檔案上設定，而且會影響資料流的儲存方式。 FILESTREAM 資料儲存在 NTFS 磁碟區上，因此 FileTable 功能會將要求轉送至 NTFS 檔案系統以支援疏鬆檔案。
壓縮	是
加密	是
TxF	否
檔案識別碼	否
物件識別碼	否
符號連結	否
永久連結	否
簡短名稱	否
目錄變更通知	否
位元組範圍鎖定	是	位元組範圍鎖定的要求會傳遞到 NTFS 檔案系統。
記憶體對應檔案	否
取消 I/O	是
安全性	否	系統會強制執行 Windows 共用層級安全性和 SQL Server 資料表與資料行層級安全性。
USN 日誌	否	FileTable 中檔案和目錄的中繼資料變更為 SQL Server 資料庫上的 DML 作業。因此，這些會記錄在對應的資料庫記錄檔中。但是，並不會記錄在 NTFS USN 日誌中 (除非大小有變更)。 SQL Server 變更追蹤功能可用於取得類似的資訊。

另請參閱

載入檔案至 FileTable
使用 FileTable 中的目錄與路徑
 利用 Transact-SQL 存取 FileTable
FileTable DDL、函數、預存程序及檢視