FileTable的创建和使用

1. 首先要在实例级别启用FILESTREAM，打开Sql Server Configuration Manager窗口，双击需要设置的SQL SERVER实例进行设置。

 

2. 需要更改 SQL SERVER 实例的 FILESTREAM 访问级别，执行以下代码，并重启 SQL SERVER 服务：

EXEC sp_configure filestream_access_level, 2 
RECONFIGURE
GO

参数定义如下：

 

3. 有可能需要防火墙配置为进行 FILESTREAM 访问，若要在防火墙保护的环境中使用 FILESTREAM，客户端和服务器都必须能够将 DNS 名称解析为包含 FILESTREAM 文件的服务器。FILESTREAM 要求 Windows 文件共享端口 139 和 445 处于打开状态。

 

4. 以上都准备好了后就可以在创建数据库时创建 FILESTREAM 文件组了，执行以下代码：

--    创建数据库时创建 FILESTREAM 文件组
CREATE DATABASE Archive 
ON
PRIMARY ( 
    NAME = ArchiveMDF, 
    FILENAME = 'D:\DataBase\ZL\Archive\archdat.mdf',     -- D:\DataBase\ZL\Archive路径必须存在
    SIZE = 5MB,
    MAXSIZE = 25MB,
    FILEGROWTH = 5MB
),
FILEGROUP FileStreamGroupFirst CONTAINS FILESTREAM(
     NAME = ArchiveFILESTREAM, 
     FILENAME = 'D:\DataBase\ZL\Archive\MyFileStream',   -- D:\DataBase\ZL\Archive路径下MyFileStream文件夹必须不存在
     MAXSIZE = 50 MB
)
LOG ON (
    NAME = ArchiveLDF,
    FILENAME = 'D:\DataBase\ZL\Archive\archlog.ldf'
)
WITH FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'MyDirectory' ) -- 指定数据库访问级别和指定目录名字
GO

WITH FILESTREAM() 选项是用来指定对数据库的非事务性FILESTREAM访问的级别，说明如下：

 

执行成功后在目录里就生成了 FILESTREAM 文件夹。

 

当然也可以为已存在的数据库添加 FILESTREAM 文件组，代码如下：

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

ALTER DATABASE zl_test
ADD FILE
(
     NAME = FileStreamFile, 
     FILENAME = 'D:\DataBase\ZL\zl_test\MyFileStream',
     MAXSIZE = 50 MB
)
TO FILEGROUP FileStreamGroup
GO

 

如果在创建数据库时没有用 WITH FILESTREAM 语句来指定非事务性访问级别，可以在之后单独用语句来进行，比如：

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

注意，执行以上语句必须没有其他进程连接到被操作数据库上才能成功，否则将无限等待直至其他连接断开。可以用下面的语句查看所有连接到该数据库上的进程：

select * from master..sysprocesses where dbid=db_id('zl_test')

然后结束其他进程即可：

kill 56

 用下面的语句可以查看当前实例中哪些数据库已经设置了非事务性访问级别，和FileTable目录名：

--    启用后即可查看到其状态信息
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

返回结果如下：

 

5. 在新建的 Archive 数据库中创建 FileTable，语句如下：

--  创建FILETABLE
USE Archive
GO
CREATE TABLE [FileStore] 
AS FileTable
WITH ( 
    --文件目录,不区分大小写,不指定则默认为filetable名称[FileStore]
    FileTable_Directory = N'FileStore_Dev',
    FileTable_Collate_Filename = database_default    --排序规则
)
GO

执行成功后在对象浏览器中可以看到

 

FileTable 是专用的用户表，它具有预定义的固定架构。 此架构存储 FILESTREAM 数据、文件和目录信息以及文件属性。由于FileTable有固定的结构，所以不必指定字段名。创建FileTable的简单语法可以指定以下设置：

　　1). FILETABLE_DIRECTORY。指定充当存储在 FileTable 中的所有文件和目录的根目录的目录。 此名称应在数据库的所有 FileTable 目录名称中唯一。 无论当前排序规则设置如何，唯一性比较都不区分大小写。如果创建 FileTable 时没有提供目录名称，则 FileTable 自身的名称将用作目录名称。

　　2). FILETABLE_COLLATE_FILENAME。指定要应用于 FileTable 的“名称”列的排序规则名称。如果未提供 FILETABLE_COLLATE_FILENAME 的值，或指定了 database_default，则该列继承当前数据库的排序规则。 如果当前数据库排序规则区分大小写，将引发错误，CREATE TABLE 操作将失败。

　　3). 还可以指定要用于三个主键的名称和自动创建的唯一约束。 如果不提供名称，则系统会生成名称

　　　　a. FILETABLE_PRIMARY_KEY_CONSTRAINT_NAME

　　　　b. FILETABLE_STREAMID_UNIQUE_CONSTRAINT_NAME

