Compartilhar via


Acesse FileTables com Transact-SQL

Descreve como os comandos DML (linguagem de manipulação de dados) Transact-SQL funcionam com FileTables.

Operações de Inserção em Tabelas de Arquivos

As seguintes considerações se aplicam às Operações INSERT em FileTables:

  • Todas as colunas de atributos de arquivo estão sujeitas a restrições NOT NULL. Se os valores não forem definidos explicitamente, os valores padrão apropriados serão fornecidos.

  • Restrições definidas pelo sistema serão impostas se a instrução INSERT definir o nome, path_locator, parent_path_locator ou atributos de arquivo.

  • O aplicativo pode obter o path_locator de um arquivo ou diretório fornecendo o caminho do sistema de arquivos para a função GetPathLocator (Transact-SQL).

Operações UPDATE em FileTables

As seguintes considerações se aplicam às operações UPDATE em FileTables:

  • As atualizações para quaisquer dados definidos pelo usuário são permitidas.

  • Restrições definidas pelo sistema serão impostas se a instrução INSERT definir o nome, path_locator, parent_path_locator ou atributos de arquivo.

  • As atualizações podem ser feitas nos dados FILESTREAM na coluna file_stream sem afetar nenhuma das outras colunas, inclusive os carimbos de data/hora.

Operações de exclusão em FileTables

As seguintes considerações se aplicam às operações DELETE em FileTables:

  • Excluir uma linha também remove o arquivo ou diretório correspondente do sistema de arquivos.

  • A exclusão de uma linha falhará se a linha corresponder a um diretório que contenha outros arquivos ou diretórios.

Restrições impostas para operações DML em FileTables

Restrições definidas pelo sistema garantem que as ações DML não comprometam a integridade da hierarquia do namespace de arquivo. As restrições impostas incluem o seguinte:

  • Ao definir ou alterar o nome do arquivo ou diretório:

    • As convenções de nomenclatura de diretório e arquivo do Windows são impostas.

    • A exclusividade do nome no diretório pai é imposta.

  • Quando você define ou altera o local de um arquivo ou diretório definindo ou alterando o path_locator ou parent_path_locator:

    • A exclusividade é imposta.

    • A consistência da árvore hierárquica de diretórios e arquivos é imposta, incluindo a consistência dos valores de path_locator e de parent_path_locator.

  • O valor de is_directory não pode ser definido como true quando a coluna file_stream não é nula. Os dados na coluna file_stream indicam que a linha representa um arquivo e não um diretório.

  • As colunas de atributo de arquivo não podem ser nulas. As restrições NOT NULL são impostas com valores padrão.

  • O valor de last_access_time não pode ser anterior a last_write_time e creation_time.

Consulte Também

Carregar arquivos em FileTables
Trabalhar com diretórios e caminhos em FileTables
Acessar FileTables com APIs de entrada e saída de arquivo
DDL fileTable, funções, procedimentos armazenados e exibições