GetFileNamespacePath (Transact-SQL)
Aplica-se a: 
SQL Server
Retorna o caminho UNC de um arquivo ou diretório em uma FileTable.
Sintaxe
<column-name>.GetFileNamespacePath(is_full_path, @option)
Argumentos
nome da coluna
O nome da coluna VARBINARY(MAX) file_stream coluna em uma FileTable.
O valor column-name deve ser um nome de coluna válido. Não pode ser uma expressão ou um valor convertido de uma coluna de outro tipo de dados.
is_full_path
Uma expressão de inteiro que especifica se um caminho relativo ou absoluto deve ser retornado. is_full_path pode ter um dos seguintes valores:
| Valor | Descrição |
|---|---|
| 0 | Retorna o caminho relativo dentro do diretório no nível do banco de dados. Esse é o valor padrão. |
| 1 | Retorna o caminho UNC completo, a partir do \\computer_name. |
@option
Uma expressão de inteiro que define como o componente do servidor do caminho deve ser formatado. @option pode ter um dos seguintes valores:
| Valor | Descrição |
|---|---|
| 0 | Retorna o nome do servidor convertido no formato NetBIOS, por exemplo:\\SERVERNAME\MSSQLSERVER\MyDocumentDatabaseEste é o valor padrão. |
| 1 | Retorna o nome do servidor sem conversão, por exemplo:\\ServerName\MSSQLSERVER\MyDocumentDatabase |
| 2 | Retorna o caminho completo do servidor, por exemplo:\\ServerName.MyDomain.com\MSSQLSERVER\MyDocumentDatabase |
Tipo de retorno
nvarchar(max)
Se a instância do SQL Server estiver clusterizada em um cluster de failover, o nome do computador retornado como parte desse caminho será o nome do host virtual da instância clusterizada.
Quando o banco de dados pertence a um grupo de disponibilidade Always On, a função FileTableRootPath retorna o VNN (nome da rede virtual) em vez do nome do computador.
Comentários gerais
O caminho que a função GetFileNamespacePath retorna é um diretório lógico ou caminho de arquivo no seguinte formato:
\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\...
Esse caminho lógico não corresponde diretamente a um caminho NTFS físico. Ele é convertido para o caminho físico pelo driver de filtro do sistema de arquivos do FILESTREAM e pelo agente FILESTREAM. Essa separação entre o caminho lógico e o caminho físico permite que o SQL Server reorganize os dados internamente sem afetar a validade do caminho.
Práticas Recomendadas
Para manter código e aplicativos independentes do computador e do banco de dados atuais, evite escrever código baseado em caminhos de arquivo absolutos. Em vez disso, obtenha o caminho completo de um arquivo em tempo de execução usando as funções FileTableRootPath e GetFileNamespacePath juntas, conforme mostrado no exemplo a seguir. Por padrão, a função GetFileNamespacePath retorna o caminho relativo do arquivo sob o caminho raiz do banco de dados.
USE MyDocumentDatabase;
@root varchar(100)
SELECT @root = FileTableRootPath();
@fullPath = varchar(1000);
SELECT @fullPath = @root + file_stream.GetFileNamespacePath() FROM DocumentStore
WHERE Name = N'document.docx';
Comentários
Exemplos
Os exemplos a seguir mostram como chamar a função GetFileNamespacePath para obter o caminho UNC para um arquivo ou diretório em um FileTable.
-- 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';