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 em uma FileTable.

O valor do nome da coluna 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 Esse é 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 SQL Server estiver clusterizado em um cluster de failover, o nome do computador retornado como parte desse caminho será o nome do host virtual da instância clusterizado.

Quando o banco de dados pertence a um grupo de disponibilidade Always On, a função FileTableRootPath retorna o nome da rede virtual (VNN) 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 é traduzido para o caminho físico pelo driver de filtro do sistema de arquivos FILESTREAM e pelo agente FILESTREAM. Essa separação entre o caminho lógico e o caminho físico permite que SQL Server reorganizar 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 para 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 uma 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';  

Consulte Também

Trabalhar com diretórios e caminhos em FileTables