Ligações e Entidades
As entidades de um Modelo Semântico leem dados através de ligações autorizadas. Antes de importar uma entidade, verifique se possui permissões na ligação e no projeto do modelo.
Tipos de ligação
Environment
Uma ligação Environment é pré-configurada e gerida pelo administrador. O editor mostra apenas aquelas compatíveis com os papéis do modelo e com o utilizador.
Manual
Uma ligação Manual pode ser criada no editor quando o administrador habilitar esta opção.
A gestão permite:
- atribuir um nome;
- escolher o tipo de fonte suportada;
- inserir as informações solicitadas no formulário protegido;
- verificar a ligação;
- atualizá-la;
- revogá-la;
- eliminá-la quando não estiver em uso.
Para Oracle, o formulário também exige a escolha se o nome do banco de dados é um SID ou um Service name.
Os valores reservados não são exibidos após o salvamento. Não os insira em nomes, descrições ou capturas de ecrã.
Importar entidades
- Selecionar Importar entidades.
- Escolher o tipo de ligação.
- Selecionar uma ligação autorizada.
- Carregar o catálogo.
- Pesquisar por esquema, entidade, campo ou tipo.
- Selecionar uma ou mais tabelas ou visões.
- Selecionar Importar selecionados.
Para cada entidade, o Sybot cria os campos iniciais e exibe-os no painel Entidades e no diagrama. O catálogo mostra todos os esquemas que contêm tabelas ou visões legíveis, até 500 entidades por esquema.
Para SAP HANA, o catálogo inclui tabelas, visões e colunas acessíveis ao utilizador da ligação. Os objetos não autorizados não são mostrados; se faltar uma fonte esperada, solicite a verificação de permissões ao administrador relativo.
Propriedades da entidade
Ao selecionar uma entidade, é possível configurar:
- nome técnico e rótulo;
- estado ativo;
- fonte;
- campos;
- dimensões calculadas;
- medidas;
- comportamento de atualização para modelos Import;
- estilo do cabeçalho no diagrama.
Um campo pode ser ocultado aos utilizadores de Visões sem ser removido do modelo.
Configurar a fonte
O comando Configurar consulta permite escolher:
- tabela;
- visão;
- Query Builder;
- SQL personalizado de leitura.
O Query Builder suporta objeto de partida, joins, condições organizadas em grupos, ordenações e limite de linhas.
O modo SQL personalizado aceita apenas consultas de leitura. Utilize os controlos do editor e não insira dados confidenciais no texto da consulta.
Preview
Estão disponíveis duas verificações:
- Preview de configuração, antes de aplicar a fonte ao rascunho;
- Preview de entidade, na definição atual do modelo.
A Preview mostra uma amostra limitada e não publica o modelo.
Se não retornar dados, verifique a ligação, o objeto selecionado, as condições e as autorizações. Na presença de uma mensagem com referência de diagnóstico, comunique-a ao administrador sem adicionar credenciais ou dados de origem.
Modificações na fonte
Quando se abre o Editor, o Sybot verifica em segundo plano se as tabelas e visões usadas diretamente pelas entidades foram alteradas. A verificação pode detetar:
- colunas adicionadas ou removidas;
- alterações do tipo de dados;
- tabelas ou visões eliminadas;
- configurações do modelo envolvidas pela alteração.
A verificação não modifica automaticamente o modelo. Se forem encontradas diferenças, aparece um aviso com o botão Detalhes.
Em detalhe, as modificações são agrupadas por entidade e mostram também os efeitos previstos em relações, fórmulas, campos calculados, medidas, hierarquias e atualização incremental.
Para alinhar o rascunho:
- selecionar Detalhes;
- verificar todas as modificações e os impactos;
- selecionar Atualizar modelo;
- verificar novamente Preview de entidade e consulta semântica;
- salvar e publicar uma nova versão somente após o teste.
Se uma fonte não for alcançável, o Sybot não considera eliminadas as suas entidades e impede o alinhamento até que a verificação esteja completa.
As entidades baseadas em Query Builder ou SQL personalizado não são realinhadas automaticamente, porque as colunas retornadas dependem da configuração da query. As tabelas de calendário também permanecem geridas pelo modelo.