Executa comandos de modificação de dados (DML), como UPDATE, INSERT INTO e DELETE, e comandos de modificação da estrutura dos dados (DDL), como ALTER TABLE. São instruções executadas diretamente no banco de dados, dispensando a necessidade de configurar ou criar uma persistência para acessar ou manipular os dados. 

Figura 1 - Bloco Abrir instrução SQL nativa

Compatibilidade

• Bloco servidor: cronapi.database.Operations.executeNativeQueryUpdate()

Retorno

Retorna a quantidade de linhas que foram impactadas pelas instruções realizadas.

Características do bloco

Para configurar o bloco Abrir instrução SQL nativa, clique no ícone de engrenagem do bloco (seta da Figura 2). Após esta ação, a janela Configurar Bloco de Programação será exibida permitindo a seleção de uma entidade e a configuração da instrução a ser executada. Para acessar a janela de seleção de entidade, clique no botão do destaque 1 na Figura 2. Após selecionar a entidade desejada, é possível configurar a instrução SQL a ser executada (2). No exemplo abaixo, utilizamos a instrução INSERT INTO para inserir os dados informados na tabela "Aluno".

Figura 2 - Janela Configurar Bloco de Programação

Parâmetros

Parâmetro "N"

Os parâmetros da função são exibidos após a escolha da entidade na janela Configurar Bloco de Programação e a configuração da instrução a ser utilizada. Isso implica que a cada parâmetro adicionado na instrução, um parâmetro é apresentado no bloco da função. Para adicionar um parâmetro à instrução, utilize dois-pontos ( : ) seguidos pelo nome do campo da entidade, no formato :nome-do-campo. Confira um exemplo na Figura 3.1.

• Posição: 1 ou mais
• Tipo: Depende do tipo do dado do atributo.

Exemplo

A imagem abaixo apresenta um exemplo de uso do bloco Abrir instrução SQL nativa. Iniciamos a função com o bloco Iniciar Transação, seguido da configuração do bloco Abrir instrução SQL nativa utilizando a instrução INSERT INTO, conforme apresentado na Figura 3.1. Após a execução, o número de linhas afetadas pela operação será impressa no console do depurador. Os dados inseridos no banco de dados podem ser visualizados na Figura 3.2.

Figura 3 - Exemplo de uso do bloco Abrir instrução SQL nativa

A Figura 3.1 apresenta como o bloco foi configurado com a instrução SQL INSERT INTO. Observe que cada campo no formato :nome-do-campo, foi incluído como um parâmetro no bloco da função (Figura 3).

Figura 3.1 - Configuração da instrução SQL utilizada no bloco

Na imagem a seguir, podemos visualizar os dados inseridos no banco de dado (destaque 1 da Figura 3.2) após a execução da função.

Figura 3.2 - Registro inserido no banco de dados após execução da função da Figura 3