DATTABI — Guia do Usuário

Preview — funcionalidade em desenvolvimento. Comportamento, telas e contratos podem mudar sem aviso entre versões.

Com o DATTABI, você cria dashboards profissionais direto sobre as fontes já conectadas ao DATTA — grafo, índices de busca, bancos relacionais, warehouses, arquivos e streams — sem exportar dados nem depender de ferramenta de BI externa. Montar um painel costumava significar cópias de dados espalhadas, licença à parte e horas de retrabalho a cada mudança de fonte. Aqui você monta workspaces, dashboards, visuais e pipelines de preparação de dados com o Copilot acelerando cada etapa, e compartilha o resultado por link seguro ou publicando nos painéis de um workspace. Toda a interface e as mensagens estão em português.

Acesse pelo menu DATTA BI›Dashboards.

Quando usar o DATTABI

• Dashboards operacionais ou analíticos com atualização programada.
• Exploração visual de dados heterogêneos (grafo + warehouse + índices de busca
  • arquivos + streams) num único painel.
• Transformação de dados sem escrever SQL ou DATTAX (pelos assistentes visuais de preparação) — ou com DATTAX avançado, para lógica complexa.
• Narrativa executiva gerada por IA, em PDF.
• Painéis ao vivo sobre Kafka, CDC, Neo4j CDC e polling de OpenSearch.

O DATTABI não substitui o chat operacional de fluxo, nem o DATTA Extract para cargas massivas de ELT — para isso, use o Extract com MATERIALIZE. O DATTABI é a camada de visualização e análise.

Workspaces

Um workspace agrupa dashboards, consultas DATTAX salvas e datasets preparados para um time ou um projeto — cada um com seu próprio controle de acesso.

1. Na barra lateral do DATTABI, clique em + Workspace.
2. Informe nome e descrição em pt-BR.
3. Pronto: os dashboards criados a partir daí ficam organizados nesse espaço.

Compartilhar um workspace

O dono do workspace (ou um administrador de plataforma) controla quem entra:

1. Passe o mouse sobre o workspace na barra lateral e clique no ícone de compartilhar (usuário +).
2. No diálogo Compartilhamento, informe o e-mail do usuário, escolha o papel e clique em Compartilhar.
3. Para trocar o papel de quem já tem acesso, use o seletor Pode visualizar / Pode editar; para remover o acesso, use o ícone de lixeira (com confirmação).

Quem recebeu o papel Pode visualizar enxerga o conteúdo mas não altera nada do workspace: dashboards, visuais, filtros, bookmarks, temas, modelos, datasets e atualização de dados ficam bloqueados para escrita, e a plataforma responde com uma mensagem amigável ("Você não tem permissão…") a qualquer tentativa. Compartilhamentos antigos, criados antes da existência do papel, continuam valendo como Pode editar.

Mudanças de papel valem imediatamente na própria tela, que invalida o cache de autorização na hora; em até 60 segundos nas demais sessões abertas. Quem recebeu o workspace por compartilhamento — mesmo com permissão de edição — não gerencia os compartilhamentos: só o dono ou um administrador.

A visibilidade das conexões dentro do workspace segue o modelo PRIVATE / WORKSPACE / PUBLIC descrito no guia de conexões.

Datasets e Modelos de outro workspace. Um visual só passa a usar um dataset — e um dashboard só é ligado a um Modelo — do workspace do próprio dashboard ou de um workspace que você também acessa; fora disso, a gravação (inclusive a importação de um dashboard) é recusada com uma mensagem amigável. Assim o painel nunca mostra, a quem o abre, dados de um workspace que o autor não lê.

Dashboards

Criar

1. Com o workspace selecionado, clique em + Dashboard.
2. Informe título, descrição e tags.
3. O dashboard nasce como rascunho (DRAFT) — não aparece para os usuários do workspace até ser publicado — e já vem com o tema da plataforma aplicado, incluindo modo claro/escuro automático.

Ciclo de vida

Um dashboard passa por três estados: rascunho (DRAFT) → publicado (PUBLISHED) → arquivado (ARCHIVED).

