Criar, alterar e excluir FileTables

Descreve como criar uma nova FileTable ou alterar ou remover uma FileTable existente.

Criando uma FileTable

Uma FileTable é uma tabela de usuário especializada que tem um esquema predefinido e fixo. Esse esquema armazena dados FILESTREAM, informações de arquivo e diretório e atributos de arquivo. Para obter informações sobre o esquema FileTable, consulte FileTable Schema.

Você pode criar uma nova FileTable usando o Transact-SQL ou o SQL Server Management Studio. Como uma FileTable tem um esquema fixo, você não precisa especificar uma lista de colunas. A sintaxe simples para criar uma FileTable permite que você especifique:

• Um nome de diretório. Na hierarquia da pasta FileTable, esse diretório no nível da tabela torna-se o filho do diretório de banco de dados especificado no nível do banco de dados e o pai dos arquivos ou diretórios armazenados na tabela.

• O nome da ordenação a ser usada para os nomes de arquivo na coluna Name da FileTable.

• Os nomes a serem usados para a chave primária 3 e restrições exclusivas que são criadas automaticamente.

Como criar uma FileTable

Criar uma FileTable usando Transact-SQL
Crie uma FileTable chamando a instrução CREATE TABLE (Transact-SQL) com a opção AS FileTable . Como uma FileTable tem um esquema fixo, você não precisa especificar uma lista de colunas. Você pode especificar as seguintes configurações para a nova FileTable:

1. FILETABLE_DIRECTORY. Especifica o diretório que serve como o diretório raiz para todos os arquivos e diretórios armazenados na FileTable. Esse nome deve ser exclusivo entre todos os nomes de diretórios de FileTable no banco de dados. A comparação para unicidade não diferencia maiúsculas de minúsculas, independentemente das configurações de ordenação atuais.

   • Esse valor tem um tipo de dados nvarchar(255) e usa uma ordenação fixa de Latin1_General_CI_AS_KS_WS.

   • O nome do diretório que você fornece deve estar em conformidade com os requisitos do sistema de arquivos para um nome de diretório válido.

   • Esse nome deve ser exclusivo entre todos os nomes de diretórios de FileTable no banco de dados. A comparação de unicidade não distingue maiúsculas de minúsculas, independentemente das configurações de agrupamento atuais.

   • Se você não fornecer um nome de diretório ao criar a FileTable, o nome da própria FileTable será usado como o nome do diretório.

2. FILETABLE_COLLATE_FILENAME. Especifica o nome da ordenação a ser aplicada à coluna Name na FileTable.

   1. A ordenação especificada deve ser insensível a maiúsculas e minúsculas para estar em conformidade com a semântica de nomes de arquivos do Windows.

   2. Se você não fornecer um valor para FILETABLE_COLLATE_FILENAME ou especificar database_default, a coluna herdará a ordenação do banco de dados atual. Se a ordenação do banco de dados atual diferencia maiúsculas de minúsculas, um erro será gerado e a operação CREATE TABLE falhará.

3. Você também pode especificar os nomes a serem usados para a chave primária 3 e restrições exclusivas que são criadas automaticamente. Se você não fornecer nomes, o sistema gerará nomes conforme descrito posteriormente neste tópico.

   • NOME_DA_RESTRIÇÃO_DE_CHAVE_PRIMÁRIA_DO_FILETABLE

   • FILETABLE_STREAMID_UNIQUE_CONSTRAINT_NAME

   • FILETABLE_FULLPATH_UNIQUE_CONSTRAINT_NAME

Exemplos

O exemplo a seguir cria uma nova FileTable e especifica valores definidos pelo usuário para FILETABLE_DIRECTORY e FILETABLE_COLLATE_FILENAME.

CREATE TABLE DocumentStore AS FileTable  
    WITH (   
          FileTable_Directory = 'DocumentTable',  
          FileTable_Collate_Filename = database_default  
         );  
GO  

O exemplo a seguir também cria uma nova FileTable. Como os valores definidos pelo usuário não são especificados, o valor de FILETABLE_DIRECTORY se torna o nome da FileTable, o valor de FILETABLE_COLLATE_FILENAME se torna database_default e a chave primária e as contraints exclusivas recebem nomes gerados pelo sistema.

CREATE TABLE DocumentStore AS FileTable;  
GO  

Criar uma FileTable usando o SQL Server Management Studio
No Pesquisador de Objetos, expanda os objetos no banco de dados selecionado, clique com o botão direito do mouse na pasta Tabelas e selecione Nova FileTable.

Essa opção abre uma nova janela de script que contém um modelo de script Transact-SQL que você pode personalizar e executar para criar uma FileTable. Use a opção Especificar Valores para Parâmetros de Modelo no menu Consulta para personalizar o script facilmente.

Requisitos e restrições para criar uma FileTable

• Você não pode alterar uma tabela existente para convertê-la em uma FileTable.

• O diretório pai especificado anteriormente no nível do banco de dados deve ter um valor não nulo. Para obter informações sobre como especificar o diretório no nível do banco de dados, consulte Habilitar os pré-requisitos para FileTable.

