Aceder a FileTables com Transact-SQL

Aplica-se a:SQL Server

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

INSERT Operações em FileTables

As seguintes considerações aplicam-se às INSERT Operações em Tabelas de Ficheiros:

• Todas as colunas de atributos do ficheiro têm restrições do tipo NOT NULL. Se os valores não forem explicitamente definidos, então são fornecidos valores padrão apropriados.

• Restrições definidas pelo sistema são aplicadas se a INSERT instrução definir o nome, path_locator, parent_path_locator ou atributos do ficheiro.

• A aplicação pode obter a path_locator de um ficheiro ou diretório fornecendo o caminho do sistema de ficheiros para a função GetPathLocator (Transact-SQL).

UPDATE Operações sobre FileTables

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

• São permitidas atualizações a quaisquer dados definidos pelo utilizador.

• Restrições definidas pelo sistema são aplicadas se a INSERT instrução definir o nome, path_locator, parent_path_locator ou atributos do ficheiro.

• Podem ser feitas atualizações aos dados do FILESTREAM na coluna file_stream sem afetar nenhuma das outras colunas, incluindo os carimbos temporais.

DELETE Operações em FileTables

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

• Eliminar uma linha também remove o ficheiro ou diretório correspondente do sistema de ficheiros.

• Não é possível eliminar uma linha se esta corresponder a um diretório que contenha outros ficheiros ou diretórios.

Restrições que são aplicadas para operações DML em FileTables

Restrições definidas pelo sistema garantem que as ações DML não comprometem a integridade da hierarquia do espaço de nomes de ficheiros. As restrições aplicadas incluem as seguintes:

• Quando defines ou alteras o nome do ficheiro ou diretório:

  • As convenções de nomeação de ficheiros e diretórios do Windows são aplicadas.

  • A unicidade do nome no diretório principal é aplicada.

• Quando define ou altera a localização de um ficheiro ou diretório ao definir ou alterar o path_locator ou parent_path_locator:

  • A singularidade é garantida.

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

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

• As colunas de atributos do ficheiro não podem ser nulas. As restrições NOT NULL são aplicadas com valores padrão.

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

Ver também

Carregar ficheiros em FileTables
Trabalho com Diretórios e Caminhos em FileTables
Aceder a FileTables com APIs de Entrada/Saída de Ficheiros
DDL do FileTable (DDL), Funções, Procedimentos Armazenados e Vistas