• Publicar torna o dashboard visível para o workspace e para quem recebeu compartilhamento.
• Arquivar o esconde das listagens preservando o histórico. Uma rotina noturna remove definitivamente os dashboards arquivados há mais de 90 dias.
• Restaurar versão: cada salvamento gera uma versão; a aba Histórico lista todas e permite voltar a qualquer ponto.
• Clonar cria uma cópia do dashboard, no mesmo workspace ou em outro, com todos os visuais — inclusive os ligados a um dataset ou a uma medida do modelo —, o layout, as páginas, os filtros, o tema e o modelo de dados.

Cada transição gera evento de auditoria (DASHBOARD.PUBLISH, DASHBOARD.ARCHIVE, DASHBOARD.RESTORE).

Tipos de visual

O catálogo completo, com exemplos ao vivo de cada visual, está na galeria de visuais.

Cada visual tem sua própria fonte (script DATTAX ou assistente de preparação de dados), sua política de atualização e reage aos filtros globais do dashboard — que são injetados como parâmetros no DATTAX.

Número grande, KPI e card: meta, tendência e cores

O número grande mostra um valor. Nas Propriedades do visual, a seção Meta e limiares acrescenta:

• Meta: arraste um campo para o well Meta ou digite um valor fixo. O cartão mostra quanto falta ou sobra e o percentual atingido.
• Tendência: arraste para o well Tendência a coluna do período (mês, data). O cartão compara o último período com o anterior e mostra uma seta.
• Limiares: diga se maior ou menor é melhor e informe os limites de verde e âmbar, sobre o valor ou sobre o percentual da meta. Abaixo do âmbar, o cartão fica vermelho.

Na Tabela, a formatação condicional de uma coluna também aceita ícones (setas ou semáforo), pelo valor da célula ou pela posição dela na coluna.

Pequenas múltiplas, matriz, heatmap e dispersão

• Pequenas múltiplas (barras, linha, área): arraste uma categoria para o well Pequenas múltiplas e o gráfico se repete, um painel por valor, até 12 painéis. Passando disso, o visual avisa; filtre para ver os demais.
• Matriz: arraste campos para Linhas, Colunas e Valores (com agregação). A matriz cruza as categorias, como uma tabela dinâmica. Com mais de 5.000 combinações, ela avisa em vez de cortar em silêncio.
• Heatmap: o well Valor define a cor de cada célula; sem ele, a célula conta as linhas.
• Dispersão: o well Tamanho define o tamanho de cada ponto.

Muitas categorias: barras de rolagem

Cada categoria de um visual de eixo (barras, colunas, empilhadas, linha, área, cascata, box plot, candlestick, histograma, heatmap) ocupa uma largura mínima. Quando as categorias não cabem no cartão, o visual ganha uma barra de rolagem no próprio eixo, e o eixo de valores fica parado:

Arraste a barra ou use Shift + roda do mouse sobre o visual. Rótulos longos aparecem truncados e inclinados; o nome inteiro está no tooltip. Aumentar o cartão mostra mais categorias de uma vez.

De onde vem o dado de cada visual

O rodapé de cada cartão mostra a fonte depois do número de linhas: o nome do dataset ou consulta própria — o visual que tem a própria DATTA Query, como os que a exportação do chat e os copilotos criam. A consulta própria prevalece sobre qualquer dataset.

• Ao abrir um dashboard, os datasets que alimentam os visuais dele ficam marcados como no painel na lateral, e um deles fica selecionado. A lateral também diz quantos visuais usam consulta própria.
• Clicar num visual seleciona o dataset dele: a lateral, os Campos disponíveis e as abas Dados e Análise R passam a mostrar esse dataset.
• Para trocar o dado de um visual, abra Propriedades e escolha o dataset. Num visual de consulta própria, a plataforma pede confirmação e substitui a consulta pelo dataset (os campos do visual recomeçam do zero); para desfazer, use o Versionamento. O visual é executado de novo na hora — sem recarregar a página.

Editar e salvar o layout

No modo de edição, você organiza o canvas arrastando e redimensionando os cards. O arranjo (posição e tamanho de cada card) é salvo automaticamente a cada arraste, em segundo plano, com um pequeno atraso de 350 ms para agrupar movimentos sucessivos — só o último arranjo é enviado.

