filetable 必须启用 filestream 和非事务访问才能使用，c# 应通过动态获取的 unc 路径直接 i/o 操作文件，避免查询 file_stream 列；路径、权限、网络任一失败均导致访问中断。
FileTable 在 SQL Server 中必须启用 FILESTREAM 和 FileTable 功能
SQL Server 的 FileTable 不是普通表，它依赖底层的 FILESTREAM 文件流支持。如果没开 FILESTREAM，建 FileTable 会直接报错：Msg 33405, Level 16, State 1: FileTable cannot be created because FILESTREAM is not enabled.
启用步骤分三步，缺一不可：
- SQL Server 实例配置中启用 FILESTREAM：用 SQL Server Configuration Manager → 右键实例 → Properties → FILESTREAM tab → 勾选「Enable FILESTREAM for Transact-SQL access」和「for file I/O streaming access」，并指定 Windows 共享名（如
FSData） - 重启 SQL Server 服务（仅改配置不重启无效）
- 执行 T-SQL 启用数据库级 FILESTREAM：
ALTER DATABASE [YourDB] SET FILESTREAM ( NON_TRANSACTED_ACCESS = FULL )
，再建 FileTable 才能成功
C# 通过 UNC 路径直接读写 FileTable 文件（无需 SQL 查询）
FileTable 的核心价值就是“像访问本地文件一样访问数据库里的文件”。只要 SQL Server 开启了非事务访问（NON_TRANSACTED_ACCESS = FULL），它就会暴露一个 Windows 共享路径，例如：<i>server-name</i>FSData<i>filetable-name</i>。C# 完全可以用 System.IO 操作它：
-
File.Copy(@"\srvFSDataDocuments eport.pdf", @"C: empcopy.pdf")—— 直接复制，自动同步进数据库 -
Directory.GetFiles(@"\srvFSDataDocuments", "*.txt")—— 列出所有 .txt 文件，返回的是完整 UNC 路径 - 新建文件：
File.WriteAllText(@"\srvFSDataDocuments ote.txt", "hello")，立刻出现在 FileTable 表里，stream_id和file_stream列自动填充 - 注意权限：运行 C# 程序的 Windows 账户必须对这个共享有读/写权限（不是 SQL 登录权限）
用 SqlConnection 查询 FileTable 元数据时别碰 file_stream 列
FileTable 是一张带系统列的特殊表，包含 name、file_type、creation_time、file_stream（varbinary(max) FILESTREAM）等列。查询元数据没问题，但直接 SELECT file_stream 会触发大对象加载，性能极差且容易超时。
- 安全查元数据：
SELECT name, file_type, length, creation_time FROM dbo.Documents WHERE is_directory = 0
- 绝对避免：
SELECT name, file_stream FROM dbo.Documents—— 即使加了TOP 1，也会把整个二进制内容拉进内存 - 真要读文件内容？走 UNC 路径 +
FileStream或File.ReadAllBytes，比从 SQL 拉快一个数量级 - 更新元数据（比如改名）可用 T-SQL：
UPDATE dbo.Documents SET name = 'new.pdf' WHERE stream_id = @id，SQL Server 自动同步到文件系统视图
FileTable 路径映射不稳定？检查 SQL Server 的 GET_FILESTREAM_PATH() 和共享名
开发时硬编码 UNC 路径（如 \localhostFSDataDocs）在部署后常失效：服务器名变了、共享名拼错了、防火墙挡了 445 端口，都会导致 DirectoryNotFoundException。
- 运行时动态获取路径更可靠：
SELECT GET_FILESTREAM_PATH() + 'Docs'
返回类似\SQLSERVER2019FSShareDocs的字符串，再拼进 C# 路径 - 确保客户端能解析服务器名：如果用 IP 或别名，确认 DNS 或 hosts 文件已配好；域环境注意 Kerberos 约束（SPN 配置不当会导致“拒绝访问”）
- 测试连通性最简单方式：
net use X: \servershare，成功后再让 C# 访问X:...或直接 UNC
FileTable 的“文件即数据”体验很直观，但它的稳定性完全系于 Windows 文件共享层——SQL 查询只是配角，UNC I/O 才是主线。路径、权限、网络这三项任一出问题，整个访问链就断了，而且错误提示往往模糊（比如只报“找不到路径”，实际是权限不足）。
