Abrir consulta nativa
Executa comandos de consulta de dados (DQL) e retorna um objeto com sua estrutura de acordo com a entidade base selecionada.
Parâmetros de entrada
Os parâmetros de entrada para função apresentam-se de acordo com as regras criadas no assistente de consulta visual, o que significa dizer que cada nova regra definida que tenha seu valor passado de forma não estática, se torna um parâmetro da função.
Retorno
Retorna um objeto com sua estrutura de acordo com a entidade base selecionada.
Compatibilidade
Servidor
Sobre a configuração do bloco
Ao abrir a engrenagem do bloco, será aberta a janela de configuração do bloco e nela se encontra o campo para a escolha da entidade base (1 da Figura 1.1) que a estrutura do objeto será convertida e a área para informar o comando (2 da Figura 1.1).
Figura 1.1 - Configurando bloco
Exemplo
A consulta da figura 1.1 retorna um objeto no qual somente o dado passado no parâmetro criado na consulta é impresso no console da IDE (Figura 1.2).
Figura 1.2 - Impressão do objeto retornado da consulta
Sobre a consulta nativa x cache
Se o cache não estiver desativo na IDE e uma consulta, de uma mesma entidade base, ter sido realizada antes, ela será armazenada no cache e o bloco irá reaproveitar esses dados - mesmo que a nova consulta não tenha especifícado os mesmos campos da consulta anterior.
Por exemplo, se a primeira consulta for um SELECT * FROM MUSICA, ele irá retornar o objeto com todos os dados dessa consulta (Figura 2.1) e irá amarzenar no cache.
Figura 2.1 - Consulta trazendo todos os dados
Quando realizar a segunda consulta, por exemplo SELECT id, faixa FROM MUSICA, ele irá retornar o objeto com todos os dados preenchidos devido a primeira consulta ter sido realizada (Figura 2.2).
Figura 2.2 - Consulta trazendo todos os dados preenchidos