Para gravar na hora e sair com segurança, clique em Salvar na barra superior (o botão só aparece no modo de edição, com um dashboard aberto). O arranjo atual é persistido imediatamente, sem esperar o atraso: o botão mostra "Salvando..." enquanto grava e, ao concluir, o aviso verde "Dashboard salvo." confirma a gravação. Em caso de falha, o aviso vermelho "Não foi possível salvar o dashboard. Tente novamente." instrui o retry — e nada se perde, o arranjo permanece no canvas. Se não houver dashboard aberto, o clique apenas avisa "Abra ou crie um dashboard antes de salvar.".

No modo telefone, o mesmo botão grava o layout mobile, independente do desktop (veja Layout mobile).

O que o botão salva. Apenas o arranjo do layout (posições e tamanhos). Edições de script DATTAX, filtros e configuração de visual são salvas pelos seus próprios fluxos — que também geram versão. O salvamento manual e o automático gravam o mesmo campo, sem conflito: o último a chegar vence.

Permissão. Salvar layout exige DATTABI_EDIT, verificada no servidor: sem ela, a operação é negada com 403 e evento de auditoria. O botão só aparecer no modo de edição é uma dica visual — a barreira real é o backend.

Rastreabilidade. Cada gravação (manual ou automática) captura uma versão com o motivo "Atualizacao", então todo save fica rastreável e restaurável pela aba Histórico.

Passo a passo

1. Abra o dashboard e entre no modo de edição.
2. Arraste e redimensione os cards até o arranjo desejado — o salvamento automático já grava em segundo plano.
3. Clique em Salvar para gravar imediatamente e ver a confirmação.
4. Para ajustar o layout do telefone, ative Ver > Layout mobile (360x640) e salve novamente.

Arranjo manual e Auto-organizar

Arranjo manual. Ao arrastar ou redimensionar um card, os vizinhos nunca são empurrados — o card em movimento simplesmente não pode ser solto por cima de outro. Isso torna trivial alinhar dois gráficos lado a lado na mesma linha.

Auto-organizar. No modo de edição, o botão Auto-organizar re-empacota os cards em prateleiras, na ordem de leitura (de cima para baixo, da esquerda para a direita), com três garantias de usabilidade:

1. Tamanho mínimo por tipo de visual — nenhum card fica menor que o padrão do seu tipo (barras e linha 6x4, tabela 8x5, KPI 3x3). Encolhimentos acidentais são desfeitos; ampliações feitas por você são preservadas.
2. Linhas preenchidas — cada prateleira é expandida (em rodízio, com teto de 2x a largura por card) até ocupar as 12 colunas: sem sobra à direita, sem um KPI sozinho virando banner de tela inteira.
3. Alturas alinhadas — os cards da mesma prateleira recebem a mesma altura (a maior da linha), alinhando as bordas inferiores.

O resultado é persistido pelo mesmo caminho do arraste.

Interagir com os visuais

• Clique num elemento de qualquer gráfico (barra, ponto da linha, fatia, célula da tabela, marcador do mapa, nó do grafo...) para filtrar os outros visuais pelo valor — o filtro cruzado. O visual clicado realça o elemento e esmaece os demais; clicar de novo no mesmo elemento desfaz o filtro. Editar interações escolhe, por par de visuais, entre filtrar, destacar ou ignorar.
• Passe o mouse para ver o tooltip. No editor, o well Tooltip acrescenta colunas a ele (até 10), com a agregação escolhida na engrenagem do campo.
• Duplo clique numa barra, numa coluna da linha ou da área, num degrau da cascata, numa fatia da pizza ou da rosca, num bloco do treemap ou numa etapa do funil desce na hierarquia (drill-down). Nesses visuais o clique simples espera um quarto de segundo antes de filtrar.
• No grafo, clique e duplo clique num nó filtram os outros visuais por ele. O clique também abre os detalhes do nó; o duplo clique expande os vizinhos e mantém o filtro (não o desfaz).
• O selo Filtro: … ✕ no topo mostra e limpa o filtro cruzado — também no painel aberto só para visualização.
• Botão direito num ponto abre Detalhar em <página> quando o dashboard tem uma página de detalhamento que aceita aquela coluna: a página abre filtrada pelo valor, com uma trilha para voltar. Para preparar a página, abra-a no modo de edição sem nenhum visual selecionado e, em Propriedades, marque Página de detalhamento (drill-through) e escolha os campos no well Drill-through.

