FileStream 將 VARBINARY(MAX) 資料儲存於 NTFS 檔案系統,兼具資料庫交易一致性與檔案流存取效能,適合 >1MB 文件、影像、影音等大型二進位物件(BLOB)。
MSSQLSERVER)→「屬性」→「FILESTREAM」頁籤。EXEC sp_configure 'filestream_access_level', 2; -- 0=關閉, 1=僅 T-SQL, 2=完整啟用
RECONFIGURE;
GO
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 資料(實為資料夾)。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
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())。VARBINARY(MAX) FILESTREAM。-- 插入(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) 進行高效能串流讀寫。
BACKUP DATABASE 自動包含 FileStream 資料夾內容。FILEGROUP 選項。FileStream 為大型 BLOB 儲存提供「資料庫一致性 + 檔案系統效能」的最佳平衡,適合文件管理、影像存檔、日誌歸檔等場景。