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 |
| Nota |
|---|
Os parâmetros de entrada para função apresentam-se do bloco vão variar de acordo com os campos , ou o objeto, adicionados na objeto selecionados no assistente da janela de configuração do bloco de programação. |
Retorno
Retorna um objeto contendo os campos selecionados da entidade.
O retorno da chave primária (PK) junto com o objeto varia de acordo com o Tipo de PK e o Banco de dados utilizado (Figura 1).
Assim, quando o tipo de chave primária (PK) é definida como:
- "Auto incremento", ou seja,
- o banco de dados é quem gera o valor da chave, o retorno ocorrerá apenas ao utilizar os bancos Oracle e Firebird (Figura 1).
- "Nova GUID", ou seja, o servidor (Java) da aplicação é quem gera o valor da chave, o retorno sempre ocorrerá.
Figura 1 - Retorno dos objetos ao utilizar banco de dados e tipo de PK distintos
| Informações |
|---|
Acesse o tópico Estrutura da Classe da documentação Diagrama de dados para entender mais sobre a propriedade Tipo de PK. |
Compatibilidade
Servidor
Configuração do bloco
É possível
inserirInserir 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 2 - 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 12), o 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 12) para adicionar os campos. Definidos os campos, basta inserir os valores que serão salvos no registro, confira na figura 13.1.
Figura 1.1 3 - Bloco de programação Inserir configurado via campos
Confira abaixo o resultado da inserção.
Figura 3.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 4 - Bloco de programação Inserir configurado via objeto
Confira abaixo o resultado da inserção.
Figura 4.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.