FileTableRootPath (Transact-SQL)

發行項
08/21/2023

適用於：SQL Server

傳回特定 FileTable 或目前資料庫的根層級 UNC 路徑。

語法

  
FileTableRootPath ( [ '[schema_name.]FileTable_name' ], @option )

引數

FileTable_name
FileTable 的名稱。 FileTable_name的類型 為 Nvarchar 。這是選擇性參數。預設值為目前的資料庫。指定 schema_name 也是選擇性的。您可以傳遞 Null 給 FileTable_name 以使用預設參數值

@option
整數運算式，定義路徑的伺服器元件應該如何格式化。 @option 可以有下列其中一個值：

值	描述
0	傳回轉換成 NetBIOS 格式的伺服器名稱，例如： `\\SERVERNAME\MSSQLSERVER\MyDocumentDatabase` 這是預設值。
1	傳回伺服器名稱而不轉換，例如： `\\ServerName\MSSQLSERVER\MyDocumentDatabase`
2	傳回完整的伺服器路徑，例如： `\\ServerName.MyDomain.com\MSSQLSERVER\MyDocumentDatabase`

傳回類型

nvarchar(4000)

當資料庫屬於 Always On 可用性群組時， FileTableRootPath 函式會傳回虛擬網路名稱（VNN），而不是電腦名稱稱。

一般備註

當下列其中一個條件成立時，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');

另請參閱

使用 FileTable 中的目錄與路徑