Detalhes em Filtro cruzado e Drill-down e drill-up (documentação do DATTA BI).

Preparar dados

O painel de preparação transforma qualquer fonte em um dataset pronto para visualizar — sem depender de um engenheiro de dados a cada ajuste. São dois modos.

Assistente visual

Acionável pelo botão Preparar dados em cada visual. O assistente detecta o tipo da fonte da conexão selecionada e adapta os passos:

• Tabela relacional (JDBC) — escolha de schema → tabela → colunas → passos (FILTER, SELECT, MUTATE, GROUP BY, JOIN LOOKUP).
• Grafo (Neo4j) — escolha de labels → travessias → algoritmos GDS (PageRank, Louvain e outros).
• Índice (OpenSearch) — escolha de índice → campos → filtros, incluindo busca vetorial (KNN) e realce.
• Arquivo (CSV/Parquet/JSON/TSV) — o schema é detectado automaticamente; remova ou renomeie colunas à vontade.

Cada passo entra na lista Applied Steps (estilo Power Query), que você pode reordenar, editar ou remover. A cada mudança, a pré-visualização recarrega — com cache de duas camadas, os resultados aparecem em segundos.

Fonte de grafo leva o banco. O dataset de grafo guarda, junto com o rótulo, o banco Neo4j que o dataset do catálogo informa — a referência tem a forma neo4j:<banco>:<rótulo>, e a preparação lê exatamente esse banco. O banco nunca é adivinhado: sem ele, a pré-visualização, o perfil, a materialização e a análise R mostram A fonte Neo4j 'Processo' não informa o banco. Escolha o banco do contexto (o dataset do catálogo traz esse dado). — em vez de ler, em silêncio, o banco padrão do servidor e devolver uma tabela vazia. Dataset de grafo gravado antes desta regra, só com o rótulo, mostra a mesma mensagem: recrie-o a partir do dataset do catálogo.

Materializar o resultado

O botão Materializar grava o resultado da preparação num destino da plataforma — Auto, Iceberg (tabela analítica), Neo4j (grafo) ou OpenSearch (busca) — e registra o dataset no Knowledge Catalog. No destino Neo4j, o campo Banco de destino nasce vazio e é obrigatório: sem ele a tela avisa Informe o banco de destino. e não envia nada. O campo Contexto (opcional) diz a qual contexto o dataset materializado pertence no catálogo; vazio, ele entra sem contexto.

Modo avançado (DATTAX)

O botão Modo avançado, no topo do painel de preparação, mostra o DATTAX gerado pelos passos — que você pode editar livremente. O script fica salvo como dataset de preparação e pode alimentar qualquer visual. Veja a referência da linguagem DATTAX.

Pedir em português

O campo NL Prep recebe um pedido em linguagem natural e gera o DATTAX sugerido. Exemplo:

"pegue a tabela vendas do warehouse, filtre ano 2025, agrupe por região e ordene decrescente pelo total"

O Copilot usa o contexto do catálogo (conexões disponíveis e schemas descobertos automaticamente pela catalogação) para gerar o script — e você vê a diferença antes de aplicar.

Perfil dos dados

O botão Perfil gera um raio-X estatístico por coluna, sobre uma amostra de até 2.000 linhas do pipeline atual:

• Tipo inferido (numérico ou texto), contagem e percentual de nulos, e distintos.
• Colunas numéricas: mínimo, máximo, média, mediana e histograma em 10 faixas.
• Colunas de texto: valores mais frequentes, com contagem e percentual.

As estatísticas são calculadas dentro da plataforma, sem depender de nenhum serviço externo. Exige a permissão DATTABI_VIEW.

Importar ou consultar ao vivo

Cada dataset tem um modo de carga, alternável na barra do painel de preparação:

O modo fica persistido no próprio dataset (campo loadMode).

Avisos da execução

Quando algo não impede a consulta, mas muda o resultado, o motor DATTAX emite um aviso — e a tela o mostra numa caixa âmbar, com o ícone de alerta e a mensagem em português. Os casos mais comuns:

• A fonte voltou vazia. Nas execuções que você vê na tela, a plataforma pede ao motor o diagnóstico da consulta vazia, e o aviso diz o que não bate com o banco: um rótulo, uma aresta ou uma coluna que não existe, a direção de uma relação invertida, um literal num formato diferente do gravado.
• Uma etapa zerou as linhas, uma coluna não existe, a leitura foi truncada ou a projeção ficou sem colunas.

