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\MyDocumentDatabase

Este é 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';  

Confira também

Work with Directories and Paths in FileTables