Í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
| Informações |
|---|
|
|
| Section |
|---|
|
| Column |
|---|
| Permite ao usuário criar novas consultas SQL. O aceso ao ícone é concedido no(s) perfil(s) associado(s) ao usuário. |
|
| Section |
|---|
|
| Column |
|---|
| Permite ao usuário excluir consultas SQL. O aceso ao ícone é concedido no(s) perfil(s) associado(s) ao usuário.  Nota: Consultas SQL associadas a outros processos como objetos gerência e anexos da visão não poderão ser excluídas.
|
|
| Section |
|---|
|
| Column |
|---|
| Código da consulta SQL. Nota: Não é permitido caracteres especiais como ?>- etc. |
|
| Section |
|---|
|
| Column |
|---|
| Campo destinado para informar o título da consulta SQL. |
|
| Section |
|---|
|
| Column |
|---|
| 6 - Visível a todas Coligadas |
| Column |
|---|
| Opção que habilita e desabilita a consulta SQL como Consulta SQL Global.  Nota: A opção "Visível a todas Coligadas" marcada habilita a visualização da consulta SQL em todas as demais coligadas que seu usuário possui acesso. Caso seja mantido a opção default do parâmetro a consulta estará dispensável somente para coligada corrente da sua criação.
|
|
| Section |
|---|
|
| Column |
|---|
| Esta opção permite determinar, para cada consulta, se ela deve considerar ou não a segurança por perfil/usuário ou segurança de campos. |
|
| Section |
|---|
|
| Column |
|---|
| Demostra qual o aplicativo a consulta SQL está associada. Nota: Uma vez salvo os dados não é possível trocar o sistema. |
|
| Section |
|---|
|
| Column |
|---|
| 9 - Editor de Query |
| Column |
|---|
| Editor de Query é o principal campo do cadastro de consultas SQL onde é possível criar e/ou dar manutenção nas consultas SQL. Nota: O "SET LANGUAGE" não deve ser utilizado em consultas SQL pois o mesmo influencia no contexto da aplicação que está compartilhando daquela conexão. |
|
| Section |
|---|
|
| Column |
|---|
| Permite configurar uma conexão externa para que a consulta SQL busque informações em outras bases de dados. |
|
| Section |
|---|
|
| Column |
|---|
| Permite que a consulta SQL criada esteja disponível/visível em visões, filtros, relatórios, menus e portal. |
|
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.
| Aviso |
|---|
Caso a Consulta SQL esteja associada à um Objeto de Negócio e tenha sido editada de forma a modificar seu esquema ou parâmetros, o Objeto de Negócio será desativado e será necessário validar novamente essas informações. Nesse caso, ao clicar em "Salvar" será exibida a mensagem de alerta abaixo. que possibilita o acesso à interface de edição do Objeto de Negócio conforme detalhado em Configuração de Consulta SQL como Objeto de Negócio: 
|
Limitações
Apesar de serem Consultas SQL, 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]
| Nota |
|---|
| title | Bloqueio dos comandos de execução |
|---|
|
Com a intenção de bloquear a execução de comandos de alteração de dados, a partir da versão 12.1.2302 bloquearemos os métodos EXEC e EXECUTE.
A virada ocorrerá da seguinte forma: - visões de dados criadas antes da versão citada, que utilizem estes métodos, continuarão funcionando normalmente;
- no entanto, não será possível alterar estas visões de forma a preservar o exec ou execute (não será possível salvar a visão com estes comandos);
- não será possível criar novas visões, ou importar visões de dados criadas em outras versões, que possuam estes métodos.
|
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 linhas.
Comentário por Linha deve iniciar com -- , tudo a direita na linha poderá ser comentado. Não suporta quebra de linha.
| Bloco de código |
|---|
| language | c# |
|---|
| theme | RDarksql |
|---|
| title | Exemplo |
|---|
|
/* BreakBloco incial Lineusado Commentpara Topcomentários */
SELECT * FROM GCOLIGADA -- Comentário Linede Commentlinha
/* Break Line Comment Down
Bloco final usado como comentários
*/ |
