GetFileNamespacePath (Transact-SQL)
适用于：
SQL Server
返回 FileTable 中文件或目录的 UNC 路径。
语法
<column-name>.GetFileNamespacePath(is_full_path, @option)
参数
column-name
FILETable 中 VARBINARY（MAX） 的列名file_stream 列。
列名值必须是有效的列名。 它不能是表达式，也不能是从其他数据类型的列转换或强制转换的值。
is_full_path
整数表达式，指定是返回相对路径还是绝对路径。 is_full_path可以具有以下值之一：
| 值 | 说明 |
|---|---|
| 0 | 返回数据库级目录内的相对路径。 此为默认值。 |
| 1 | 返回以 \\computer_name 开头的完整 UNC 路径。 |
@option
一个整数表达式，定义路径的服务器组件应如何进行格式化。 @option可以具有以下值之一：
| 值 | 说明 |
|---|---|
| 0 | 返回转换为 NetBIOS 格式的服务器名称，例如：\\SERVERNAME\MSSQLSERVER\MyDocumentDatabase这是默认值。 |
| 1 | 返回未经转换的服务器名称，例如：\\ServerName\MSSQLSERVER\MyDocumentDatabase |
| 2 | 返回完整的服务器路径，例如：\\ServerName.MyDomain.com\MSSQLSERVER\MyDocumentDatabase |
返回类型
nvarchar(max)
如果 SQL Server 实例在故障转移群集中聚集，则作为此路径的一部分返回的计算机名称是群集实例的虚拟主机名。
当数据库属于 AlwaysOn 可用性组时， FileTableRootPath 函数将返回虚拟网络名称（VNN），而不是计算机名称。
一般备注
GetFileNamespacePath 函数返回的路径是采用以下格式的逻辑目录或文件路径：
\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\...
此逻辑路径不直接对应于某一物理 NTFS 路径。 它由 FILESTREAM 的文件系统筛选器驱动程序和 FILESTREAM 代理转换为物理路径。 逻辑路径和物理路径之间的这种分离使 SQL Server 能够在内部重新组织数据，而不会影响路径的有效性。
最佳方案
若要使代码和应用程序独立于当前的计算机和数据库，应避免编写依赖于绝对文件路径的代码。 相反，使用 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';
注解
示例
以下示例演示如何调用 GetFileNamespacePath 函数以获取 FileTable 中文件或目录的 UNC 路径。
-- returns the relative path of the form "\MyFileTable\MyDocDirectory\document.docx"
SELECT file_stream.GetFileNamespacePath() AS FilePath FROM DocumentStore
WHERE Name = N'document.docx';
-- returns "\\MyServer\MSSQLSERVER\MyDocumentDatabase\MyFileTable\MyDocDirectory\document.docx"
SELECT file_stream.GetFileNamespacePath(1, Null) AS FilePath FROM DocumentStore
WHERE Name = N'document.docx';