Onde os avisos aparecem:

Quando a execução falha — a tabela não existe, a conexão caiu —, a tela mostra a causa em vermelho, nunca uma tabela vazia. Os avisos também seguem para o Copilot, que passa a explicar o resultado vazio em vez de concluir que o dado não existe.

Modelo: relacionamentos e tabela de datas

Em Visualizar›Modelos você liga os datasets do Modelo e marca a tabela de datas:

• Relacionamentos propagam o filtro. Um clique, um filtro do painel Filtros ou da barra do topo sobre uma coluna que o visual não tem chega a ele pelas chaves do relacionamento ativo até um dataset que tem a coluna — respeitando a direção (SINGLE do lado "1" para o "muitos"; BOTH nos dois) e a sua segurança por linha. Acima de 1.000 chaves, ou com dois caminhos possíveis, o filtro não se aplica e o visual avisa por quê.
• Tabela de datas. No menu "..." do dataset, Marcar como tabela de datas escolhe a coluna de data: o visual de barras, linha ou área com essa coluna no eixo abre por ano e desce, com duplo clique, para trimestre, mês e dia.

Detalhes em Modelos e relacionamentos visuais.

Copilot

No editor de visuais

Ao editar um visual, a barra do Copilot aceita pedidos em pt-BR como "adiciona uma série que mostra a diferença percentual vs ano anterior" — e o Copilot edita o DATTAX do visual em linha.

No dashboard publicado ("Perguntar ao dashboard")

Na barra superior do dashboard publicado, o Copilot responde perguntas em linguagem natural sobre os dados já renderizados. O contexto é montado a partir do último resultado de cada visual que você abriu — uma amostra das linhas, o total e os avisos da execução — e enviado ao modelo, que pode resolver cálculos adicionais executando DATTAX quando necessário. Visual vazio com aviso chega ao modelo com o motivo: ele explica por que o painel está vazio e propõe a correção, em vez de responder que não há dado. O resultado de cada visual fica guardado por cinco minutos (padrão); visual que não foi renderizado nesse intervalo entra só com título, tipo e consulta.

Proteções aplicadas:

• Acesso — a cada requisição, antes de montar o contexto, a plataforma confere se você é dono do dashboard, se recebeu compartilhamento ou se apresentou um token de link válido.
• Limite de uso — 20 requisições por minuto e 200 por hora, por usuário.
• Privacidade — o prompt instrui o modelo a recusar respostas que exponham campos marcados como sensíveis (pii=true) pela catalogação.

Atualização automática dos visuais

Defina quando cada visual — ou o dashboard inteiro — se atualiza, pelo diálogo Agendar refresh:

O agendador usa virtual threads e uma coordenação distribuída para que, mesmo com várias instâncias da plataforma no ar, cada execução aconteça uma única vez. Os resultados de render ficam em cache de duas camadas (memória + cache compartilhado com TTL).

Para a atualização dos datasets materializados (completa ou incremental, com histórico e reversão), veja o agendador de atualizações.

Compartilhar por link

O diálogo de compartilhamento cria links de acesso ao dashboard:

• Visibilidade — apenas membros do workspace (o link só funciona para quem já tem acesso pelo relacionamento de compartilhamento) ou protegido por senha (link aberto que exige a senha que você definir, guardada de forma segura e nunca legível). Por decisão de segurança, dashboards do DATTABI não oferecem link público anônimo, ainda que o modelo de link suporte token assinado.
• Expiração — opcional, até 90 dias no futuro.
• Limite de aberturas — opcional; o link deixa de funcionar depois de N visualizações.
• Revogação — um administrador pode revogar um link instantaneamente, e a revogação é conferida a cada acesso.

O link abre uma página de leitura dedicada, sem barra superior. Todo acesso por link gera evento de auditoria (SHARE.VIEW).

Publicar nos painéis de um workspace

Em Compartilhar > Publicar no workspace, o dashboard vira um painel do workspace escolhido. A partir daí ele aparece em Sistema›Workspaces›Painéis e fica acessível automaticamente a todos com acesso àquele workspace. No gerenciador de workspaces, painéis publicados exibem o selo Dashboard BI e o botão Abrir dashboard. Veja o guia de painéis.

