Work with Directories and Paths in FileTables

项目
06/13/2017

说明 FileTable 中用于存储文件的目录结构。

如何在 FileTable 中使用目录和路径

可以使用以下 3 个函数在 Transact-SQL 中使用 FileTable 目录：

为得到这一结果	使用此函数
获取特定 FileTable 或当前数据库的根级 UNC 路径。	FileTableRootPath (Transact-SQL)
获取 FileTable 中文件或目录的绝对或相对 UNC 路径。	GetFileNamespacePath (Transact-SQL)
通过提供路径，获取 FileTable 中指定文件或目录的路径定位器 ID 值。	GetPathLocator (Transact-SQL)

如何使用相对路径编写可移植代码

若要使代码和应用程序独立于当前的计算机和数据库，应避免编写依赖于绝对文件路径的代码。可通过使用 FileTableRootPath (Transact-SQL) 和 GetFileNamespacePath (Transact-SQL) 函数组合在运行时获取文件的完整路径，如下例所示。默认情况下，GetFileNamespacePath 函数返回数据库根路径下的文件的相对路径。

USE database_name;  
DECLARE @root nvarchar(100);  
DECLARE @fullpath nvarchar(1000);  
  
SELECT @root = FileTableRootPath();  
SELECT @fullpath = @root + file_stream.GetFileNamespacePath()  
    FROM filetable_name  
    WHERE name = N'document_name';  
  
PRINT @fullpath;  
GO

重要限制

嵌套级别

重要

您不能在 FileTable 目录中存储超过 15 个级别的子目录。在您存储 15 个级别的子目录时，最下面的一级不能包含文件，因为这些文件将代表另外一个级别。

完整路径名的长度

重要

NTFS 文件系统支持远远超过 Windows 外壳程序和大多数 Windows API 的 260 个字符限制的路径名。因此，使用 Transact-SQL 在 FileTable 的文件层次结构中创建的文件有可能无法使用 Windows 资源管理器或很多其他 Windows 应用程序查看或打开，原因是这些文件的完整路径名称超过了 260 个字符。但是，您可使用 Transact-SQL 继续访问这些文件。

FileTable 中存储的项的完整路径

FileTable 中存储的文件或目录的完整路径用以下元素开头：

为在 SQL Server 实例级别进行 FILESTREAM 文件 I/O 访问启用的共享区。
在数据库级别指定的 DIRECTORY_NAME 。
在 FileTable 级别指定的 FILETABLE_DIRECTORY 。

生成的层次结构如下所示：

\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\

此目录层次结构构成了 FileTable 的文件命名空间的根。在此目录层次结构下，FileTable 的 FILESTREAM 数据作为文件存储，并且存储为也包含文件和子目录的子目录。

请务必记住，在此实例级别 FILESTREAM 共享区下创建的目录层次结构是虚拟目录层次结构。该层次结构存储于 SQL Server 数据库中，并且在物理上不在 NTFS 文件系统中表示。访问 FILESTREAM 共享区之下及其包含的 FileTable 中的文件和目录的所有操作，都将被文件系统中嵌入的 SQL Server 组件拦截和处理。

实例级、数据库级和 FileTable 级根目录的语义

此目录层次结构遵循下面的语义：

实例级别 FILESTREAM 共享区由管理员配置并且存储为服务器的属性。可以通过使用 SQL Server 配置管理器重命名该共享区。在重新启动服务器之前，重命名操作将不会生效。
在创建新的数据库时，数据库级别 DIRECTORY_NAME 默认为 Null。管理员可以通过使用 ALTER DATABASE 语句设置或更改此名称。此名称在该实例中必须唯一（不区分大小写比较时）。
在创建 FileTable 时，通常提供 FILETABLE_DIRECTORY 名称作为 CREATE TABLE 语句的一部分。您可以通过使用 ALTER TABLE 命令来更改此名称。
不能通过文件 I/O 操作来重命名这些根目录。
不能使用独占式文件句柄打开这些根目录。

FileTable 架构中的 is_directory 列

下表说明 is_directory 列与包含 FileTable 中 FILESTREAM 数据的 file_stream 列之间的相互影响：


is_directory value	file_stream value	行为
FALSE	Null	这是将被系统定义的约束捕获的无效组合。
FALSE	<value>	该项表示一个文件。
TRUE	Null	该项表示一个目录。
TRUE	<value>	这是将被系统定义的约束捕获的无效组合。

将虚拟网络名称 (VNN) 用于 AlwaysOn 可用性组

在包含 FILESTREAM 或 FileTable 数据的数据库属于某一 AlwaysOn 可用性组时：

FILESTREAM 和 FileTable 函数接受或返回虚拟网络名称 (VNN)，而非计算机名称。有关这些函数的详细信息，请参阅 Filestream 和 FileTable 函数 (Transact-SQL)。
通过文件系统 API 对 FILESTREAM 或 FileTable 数据进行的所有访问都应该使用 VNN，而非计算机名称。有关详细信息，请参阅具有 AlwaysOn 可用性组的 FILESTREAM 和 FileTable（SQL Server）。

另请参阅

启用 FileTable 的先决条件
 创建、更改和删除 FileTable
使用 Transact-SQL 访问 FileTable
使用文件输入输出 API 访问 FileTable

通过