• Uma FileTable requer um grupo de arquivos FILESTREAM válido, já que uma FileTable contém uma coluna FILESTREAM. Opcionalmente, você pode especificar um grupo de arquivos FILESTREAM válido como parte do comando CREATE TABLE para criar uma FileTable. Se você não especificar um grupo de arquivos, a FileTable usará o grupo de arquivos FILESTREAM padrão para o banco de dados. Se o banco de dados não tiver um grupo de arquivos FILESTREAM, um erro será gerado.

• Você não pode criar uma restrição de tabela como parte de um CREATE TABLE... AS FILETABLE. No entanto, você pode adicionar a restrição mais tarde usando uma instrução ALTER TABLE .

• Você não pode criar uma FileTable no banco de dados tempdb ou em qualquer um dos outros bancos de dados do sistema.

• Você não pode criar uma FileTable como uma tabela temporária.

Alterando uma FileTable

Como uma FileTable tem um esquema predefinido e fixo, você não pode adicionar ou alterar suas colunas. No entanto, você pode adicionar índices personalizados, gatilhos, restrições e outras opções a uma FileTable.

Para obter informações sobre como usar a instrução ALTER TABLE para habilitar ou desabilitar o namespace FileTable, incluindo as restrições definidas pelo sistema, consulte Gerenciar FileTables.

Como alterar o diretório de uma FileTable

Alterar o diretório de uma FileTable usando Transact-SQL
Chame a instrução ALTER TABLE e forneça um novo valor válido para a opção FILETABLE_DIRECTORY SET.

Exemplo

ALTER TABLE filetable_name  
    SET ( FILETABLE_DIRECTORY = N'directory_name' );  
GO  

Alterar o diretório de uma FileTable usando o SQL Server Management Studio
No Pesquisador de Objetos, clique com o botão direito do mouse na FileTable e selecione Propriedades para abrir a caixa de diálogo Propriedades da Tabela . Na página FileTable , insira um novo valor para o nome do diretório FileTable.

Requisitos e restrições para alterar uma FileTable

• Não é possível alterar o valor de FILETABLE_COLLATE_FILENAME.

• Não é possível alterar, remover ou desabilitar as colunas definidas pelo sistema de uma FileTable.

• Não é possível adicionar novas colunas de usuário, colunas computadas ou colunas computadas persistentes a uma FileTable.

Descartando uma FileTable

Você pode remover uma FileTable usando a sintaxe comum para a instrução DROP TABLE (Transact-SQL).

Quando você exclui uma FileTable, os seguintes objetos também são descartados:

• Todas as colunas da FileTable e todos os objetos associados à tabela, como índices, restrições e gatilhos, também são descartados.

• O diretório FileTable e os subdiretórios que ele continha desaparecem do arquivo FILESTREAM e da hierarquia de diretórios do banco de dados.

O comando DROP TABLE falhará se houver identificadores de arquivo abertos no namespace de arquivo da FileTable. Para obter informações sobre como fechar identificadores abertos, consulte Gerenciar FileTables.

Outros objetos de banco de dados são criados quando você cria uma FileTable

Quando você cria uma nova FileTable, alguns índices e restrições definidos pelo sistema também são criados. Não é possível alterar ou remover esses objetos; eles desaparecem somente quando a própria FileTable é descartada. Para ver a lista desses objetos, consulte a exibição de catálogo sys.filetable_system_defined_objects (Transact-SQL).

--View all objects for all filetables, unsorted  
SELECT * FROM sys.filetable_system_defined_objects;  
GO  
  
--View sorted list with friendly names  
SELECT OBJECT_NAME(parent_object_id) AS 'FileTable', OBJECT_NAME(object_id) AS 'System-defined Object'  
    FROM sys.filetable_system_defined_objects  
    ORDER BY FileTable, 'System-defined Object';  
GO  

Índices criados quando você cria uma nova FileTable
Quando você cria uma nova FileTable, os seguintes índices definidos pelo sistema também são criados:

Colunas	Tipo de índice
[path_locator] ASC	Chave Primária, não clusterizado
[parent_path_locator] ASC [nome] ASC	Exclusivo, não clusterizado
[stream_id] ASC	Exclusivo, não clusterizado

Restrições que são criadas quando você cria uma nova FileTable
Quando você cria uma nova FileTable, as seguintes restrições definidas pelo sistema também são criadas:

Restrições	Impõe
Restrições padrão nas seguintes colunas: creation_time is_archive is_directory is_hidden is_offline is_readonly is_system is_temporary tempo_de_último_acesso last_write_time path_locator stream_id	As restrições padrão definidas pelo sistema impõem valores padrão para as colunas especificadas.
Verificar restrições	As restrições de verificação definidas pelo sistema impõem os seguintes requisitos: Nomes de arquivo válidos. Atributos de arquivo válidos. O objeto pai deve ser um diretório. A hierarquia do namespace é bloqueada durante a manipulação de arquivo.

Convenção de nomenclatura para as restrições definidas pelo sistema
As restrições definidas pelo sistema descritas acima são nomeadas no formato <constraintType>_<tablename>[_<columnname>]_<uniquifier> em que:

• < >constraint_type é CK (restrição de verificação), DF (restrição padrão), FK (chave estrangeira), PK (chave primária) ou UQ (restrição exclusiva).

• <uniquifier> é uma cadeia de caracteres gerada pelo sistema para tornar o nome exclusivo. Essa cadeia de caracteres pode conter o nome FileTable e um identificador exclusivo.

Consulte Também

Gerenciar FileTables