Inserir
Insere um novo registro em uma tabela do banco de dados.
Parâmetros
Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Objeto/campos | Objeto contendo o registro com os dados a serem inseridos, quando configurado via objetos ou, campos, contendo um ou mais dados a serem inseridos, quando configurados via campos |
Os parâmetros de entrada para função apresentam-se de acordo com os campos, ou o objeto, adicionados na janela de configuração do bloco de programação, o que significa dizer que cada campo definido representa um novo parâmetro da função.
Configuração do bloco
É possível inserir um registro na tabela do banco de dados de duas formas diferentes, via campos ou por objeto, essa configuração é feita a partir do campo Tipo (destaque 2 da figura 1).
Para configurar o bloco Inserir, clique no símbolo da engrenagem, isso fará com que a janela Configurar Bloco de Programação seja exibida. Após informar a entidade (destaque 1 da figura 1), é possível selecionar os campos que serão usados a partir dos atributos do objeto (Tipo Campos) ou apenas passando o Objeto, nesse caso, não será possível configurar os campos.
Figura 1 - Inserção de dados via campos
- Entidade: abre a janela de seleção de entidades.
- Tipo: informa se o bloco será alimentado a partir dos atributos "Campos" da entidade ou a partir do "Objeto".
- + Novo Campo: clique para adicionar os campos da entidade.
- Campos: lista de campos adicionados.
- Botão Excluir: apaga os campos inseridos. Exclua todos os campos para retornar ao tipo "Objeto"
Para saber mais sobre o campo Modo de Consulta, acesse a figura 1.1 da documentação Assistente de consulta JPQL.
Compatibilidade
Servidor
Exemplo 1 - Inserção via campos
Assim que selecionamos a entidade (destaque 1 da figura 1), o bloco é configurado por padrão com o tipo objeto, para que possamos mudar o tipo para campos, devemos clicar em + Novo campo (destaque 3 da figura 1) para adicionar os campos. Definidos os campos, basta inserir os valores que serão salvos no registro, confira na figura 1.1.
Figura 1.1 - Bloco de programação Inserir configurado via campos
Confira abaixo o resultado da inserção.
Figura 1.2 - Registro sendo exibido na Grade
Exemplo 2 - Inserção via objeto
Além da inserção via campos, também é possível inserir um registro passando um objeto já com seus atributos. No exemplo abaixo estamos criando um objeto a partir do bloco de programação Criar novo objeto.
Figura 1.3 - Bloco de programação Inserir configurado via objeto
Confira abaixo o resultado da inserção.
Figura 1.4 - Registro sendo exibido na Grade
Sobre o bloco
O bloco de programação Inserir insere dados em um registro de duas formas diferentes, a primeira é passando os campos que se deseja inserir, como exemplificada na figura 1.1. A segunda forma é passando diretamente o objeto, figura 1.3.
Sobre Inserção(Insert SQL)
Insert é uma declaração da linguagem SQL, “Structured QueryLanguage” ou, em Português, Linguagem de Consulta Estruturada, que insere um ou mais registros em uma tabela em um banco de dados. para saber mais clique aqui.