SQL Server 2012 FileTable 文件表

Posted 2020-09-22

SQL Server 2012 提供一种特殊的“文件表”，也称为“FileTable”。 FileTable 是一种专用的用户表，它包含存储 FILESTREAM 数据的预定义架构以及文件和目录层次结构信息、文件属性。FileTable 功能为 SQL Server 中存储的文件数据提供对 Windows 文件命名空间的支持以及与 Windows 应用程序的兼容性支持。即可以在 SQL Server 中将文件和文档存储在称作 FileTable 的特别的表中，但是从 Windows 应用程序访问它们，就好像它们存储在文件系统中，而不必对客户端应用程序进行任何更改。

 

在实例级别启用 FILESTREAM：（参考 启用和配置 FILESTREAM ）

右键SQLserver服务——属性——FILESTREAM ——勾选——重启服务

 

更改此 SQL Server 实例的 FILESTREAM 访问级别 ：（参考 filestream access level 服务器配置选项）

exec sp_configure N‘filestream access level‘ ,2
reconfigure with override

可能需要配置将防火墙配置为进行 FILESTREAM 访问。

 

数据库级别创建 FILESTREAM 文件组：

数据库必须首先具有 FILESTREAM 文件组，然后您才能在该数据库中创建 FileTable。

--    创建数据库时创建 FILESTREAM 文件组
CREATE DATABASE FileStreamDB 
ON
PRIMARY ( 
    NAME = FileStreamDB, 
    FILENAME = ‘G:\\database\\FileStreamDB.mdf‘,
    SIZE = 5MB,
    MAXSIZE = 25MB,
    FILEGROWTH = 5MB
),
FILEGROUP FileStreamGroup CONTAINS FILESTREAM(
     NAME = FileStreamFile, 
     FILENAME = ‘G:\\database\\FileStreamFile‘,
     MAXSIZE = 50 MB
)
LOG ON (
    NAME = FileStreamDB_log,
    FILENAME = ‘G:\\database\\FileStreamDB_log.ldf‘
)
WITH FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N‘FileStreamPath‘ )
GO

--    或者在当前数据库中添加 FILESTREAM 文件组
ALTER DATABASE [AdventureWorks2012]
ADD FILEGROUP FileStreamGroup CONTAINS FILESTREAM;


ALTER DATABASE [AdventureWorks2012]
ADD FILE
(
     NAME = FileStreamFile, 
     FILENAME = ‘G:\\database\\FileStreamFile‘,
     MAXSIZE = 50 MB
)
TO FILEGROUP FileStreamGroup
GO

创建文件时 filename 只指定目录，并且目录 FileStreamFile 在文件系统不存在，创建后会自动生成该目录文件夹

 

在数据库级别上指定 非事务性访问级别 和 FileTable目录(数据库须独占):

--    在数据库级别上指定 非事务性访问级别 和 FileTable目录(数据库须独占)
ALTER DATABASE [AdventureWorks2012]
SET FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N‘FileStreamPath‘ )

--    启用后即可查看到其状态信息
SELECT DB_NAME(database_id) [database],non_transacted_access, non_transacted_access_desc
FROM sys.database_filestream_options
WHERE non_transacted_access_desc <> ‘OFF‘

SELECT DB_NAME(database_id) [database],directory_name 
FROM sys.database_filestream_options 
WHERE directory_name IS NOT NULL

将新表创建为 FileTable :（参考 CREATE TABLE (Transact-SQL) ）

USE [AdventureWorks2012]
GO
CREATE TABLE [DocumentStore] 
AS FileTable
WITH ( 
    --文件目录,不区分大小写,不指定则为filetable名称[DocumentStore]
    FileTable_Directory = N‘FileStreamPath‘,
    FileTable_Collate_Filename = database_default    --排序规则
);
GO

--    更改目录
ALTER TABLE [DocumentStore]
    SET ( FILETABLE_DIRECTORY = N‘FileStreamPath‘ );
GO

每个目录创建都会在文件系统中生成一个文件夹：

 

 

相关查询:（FileTable 架构）

--    查看 FileTable 信息
SELECT * FROM sys.filetables;
SELECT * FROM sys.tables WHERE is_filetable = 1;

--    FileTable 的相关对象
SELECT parent_object_id,OBJECT_NAME(parent_object_id) AS ‘FileTable‘
,object_id,OBJECT_NAME(object_id) AS ‘System-defined Object‘
FROM sys.filetable_system_defined_objects
ORDER BY FileTable, ‘System-defined Object‘;

至此，已经配置完成！~

 

现在查看文件表，没有记录。可以查看该表的 UNC 路径，在系统文件中打开该路径。

--    查看 FileTable
SELECT * FROM [dbo].[DocumentStore]

--    获取特定 FileTable 或当前数据库的根级 UNC 路径。
SELECT FileTableRootPath();
SELECT FileTableRootPath(N‘DocumentStore‘);
SELECT FileTableRootPath(N‘dbo.DocumentStore‘);

在该路径中，可以直接将系统其它文件拷贝进去：

再查看 FileTable ，数据已经自动记录

--    查看 FileTable
SELECT * FROM [dbo].[DocumentStore]

--    也可以用GetFileNamespacePath查看 FileTable 中文件或目录的 UNC 路径。
SELECT 
 file_stream.GetFileNamespacePath()
,file_stream.GetFileNamespacePath(1, 0)
FROM [dbo].[DocumentStore]

删除表 FileTable 中的记录，文件也会被删除：

--    删除表 FileTable 中的记录，文件也会被删除
DELETE FROM [dbo].[DocumentStore] WHERE stream_id = ‘BA483ECA-AE0E-E511-8367-005056C00008‘

SELECT * FROM [dbo].[DocumentStore]

若要获取执行某些管理任务所需的独占访问权限，可能必须暂时禁用非事务性访问权限。

禁用完全非事务性访问权限：

ALTER DATABASE [AdventureWorks2012]
    SET FILESTREAM ( NON_TRANSACTED_ACCESS = OFF );
GO
--    关闭后,路径无法打开
--    \\\\Kk-pc\\mssqlserver\\FileStreamPath\\FileStreamPath
--    此时文件表 [DocumentStore] 仍可正常操作


ALTER DATABASE [AdventureWorks2012]
    SET FILESTREAM ( NON_TRANSACTED_ACCESS = READ_ONLY );
GO
--    只读状态,路径可拷贝文件出来,但无法拷贝文件到该目录
--    \\\\Kk-pc\\mssqlserver\\FileStreamPath\\FileStreamPath
--    此时文件表 [DocumentStore] 仍可正常操作

重新启用完全非事务性访问权限：

--    重新启用完全非事务性访问权限
ALTER DATABASE [AdventureWorks2012]
    SET FILESTREAM ( NON_TRANSACTED_ACCESS = FULL );
GO

 

 禁用 FileTable 命名空间将会禁用所有系统定义的约束并触发使用 FileTable 创建的约束。

--    禁用 FileTable 命名空间
--    (禁用后路径 \\\\Kk-pc\\mssqlserver\\FileStreamPath\\FileStreamPath 不可访问)
ALTER TABLE [DocumentStore] DISABLE FILETABLE_NAMESPACE;
GO

 

--    重新启用 FileTable 命名空间
ALTER TABLE [DocumentStore] ENABLE FILETABLE_NAMESPACE;
GO

 

 更多注意的事情还需要到参考官方文档：FileTable 与其他 SQL Server 功能的兼容性

更多参考：FileTable (SQL Server)