萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

SQL Server 啟用 FileStream 整合檔案系統儲存大型二進位資料:安裝後啟用、建立檔案群組、資料表與讀寫範例

FileStream 將 VARBINARY(MAX) 資料儲存於 NTFS 檔案系統,兼具資料庫交易一致性與檔案流存取效能,適合 >1MB 文件、影像、影音等大型二進位物件(BLOB)。

1. 執行個體層級啟用

  1. SQL Server 組態管理器 → 「SQL Server 服務」→ 右鍵目標實例(如 MSSQLSERVER)→「屬性」→「FILESTREAM」頁籤。
  2. 勾選:
  • ☑ 針對 Transact-SQL 存取啟用 FILESTREAM
  • ☑ 針對檔案 I/O 存取啟用 FILESTREAM(選填,需 Windows 共用名稱)
  • ☑ 允許遠端用戶端存取 FILESTREAM 資料(選填)
  1. 套用 → 服務將自動重啟。

2. 伺服器層級進階選項

EXEC sp_configure 'filestream_access_level', 2; -- 0=關閉, 1=僅 T-SQL, 2=完整啟用
RECONFIGURE;
GO

3. 建立支援 FileStream 的資料庫

CREATE DATABASE FSDB
ON PRIMARY
( NAME = FSDB_Data, FILENAME = 'D:\SQLData\FSDB_Data.mdf' ),
FILEGROUP FSDB_FSGroup CONTAINS FILESTREAM
( NAME = FSDB_FSData, FILENAME = 'D:\SQLData\FSDB_FSData' ) -- 此為資料夾路徑,非 .ndf
LOG ON
( NAME = FSDB_Log, FILENAME = 'D:\SQLLog\FSDB_Log.ldf' );
GO
  • CONTAINS FILESTREAM 宣告此檔案群組存放 FileStream 資料(實為資料夾)。
  • 資料夾必須預先不存在,由 SQL Server 建立並管理。

4. 既有資料庫新增 FileStream 檔案群組

ALTER DATABASE FSDB
ADD FILEGROUP FSDB_FSGroup2 CONTAINS FILESTREAM;
GO
ALTER DATABASE FSDB
ADD FILE
( NAME = 'FSDB_FSData2', FILENAME = 'D:\SQLData\FSDB_FSData2' )
TO FILEGROUP FSDB_FSGroup2;
GO

5. 建立 FileStream 資料表

CREATE TABLE DocumentStore
(
    DocId       INT IDENTITY(1,1) PRIMARY KEY,
    RowGuid     UNIQUEIDENTIFIER NOT NULL ROWGUIDCOL UNIQUE DEFAULT NEWID(),
    FileData    VARBINARY(MAX) FILESTREAM NULL,
    FileName    NVARCHAR(255),
    UploadTime  DATETIME2 DEFAULT SYSUTCDATETIME()
);
GO

必要條件:

  • 資料表必須有 ROWGUIDCOL + UNIQUEIDENTIFIER + UNIQUE + NOT NULL 的資料行(通常用 NEWID() 或 NEWSEQUENTIALID())。
  • FileStream 欄位宣告為 VARBINARY(MAX) FILESTREAM。

6. T-SQL 讀寫範例

-- 插入(0x00 為空二進位佔位,實際應用由應用層串流寫入)
INSERT INTO DocumentStore (FileName, FileData) VALUES ('spec.pdf', 0x00);
INSERT INTO DocumentStore (FileName, FileData) VALUES ('image.png', 0x00);

-- 取得檔案系統路徑(供應用層 OpenSqlFilestream API 讀寫)
SELECT FileData.PathName() AS UNC_Path,
       GET_FILESTREAM_TRANSACTION_CONTEXT() AS Token
FROM DocumentStore
WHERE DocId = 1;

輸出 UNC 路徑如:\\Server\MSSQLSERVER\FSDB_FSData\...\{GUID}。應用層使用 OpenSqlFilestream (Win32 API) 或 SqlFileStream (.NET) 進行高效能串流讀寫。

7. 備份與還原

  • BACKUP DATABASE 自動包含 FileStream 資料夾內容。
  • 檔案群組層級備份/還原支援 FILEGROUP 選項。
  • 記錄檔備份同樣涵蓋 FileStream 變更。

限制與考量

  • 不支援資料庫鏡像(Database Mirroring),支援 AlwaysOn 可用性群組(2012+)。
  • 資料庫快照不包含 FileStream 資料。
  • 檔案層級防毒掃描需排除 FileStream 資料夾,避免鎖定檔案導致 SQL 錯誤。
  • 每個 FileStream 容器(資料夾)上限約 2^64 bytes,單一檔案 2GB (32-bit) / 16TB (64-bit)。

FileStream 為大型 BLOB 儲存提供「資料庫一致性 + 檔案系統效能」的最佳平衡,適合文件管理、影像存檔、日誌歸檔等場景。

copyright © 萬盛學電腦網 all rights reserved