Instrução INSERT

A instrução INSERT inclui uma nova linha a um banco de dados externo.

Sintaxe

A lista opcional de nomes de colunas identifica uma lista de colunas na tabela de destino na qual valores serão inseridos. Quaisquer colunas não mencionadas na lista de nomes de colunas tem seus valores padrão inseridos.

Pode ser gerado um erro de tempo de execução se ocorrerem problemas durante a operação de inserção. Por exemplo, a tabela do banco de dados pode ter restrições definidas que a operação de inserção pode violar. Nestes casos, será emitida uma exceção, a menos que o nó tenha sido configurado para modificar este comportamento.

Exemplos

O exemplo a seguir supõe que a propriedade dataSource do nó Database foi configurada e que o banco de dados identificado por essa origem de dados tem uma tabela chamada TABLE1 com colunas A, B e C.

Especificada uma mensagem que tem o seguinte corpo XML genérico:
<A>
 <B>1</B>
 <C>2</C>
 <D>3</D>
</A>
A instrução INSERT a seguir insere uma nova linha na tabela com os valores (1, 2, 3).
INSERT INTO Database.TABLE1(A, B, C) VALUES (Body.A.B,
Body.A.C, Body.A.D);

Tratando Erros do Banco de Dados

Para obter informações sobre como tratar erros do banco de dados, consulte Capturando o Estado do Banco de Dados.

Conceitos relacionados
ESQL

Tarefas relacionadas
Desenvolvendo ESQL
Capturando o Estado do Banco de Dados

Referências relacionadas
Preferência de Sintaxe
instruções ESQL