Exportar

O diálogo de exportação gera relatórios prontos para distribuir:

• PDF — com opção de narrativa executiva gerada pelo Copilot no início do documento, em três estilos (executiva, tecnica, storytelling), e rodapé com número de página e data/hora. O limite é de 20 páginas por exportação; acima disso o PDF sai truncado, com aviso claro.
• PNG — a imagem é rasterizada no próprio navegador e enviada à plataforma, que a empacota.
• CSV — um arquivo compactado com um CSV por visual, com escape correto de quebras de linha e aspas. Limite de 100 mil linhas por visual.
• JSON — o pacote .dattabi.json (dashboard, visuais e filtros), que o botão Importar recria em outro workspace ou em outra instância. Cada visual leva a sua fonte: script DATTAX, medida do modelo ou dataset com os campos. A importação segue as regras de criar um visual: um visual cujo dataset não está num Modelo do DATTA Prep, ou cujos campos não são válidos, recusa o pacote inteiro, com o nome do visual na mensagem, e nada é gravado.

Há um limite de 5 exportações por minuto por usuário.

As exportações e a miniatura da galeria aplicam as mesmas regras de segurança por linha do Modelo do painel que a tela aplica: quem tem papel restrito recebe no arquivo apenas as linhas que vê no dashboard. Os papéis que valem são os da sua sessão — os mesmos que definem as suas permissões. Se a regra não puder ser verificada, o visual sai vazio — nunca com todas as linhas.

Versionamento

Toda mudança em layout, script DATTAX ou configuração de visual cria uma versão do dashboard:

• A aba Histórico lista as versões com autor, data/hora e o delta da mudança.
• Restaurar aplica a versão ao rascunho atual — não publica automaticamente.
• As versões ficam no grafo, ligadas ao dashboard pelo relacionamento TEM_VERSAO.
• A versão guarda a fonte de cada visual (script, medida ou dataset com os campos) e o modelo de dados do dashboard. Uma versão antiga, gravada antes de o histórico guardar a medida e o dataset, restaura esses visuais sem fonte: ligue o dataset de novo no painel de campos.

Painéis ao vivo (streaming)

Painéis alimentados por DATTAX de streaming atualizam sozinhos, sem recarregar a página.

Criar um painel de stream

1. Adicione um visual do tipo Stream.
2. Escreva o DATTAX começando em FROM STREAM <KIND> "<nomeDaConexao>".
3. Termine com |> STREAM OUTPUT.
4. O painel abre um canal WebSocket com a plataforma (com SSE como alternativa) e mostra os eventos chegando ao vivo, com pausa e retomada.

Fontes suportadas

Antes de assinar, a plataforma valida se a fonte suporta streaming nativo:

Limitações atuais

• JOIN entre dois streams — rejeitado. Só há JOIN ... AS LOOKUP (enriquecimento por consulta de referência).
• Buffer de replay — os últimos 100 eventos são reapresentados na reconexão. Para replay completo, consuma com STARTING FROM EARLIEST ao criar a assinatura.
• Estado — até 10 mil chaves abertas por assinatura; acima disso, o estado transborda para o cache da plataforma (impacto de latência de cerca de 5 ms).
• Limite de uso — 10 eventos por segundo por usuário (configurável).

Detalhes em DATTAX — streaming e no runbook de streaming.

Para cruzar fontes por chave (JOIN) em tempo real ou em lote, use a consulta DATTAX personalizada da Criação rápida, que aceita |> JOIN (...) ON ....

Criação rápida

O DATTA BI oferece dois caminhos para montar um dashboard:

1. Modelagem completa (preparação → modelo de dados → dataset → visual) — para tratar o dado antes de visualizar. Continua disponível como sempre.
2. Criação rápida — para mostrar o dado de uma fonte já existente na plataforma, sem a etapa de modelagem.

O botão Criação rápida, na barra do dashboard, abre um diálogo com duas abas. Em um só passo ele cria um dataset (com a consulta já derivada — renderiza na hora), um modelo de dados automático ligado a esse dataset (que fica de primeira classe e refinável depois na preparação) e um dashboard no seu espaço, com um visual em lista (tabela).

