Compartilhar via


Trabalhar com diretórios e caminhos em FileTables

Aplica-se a: SQL Server

Descreve a estrutura de diretórios na qual os arquivos são armazenados em FileTables.

Como trabalhar com diretórios e caminhos em FileTables

É possível usar as três funções a seguir para trabalhar com diretórios de FileTable no Transact-SQL:

Para obter este resultado Use esta função
Obtém o caminho UNC no nível raiz de uma FileTable específica ou do banco de dados atual. FileTableRootPath (Transact-SQL)
Obtém um caminho UNC absoluto ou relativo de um arquivo ou diretório em uma FileTable. GetFileNamespacePath (Transact-SQL)
Obtém a ID do localizador do caminho do arquivo ou diretório especificado em uma FileTable, fornecendo o caminho. GetPathLocator (Transact-SQL)

Usar caminhos relativos para código portável

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 (Transact-SQL) e GetFileNamespacePath (Transact-SQL) 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 database_name;

DECLARE @root NVARCHAR(100);
DECLARE @fullpath NVARCHAR(1000);

SELECT @root = FileTableRootPath();

SELECT @fullpath = @root + file_stream.GetFileNamespacePath()
FROM filetable_name
WHERE name = N'document_name';

PRINT @fullpath;
GO

Limitações

Nível de aninhamento

Importante

Você não pode armazenar mais de 15 níveis de subdiretórios no diretório FileTable. Quando você armazenar 15 níveis de subdiretórios, o nível mais baixo não poderá conter arquivos, pois esses arquivos representariam um nível adicional.

Comprimento do nome do caminho completo

Importante

O sistema de arquivos NTFS oferece suporte a nomes do caminho maiores do que o limite de 260 caracteres do shell do Windows e da maioria das APIs do Windows. Portanto, é possível criar arquivos na hierarquia de arquivos de um FileTable usando Transact-SQL que você não poderá exibir ou abrir com o Windows Explorer ou com muitos outros aplicativos do Windows, porque o nome do caminho completo excede 260 caracteres. Entretanto, é possível continuar a acessar esses arquivos usando o Transact-SQL.

O caminho completo para um item armazenado em uma FileTable

O caminho completo para um arquivo ou diretório armazenado em uma FileTable começa com os seguintes elementos:

  1. O compartilhamento habilitado para acesso de E/S de arquivos FILESTREAM no nível da instância do SQL Server.

  2. O DIRECTORY_NAME especificado no nível do banco de dados.

  3. O FILETABLE_DIRECTORY especificado no nível FileTable.

A hierarquia resultante será semelhante a esta:

\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\

Essa hierarquia de diretórios forma a raiz de um namespace de arquivo da FileTable. Nessa hierarquia de diretórios, os dados FILESTREAM da FileTable são armazenados como arquivos e subdiretórios que também podem conter arquivos e subdiretórios.

É importante ter em mente que a hierarquia de diretórios criada sob o compartilhamento do FILESTREAM no nível da instância é uma hierarquia de diretórios virtuais. Essa hierarquia é armazenada no banco de dados SQL Server e não é representada fisicamente no sistema de arquivos NTFS. Todas as operações que acessam arquivos e diretórios sob o compartilhamento do FILESTREAM e nas FileTables são interceptadas e tratadas por um componente do SQL Server inserido no sistema de arquivos.

A semântica dos diretórios raiz nos níveis de instância, banco de dados e FileTable

Essa hierarquia de diretórios observa a seguinte semântica:

  • O compartilhamento do FILESTREAM do nível da instância é configurado por um administrador e armazenado como propriedade do servidor. Você pode renomear esse compartilhamento usando o SQL Server Configuration Manager. Uma operação de renomeação não tem efeito até que o servidor seja reiniciado.

  • O nível do banco de dados DIRECTORY_NAME é nulo por padrão quando você cria um novo banco de dados. Um administrador pode definir ou alterar esse nome usando a instrução ALTER DATABASE. O nome deve ser exclusivo (em uma comparação sem diferenciação de maiúsculas e minúsculas) nessa instância.

  • Normalmente, você fornece o nome FILETABLE_DIRECTORY como parte da instrução CREATE TABLE quando você cria uma FileTable. Você pode alterar esse nome usando o comando ALTER TABLE.

  • Você não pode renomear esses diretórios raiz por meio de operações de E/S de arquivos.

  • Você não pode abrir esses diretórios raiz com identificadores de arquivo exclusivos.

A coluna is_directory no esquema de FileTable

A tabela a seguir descreve a interação entre a coluna is_directory e a coluna file_stream que contém os dados de FILESTREAM em uma FileTable.

is_directory value file_stream value Comportamento
FALSE NULL Esta é uma combinação inválida que é capturada por uma restrição definida pelo sistema.
FALSE <value> O item representa um arquivo.
TRUE NULL O item representa um diretório.
TRUE <value> Esta é uma combinação inválida que é capturada por uma restrição definida pelo sistema.

Usando VNNs (nomes de rede virtual) com grupos de disponibilidade Always On

Quando o banco de dados que contém dados FILESTREAM ou FileTable pertence a um grupo de disponibilidade: