Executar Comando JPQL
Executa comandos, como atualização e remoção, na linguagem JPQL. Para executar consultas, utilize o bloco Executar Consulta JQPL.
Figura 1 - Bloco Executar JPQL
Compatibilidade
Servidor
Exemplo 1
A função abaixo em destaque permite a execução de um comando JPQL.
Sobre a JPQL (Java Persistence Query Language)
A JPQL é uma linguagem de consulta ORM que opera sobre classes e objetos, diferente do SQL que opera sobre tabelas. Ela é também uma especificação da JPA, e apesar de trabalhar com entidade (classes) é uma linguagem bem semelhante a SQL. Uma das vantagens da JPQL é que a mesma consulta pode ser executada em todos os bancos de dados.
| Informações | ||
|---|---|---|
| ||
Sobre o bloco
A construção de uma instrução utilizando o bloco Executar Comando JPQL pode ser feita clicando-se no botão de configuração do bloco de programação.
Configuração do bloco de programação
- Bloco servidor: cronapi.database.Operations.execute()
Retorno
Bloco não possui retorno.
Características do bloco
Para configurar o bloco Executar JPQL, clique no ícone de engrenagem (seta da Figura 2). Após esta ação, a janela de "Configurar Bloco de Programação" será exibida permitindo a configuração do comando JPQL.
| Âncora | ||||
|---|---|---|---|---|
|
Figura 2 - Configuração do bloco Executar JPQL
Destaques da Figura 2:
- Entidade: abre a janela de seleção de entidades.
- Filtro: permite inserir o comando JPQL que será utilizado.
- Parâmetro: define o nome do parâmetro que será utilizado no comando. Deve seguir a estrutura:
<:parametro>. Cada valor inserido como parâmetro também será adicionado como um parâmetro no bloco.
- Parâmetro: define o nome do parâmetro que será utilizado no comando. Deve seguir a estrutura:
| Âncora | ||||
|---|---|---|---|---|
|
Parâmetros
Parâmetro "N"
Os parâmetros da função são exibidos de acordo com os parâmetro configurados no comando utilizado. Isso implica que a cada novo parâmetro definido, cujo valor não seja estático, um parâmetro é apresentado no bloco da função.
- Posição: 1 ou mais
- Tipo: Depende do tipo do dado do atributo.
Exemplo
A imagem abaixo apresenta um exemplo de uso do bloco Executar JPQL. O bloco foi configurado como exibido na Figura 2. Por meio dele, atualizaremos o campo "nota" do aluno que possui o nome informado no parâmetro "nome".
Figura 3 - Exemplo de uso do bloco Executar JPQL
As Figuras 3.1 e 3.2 apresentam os registros antes e depois da atualização, respectivamente. Observe que somente o registro da primeira linha (destaque 1 da Figura 3.1) foi alterado.
Figura 3.1 - Tabela "Aluno" antes da atualização
Figura 3.2 - Tabela "Aluno" depois da atualização
Nesta página
| Índice |
|---|