Criar, alterar ou descartar uma FileTable

Aplica-se a:SQL Server

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

Criar 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 do 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 de criação de uma FileTable permite que você especifique:

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

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

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

Criar uma FileTable com Transact-SQL

Crie uma FileTable chamando a instrução CREATE TABLE 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 atua como diretório raiz de 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 de exclusividade 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 de diretório que você fornece deve atender aos 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 exclusividade não diferencia maiúsculas de minúsculas, independentemente das configurações de ordenação 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 não deve fazer diferenciação de maiúsculas e minúsculas para estar em conformidade com a semântica de nomenclatura de arquivo 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 CREATE TABLE operação falhará.

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

   • FILETABLE_PRIMARY_KEY_CONSTRAINT_NAME
   • 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 ambos 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 torna-se o nome da FileTable, o valor de FILETABLE_COLLATE_FILENAME torna-se database_default, e a chave primária e as restrições exclusivas recebem nomes gerados pelo sistema.

CREATE TABLE DocumentStore AS FILETABLE;
GO

Criar uma FileTable com o SQL Server Management Studio

No Pesquisador de Objetos, expanda os objetos do 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 facilmente o script.

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 CREATE TABLE comando 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 uma CREATE TABLEinstrução...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 tempdb banco de dados ou em nenhum dos outros bancos de dados do sistema.

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

Alterar 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 ALTER TABLE instrução para habilitar ou desabilitar o namespace FileTable, incluindo as restrições definidas pelo sistema, consulte Gerenciar FileTables.

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 SET de FILETABLE_DIRECTORY.

Example

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 Explorador de Objetos, clique com o botão direito do mouse em FileTable e selecione Propriedades para abrir a caixa de diálogo Propriedades de Tabela . Na página FileTable , insira um novo valor para o Nome de diretório da FileTable.

Requisitos e restrições para alterar uma FileTable

• Você não pode alterar o valor de FILETABLE_COLLATE_FILENAME.

• Você não pode 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.

Remover uma FileTable

Você pode remover uma FileTable usando a sintaxe comum para a instrução DROP TABLE .

Quando você remover uma FileTable, os seguintes objetos também serão removidos:

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

• 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 DROP TABLE comando falhará se houver identificadores de arquivo abertos no namespace de arquivo da FileTable. Para obter mais informações sobre o fechamento de 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, também são criados alguns índices e restrições definidos pelo sistema. 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.

--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	Clustered
[path_locator] ASC	Chave Primária	Não
[parent_path_locator] ASC, [name] ASC	Único	Não
[stream_id] ASC	Único	Não

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 last_access_time 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 de namespaces é bloqueada durante a manipulação do arquivo.

Convenção de nomenclatura para as restrições definidas pelo sistema

As restrições definidas pelo sistema descritas anteriormente são nomeadas no formato em que <constraintType>_<tablename>[_<columnname>]_<uniquifier> :

• '<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.

Conteúdo relacionado

• Gerenciar FileTables