Aba "Fontes de dados" (multi-fonte)

Lista as fontes catalogadas da plataforma (Neo4j, OpenSearch, Trino, agentes JDBC) e permite mesclar várias fontes num único painel. Para cada fonte você escolhe:

• o tipo — Neo4j, OpenSearch, Trino, JDBC ou Kafka (tempo real);
• o recurso — label do grafo, índice, catálogo Trino, agente JDBC ou tópico Kafka — e, quando aplicável, a tabela e o database/schema;
• para Neo4j, o banco do grafo — obrigatório. O painel lê exatamente esse banco; sem ele a fonte fica incompleta e o painel não é criado, porque o banco nunca é adivinhado;
• quais campos projetar (multi-seleção), útil para alinhar colunas entre fontes de schemas diferentes.

Use + Adicionar fonte para empilhar quantas fontes quiser. A mescla é feita por UNION por nome de coluna: os registros de todas as fontes são empilhados, e as colunas ausentes em uma fonte ficam nulas.

Ao escolher um tópico Kafka, o diálogo avisa que a fonte é de tempo real: na Criação rápida o Kafka entra como fotografia em lote (as últimas mensagens do tópico), não como atualização contínua ao vivo — para o ao vivo, veja Painéis ao vivo. Se o broker ou o tópico estiver indisponível, o painel mostra a tabela vazia em vez de quebrar.

Aba "Consulta personalizada"

Um campo de texto para escrever DATTAX completo — junções, agregações e filtros que a interface multi-fonte não modela. O botão Validar confere a sintaxe antes de criar. Esta é a via para cruzar fontes por chave (JOIN) ou agregar; a aba de fontes só faz UNION (empilha registros).

Precedência e validação

A Criação rápida exige a permissão DATTABI_EDIT. Quando mais de uma opção é informada, a precedência é: consulta personalizada (até 20 mil caracteres) > multi-fonte (UNION) > fonte única (o caminho legado, mantido para clientes antigos). Todos os identificadores de fonte, tabela e campo são validados antes de compor a consulta — nomes fora do padrão seguro são rejeitados; e no caso do Kafka o broker nunca vem do pedido: a conexão é resolvida no servidor.

Onde o dashboard fica

O dashboard nasce no seu espaço (você é o dono). Para distribuí-lo, use o compartilhamento por link ou publique-o nos painéis de um workspace.

Recursos avançados

Análise estatística com R

No modo Editar, a aba Análise R do painel direito roda um script R sobre uma amostra do dataset selecionado:

• O data.frame de entrada chega como .dattax_in; o resultado final deve ser .dattax_out (ou a última expressão, um data.frame).
• O botão Pedir em pt-BR gera o script pelo Copilot.
• Executar roda o script em ambiente isolado e devolve o data.frame resultante.

Exige a permissão DATTABI_R_EXECUTE. Veja o guia de análise estatística com R.

Gerar dashboard com IA

O botão Gerar com IA, na barra superior, abre um diálogo onde você descreve o painel em português e, opcionalmente, seleciona datasets do workspace. O Copilot propõe os gráficos em pré-visualização e, ao confirmar, cria e abre o dashboard pronto — devolvendo o identificador do dashboard, o workspace, o endereço de abertura e um resumo. Exige a permissão DATTABI_EDIT e, para gravar, permissão de edição no workspace de destino. Só entram na proposta os datasets de workspaces que você acessa.

Temas visuais

Em DATTA BI›Temas, o editor oferece:

• Aba Visual — seletores de cor para a paleta (primária, secundária, destaque, fundo, texto), cores das séries dos gráficos (com adicionar e remover), fontes e pré-visualização ao vivo.
• Aba Avançada (JSON) — edição e importação do JSON do tema (caminho legado).

Temas existentes podem ser editados pelo botão Editar no card e definidos como padrão do workspace.

Layout mobile

No menu Ver > Layout mobile (360x640), o canvas passa a um frame de telefone com grade de 4 colunas. O layout mobile é independente do desktop. A ação Copiar layout do desktop semeia o mobile empilhando os visuais em coluna única, na ordem de leitura — um ponto de partida para ajustar. Salve normalmente; o layout do telefone não interfere no do desktop.

Linhagem de dados

