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:
O compartilhamento habilitado para acesso de E/S de arquivos FILESTREAM no nível da instância do SQL Server.
O
DIRECTORY_NAME
especificado no nível do banco de dados.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çãoALTER 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çãoCREATE TABLE
quando você cria uma FileTable. Você pode alterar esse nome usando o comandoALTER 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:
As funções FILESTREAM e FileTable aceitam ou retornam VNNs (nomes de rede virtual) em vez de nomes de computadores. veja mais informações sobre essas funções em FILESTREAM e FileTable (Transact-SQL).
Todo o acesso aos dados FILESTREAM ou FileTable pelas APIs do sistema de arquivos deve usar VNNs em vez de nomes de computadores. Para obter mais informações, consulte FILESTREAM e FileTable com Grupos de Disponibilidade AlwaysOn (SQL Server).