　　　　c. FILETABLE_FULLPATH_UNIQUE_CONSTRAINT_NAME

也可以用语句来更改FileTable的目录，比如:

ALTER TABLE dbo.FileStore
    SET ( FILETABLE_DIRECTORY = N'FileStore_Pro' )

 右击创建好的FileTable，选择Explore FileTable Directory，可以在文件系统中打开FileTable的目录，现在目录里是空的，

红线划起来的就是前面创建数据库时 WITH FILESTREAM 语句中指定的DIRECTORY_NAME值

WITH FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'MyDirectory' )，由于一个实例中可能有多个数据库都有FileTable，所以这个值必须唯一。

蓝线划起来的就是上面创建FileTable时 WITH() 选项中指定的值

FileTable_Directory = N'FileStore_Dev'，由于在一个数据库中可能存在多个FileTable，所以这个值在同一个数据库中必须唯一，但不同的数据库中可以相同。

往目录里存放一些文件或文件夹，

 

查询FileTable表，看见表中已经产生了对应的数据。

 

 在目录中删掉某些文件则表中也会相应自动的删掉某些数据，同样在表中删掉某些数据，则目录中也会相应自动的删掉某些文件。

 

6. 可以用下图的语句获取特定 FileTable 或当前数据库的根级 UNC 路径：

-- returns “\\SZSAUDIT\MSSQLSERVER\MyDirectory”
SELECT FileTableRootPath();

-- returns “\\SZSAUDIT\MSSQLSERVER\MyDirectory\FileStore”
SELECT FileTableRootPath(N'dbo.FileStore');

返回的结果，

 

可以用下面的语句返回FileTable中指定的文件或目录Locator ID值。

select GetPathLocator(FileTableRootPath('[dbo].[FileStore]')+'\ASRData.pdf')
select GetPathLocator('\\Szsaudit\mssqlserver\MyDirectory\FileStore\ASRData.pdf')

 

7. 下面是一些关于创建和操作FileTable的其他说明，详见MSDN。

　　1）.不能更改现有表以将其转换为 FileTable。

　　2）.先前在数据库级别指定的父目录还必须具有非 Null 值。

　　3）.由于一个FileTable 包含一个 FILESTREAM 列，因此，FileTable 需要有效的 FILESTREAM 文件组。 可以指定有效的 FILESTREAM 文件组作为 CREATE TABLE 命令的一部分以创建 FileTable（可选）。 如果未指定文件组，则 FileTable 使用数据库的默认 FILESTREAM 文件组。 如果数据库没有 FILESTREAM 文件组，将引发错误。

　　4）.不能将表约束作为 CREATE TABLE…AS FILETABLE 语句的一部分创建。 但是以后可以使用 ALTER TABLE 语句添加该约束。

　　5）.不能在 tempdb 数据库或任何其他系统数据库中创建 FileTable。

不能将 FileTable 作为临时表创建。

　　6）.不能更改FILETABLE_COLLATE_FILENAME的值。

　　7）.不能更改，删除或禁用FileTable的系统定义的列。不能将新的用户列、计算列或持久化计算列添加到 FileTable。

　　8）.删除FileTable时，将删除 FileTable 的所有列以及与该表关联的所有对象，如索引、约束和触发器。

　　9）.删除FileTable时，FileTable 目录及其子目录将从数据库的 FILESTREAM 文件和目录层次结构中消失。

　　10）.FileTable上的INSERT操作

　　　　a.所有文件属性列具有 NOT NULL 约束。如果没有显式设置值，则提供适当的默认值。

　　　　b.如果 INSERT 语句设置了 name、path_locator、parent_path_locator 或文件属性，则强制执行系统定义的约束。

　　　　c.该应用程序可以通过提供指向 GetPathLocator 函数的系统文件路径，来获取文件或目录的 path_locator。

　　11）.FileTable上的UPDATE操作

　　　　a.允许更新任何用户定义的数据。

　　　　b.如果 INSERT 语句设置了 name、path_locator、parent_path_locator 或文件属性，则强制执行系统定义的约束。

　　　　c.可以对 file_stream 列中的 FILESTREAM 数据进行更新，且不会影响任何其他列（包括时间戳）。

　　12）.FileTable上的DELETE操作

　　　　a.删除行还将从文件系统中删除相应的文件或目录。

　　　　b.如果该行与包含其他文件或目录的目录相对应，则删除行操作将失败。

　　13）.FileTable不支持分区。通过对多个FILESTREAM文件组的支持，在大多数方案中可以解决纯向上扩展问题，而不必使用分区。

　　14）.FileTable不支持复制和相关功能，包括事务复制，合并复制，更改数据捕获和更改跟踪。

建议创建FileTable所在的数据库最好不要是现有的业务数据库，新建一个数据库来单独创建FileTable比较好。