DATTA BI — Modelos e relacionamentos visuais

Cruzar dados de fontes diferentes costumava exigir SQL, exportações e uma boa dose de paciência. Com os Modelos do DATTA BI, você arrasta os datasets como caixas num canvas e desenha os relacionamentos entre eles — o equivalente à "Model view" do Power BI Desktop. Feito isso, os gráficos do dashboard passam a se filtrar entre si automaticamente. Os relacionamentos existem apenas no DATTA BI: eles nunca alteram a fonte original.

Como acessar

Menu Visualizar›Modelos.

O que você vê no canvas

• Caixas de dataset arrastáveis, mostrando o dataset e suas colunas.
• Linhas de relacionamento com indicador de cardinalidade (1:1, 1:N, N:1, N:N) e direção do filtro (unidirecional ou bidirecional).
• Pré-visualização: duplo clique numa caixa abre uma tabela com as 100 primeiras linhas do dataset, já com a edição DATTAX por coluna.

Criar um relacionamento arrastando

1. Passe o mouse pela borda direita de uma caixa de dataset — aparece um ponto de conexão azul.
2. Arraste esse ponto até a outra caixa.
3. No diálogo que abre, informe:
   • From column — a coluna de origem (a chave estrangeira).
   • To column — a coluna de destino (a chave primária).
   • Cardinality — 1:1, 1:N, N:1 ou N:N.
   • Direction — BOTH (filtro cruzado bidirecional) ou SINGLE.
4. Confirme: a linha é desenhada no canvas e o relacionamento fica salvo no modelo.

Cada relacionamento é gravado com o modelo a que pertence, os datasets de origem e destino, as colunas ligadas, a cardinalidade, a direção e o indicador de ativo — tudo na base de BI da plataforma.

Filtro cruzado automático

Quando dois datasets relacionados alimentam gráficos do mesmo dashboard e existe um relacionamento ativo entre eles, clicar numa barra do gráfico A propaga o filtro para o gráfico B, seguindo o relacionamento por um JOIN lógico — sem nenhuma configuração adicional. Veja o guia de filtro cruzado.

Colunas calculadas com DATTAX

Na pré-visualização do dataset, clique no nome de uma coluna: abre um editor onde você escreve uma expressão DATTAX personalizada, por exemplo:

UPPER(nome)
coalesce(municipio, "—")

A expressão vira uma coluna calculada e fica salva junto do dataset, disponível em qualquer gráfico.

Exemplo prático — modelo de assistência social

O seed de dados de demonstração (seed-demo-data.sh) já cria quatro relacionamentos no modelo dm-mds-assistencia:

1. Pessoa.familiaId → GrupoFamiliar.id (N:1, BOTH)
2. BeneficioSocial.pessoaId → Pessoa.id (N:1, BOTH)
3. Transacao.beneficioId → BeneficioSocial.id (N:1, BOTH)
4. ServicoPublico.uf → Pessoa.uf (N:N via uf, SINGLE)

As três primeiras ligações são bidirecionais (BOTH): o filtro cruzado entre os gráficos que usam esses datasets vale nos dois sentidos. A quarta é unidirecional (SINGLE) — o filtro por uf segue em um sentido só, sem propagar de volta.

Limitações conhecidas

• Sem detecção automática de chaves: você indica manualmente a coluna de origem e a de destino.
• N:N não cria tabela de mapeamento intermediária automática — quando precisar dela, monte um dataset adicional.
• Direction=BOTH pode criar ciclo de filtro se mal configurada; a interface alerta quando detecta o risco.