O grafo de linhagem inclui nós de Dashboard e Chart, além de Dataset, Processo e Coluna. As arestas são gravadas de forma idempotente:

• ao salvar um visual: (Dashboard)-[CONTAINS]->(Chart) e (Dataset)-[FEEDS]->(Chart);
• ao materializar na preparação: (dataset materializado)-[DERIVES_FROM]->(fonte).

A instrumentação é best-effort (dispara e segue) e nunca quebra o fluxo de salvar ou materializar — você sempre sabe de onde veio cada número, sem risco para a operação.

Galeria e modo somente-visualização

Para consumo (e não autoria), o DATTABI oferece duas telas pensadas para quem só quer ver os painéis prontos, sem risco de editar.

Galeria do DATTA BI

A entrada Galeria, no menu lateral dentro do grupo DATTA BI, mostra uma grade de miniaturas de cerca de 3,5 polegadas de todos os dashboards do BI, agregando os workspaces em paralelo.

Cada card prioriza o screenshot real do dashboard: o próprio navegador rasteriza o DOM já renderizado — cards, tabelas (com a formatação condicional), slicers, SVGs e canvases saem exatamente como na tela, nenhum objeto se perde — depois que todos os objetos terminaram de renderizar (gráficos concluídos, fontes carregadas, imagens decodificadas e uma folga para as animações). A imagem é então reduzida com alta qualidade para 3,4 polegadas de largura (653 px a 192 dpi, com a densidade física gravada no próprio PNG) e publicada. O desenho sintético gerado no servidor é apenas o fallback enquanto nenhum screenshot foi publicado.

Quando a galeria recebe um card ainda sintético, ela regenera o screenshot em segundo plano: um quadro oculto carrega o dashboard de verdade, espera a renderização completa, fotografa, publica — e o card se atualiza sozinho. Para não sobrecarregar, a regeneração acontece um dashboard por vez. Qualquer mudança em dashboard ou visual invalida todas as variantes da miniatura, e a próxima visita à galeria dispara a recaptura.

• Campo de busca por nome do dashboard ou nome do workspace.
• Estados de carregando, vazio e erro em pt-BR, com botão Tentar novamente no erro, sem recarregar a página.
• Clicar num card abre o dashboard travado em modo somente-visualização, sem sair do shell.

Modo somente-visualização

O dashboard aceita os parâmetros ?mode=view (ou ?viewer=1) na URL. Nesse modo:

• O dashboard nasce travado: o botão de editar dá lugar à pílula estática Visualização; a barra de ações (Exportar, Salvar, Gerar com IA, Editar interações), o menu de contexto e o chip de modelo ficam ocultos.
• A barra lateral esquerda (lista de dashboards e campos) e o painel direito (Propriedades, Preparação, Copilot) ficam escondidos; o canvas ocupa a largura total.
• Você continua interagindo com o painel: filtros do topo, filtro cruzado (clicar num visual filtra os demais), drill-down e drill-up e drill-through (botão direito → Detalhar em).

É o modo usado tanto pela Galeria quanto pela galeria Painéis do workspace (veja workspaces) ao abrir um dashboard de BI.

Visualizar painéis de canvas sem o construtor

Painéis de canvas (montados no construtor de painéis) têm um modo embed (?embed=1) que renderiza o painel sem nenhuma barra de construção — usado para abrir o painel em visualização limpa, sem expor o construtor.

Na galeria Painéis do workspace, um painel de canvas aparece quando está publicado: o toggle Publicar na galeria do construtor marca o painel, e a galeria o mostra ao lado dos dashboards do BI, dos nativos e dos vinculados (veja workspaces). Um administrador pode tirar os painéis de canvas da galeria desligando datta.paineis.canvas-na-galeria (ligado por padrão); com ele desligado, o próprio toggle avisa que o painel não vai aparecer.

Solução de problemas

Toda falha exibe mensagem clara em português com a opção Tentar novamente, e as operações longas continuam em segundo plano, sem travar a tela. As ações do usuário são registradas na trilha de auditoria da plataforma.

Os endpoints usados por esta tela — workspaces e compartilhamentos, dashboards e versões, exportação, links de compartilhamento, Copilot, Criação rápida, datasets, miniaturas, perfil de dados, execução de R, validação de DATTAX, assinatura de streams e linhagem — estão catalogados na referência de API.