Índice

Objetivo

O objetivo deste documento é apresentar a ferramenta Visões de Dados e suas funcionalidades.

Introdução

Utilizando a Visões de Dados é possível criar uma variedade de consultas SQL, partindo da simples a mais complexas. Não importando se o apresentado será uma simples lista de registros ou um resumo agrupado de funcionários por seção.

As consultas SQL podem ficar disponíveis para Objetos Gerenciais, então, crie Relatórios, Cubos, Planilhas entre outros. Agende o envio de dados gerados em tempo real.

Funcionalidades

Importante:

Para o correto funcionamento da funcionalidade de Visão de Dados é necessário que o sistema consiga recuperar o schema da consulta SQL ao salvá-la. Caso seja retornado um erro na recuperação do schema, entre em contato com o seu DBA para análise e reescrita da consulta.

É importante lembrar que para outros executores de consultas SQL conseguir recuperar o schema de uma consulta não é requisito. No RM é necessário, pois existem validações de segurança (de campos, por perfil, por usuário...) entre outras funcionalidades que necessitam dele para funcionar como esperado.

Ao editar uma consulta SQL, é necessário validar todas as referências através do botão "Procurar Referências".

Caso tenha adicionado ou removido campos da consulta, será necessário editar a consulta em todos os objetos referenciados para que os campos sejam atualizados.

Limitações

As visões de dados têm como objetivo apenas retornar dados.
Por isso, existem as seguintes limitações:

• Obrigatoriedade de uma cláusula SELECT.
• Não são permitidas as cláusulas ALTER, DELETE, DROP, INSERT, e UPDATE.
• Não é permitida a utilização dos métodos EXEC e EXECUTE [ver nota abaixo]
• Termo DECLARE, não é recomendado o uso.

Podem existir também outras limitações específicas de cada SGBD.

Parâmetros e Variáveis

A utilização de parâmetros deve seguir o modelo de COLUNA = :NOME_DO_PARAMETRO, onde o valor a ser atribuído pelo filtro na clausula WHERE deve ser substituído pelo parâmetro, precedido de :(Dois pontos). A consulta SQL pode não suportar declarações de constantes e variáveis conforme o padrão PL/SQL, modelo usado diretamente no SGDB.

Para obter uma lista de variáveis aceitas na Consulta SQL, veja aqui: Variáveis Dinâmicas

Exemplo de uma consulta SQL utilizando dois parâmetros, :CIDADE e :PAIS

Na execução da consulta os parâmetros são apresentados para informar o valor.

Em alguns casos pode ocorrer que alguma diretiva ou palavra reservada do SGDB não seja aceita pela Consulta SQL.

Exemplo não suportado, onde o termo "define" não é reconhecido.
O código abaixo pode ser executado diretamente pelo SGDB, mas não pela Consulta SQL.

define CIDADE = 'Belo Horizonte';
define PAIS = 'Brasil';

SELECT EMAIL, RUA, NUMERO, PAIS, CIDADE
FROM GCOLIGADA
WHERE CIDADE = '&CIDADE' AND PAIS = '&PAIS'

Fórmula como parâmetro

Em uma consulta SQL é possível utilizar uma Fórmula RM, como parâmetro em um filtro na clausula Where, isso possibilita somar à consulta todos os recursos da Fórmula e enriquecer a funcionalidade.

Exemplo de duas Fórmulas simples, uma retorna um valor do tipo String e outra um número.

Na consulta SQL o nome do parâmetro é informado com o prefixo FRM_ acrescido do Nome da Fórmula, definido pelo campo código no cadastro da Fórmula.

Na execução da consulta o parâmetro da Fórmula foi adicionado diretamente no filtro, e não precisa ser apresentado ao usuário.

Comentários

São suportados comentários na sentença SQL, entretanto deve ser utilizado com cuidado para não interferir e gerar erros de interpretação da consulta.
Em SQL Server e Oracle são aceitos dois tipos básicos de comentários, por bloco e por linha:

Comentário por Bloco deve começar com /* e finalizar com */, pode conter quebra de linha.

Comentário por Linha deve iniciar com -- , tudo a direita na linha poderá ser comentado. Não suporta quebra de linha.

/* Bloco incial usado para comentários */

SELECT * FROM GCOLIGADA -- Comentário de linha

/* 
  Bloco final usado como comentários
 */

SELECT * FROM GCOLIGADA
WHERE CODCOLIGADA IN 
(1,2,
3 -- Comentário dentro da cláusula
,4 -- Comentário entre parênteses -- Mais outro comentário... ;)
)