FileTableRootPath (Transact-SQL)
适用范围：
SQL Server
返回特定 FileTable 或当前数据库的根级 UNC 路径。
语法
FileTableRootPath ( [ '[schema_name.]FileTable_name' ], @option )
参数
FileTable_name
FileTable 的名称。 FileTable_name的类型为 nvarchar。 这是一个可选参数。 默认值为当前数据库。 指定 schema_name 也是可选的。 可以为 FileTable_name 传递 NULL 以使用默认参数值
@option
一个整数表达式，定义路径的服务器组件应如何进行格式化。 @option可以具有以下值之一：
| 值 | 说明 |
|---|---|
| 0 | 返回转换为 NetBIOS 格式的服务器名称，例如：\\SERVERNAME\MSSQLSERVER\MyDocumentDatabase这是默认值。 |
| 1 | 返回未经转换的服务器名称，例如：\\ServerName\MSSQLSERVER\MyDocumentDatabase |
| 2 | 返回完整的服务器路径，例如：\\ServerName.MyDomain.com\MSSQLSERVER\MyDocumentDatabase |
返回类型
nvarchar(4000)
当数据库属于 AlwaysOn 可用性组时， FileTableRootPath 函数将返回虚拟网络名称（VNN），而不是计算机名称。
一般备注
如果以下条件之一为 true，则 FileTableRootPath 函数返回 NULL：
FileTable_name的值无效。
调用方没有足够的权限引用指定表或当前数据库。
未为当前数据库设置database_directory的 FILESTREAM 选项。
有关详细信息，请参阅 Work with Directories and Paths in FileTables。
最佳方案
若要使代码和应用程序独立于当前的计算机和数据库，应避免编写依赖于绝对文件路径的代码。 相反，使用 FileTableRootPath 和 GetFileNamespacePath 函数在运行时获取文件的完整路径，如以下示例所示。 默认情况下， GetFileNamespacePath 函数返回数据库根路径下的文件的相对路径。
USE MyDocumentDatabase;
@root varchar(100)
SELECT @root = FileTableRootPath();
@fullPath = varchar(1000);
SELECT @fullPath = @root + file_stream.GetFileNamespacePath()
FROM DocumentStore
WHERE Name = N'document.docx';
安全性
权限
FileTableRootPath 函数需要：
拥有 FileTable 的 SELECT 权限以获取特定 FileTable 的根路径。
db_datareader或更高权限以获取当前数据库的根路径。
示例
以下示例演示如何调用 FileTableRootPath 函数。
USE MyDocumentDatabase;
-- returns "\\MYSERVER\MSSQLSERVER\MyDocumentDatabase"
SELECT FileTableRootPath();
-- returns "\\MYSERVER\MSSQLSERVER\MyDocumentDatabase\MyFileTable"
SELECT FileTableRootPath(N'dbo.MyFileTable');
-- returns "\\MYSERVER\MSSQLSERVER\MyDocumentDatabase\MyFileTable"
SELECT FileTableRootPath(N'MyFileTable');