DATTABI — Conexões e Auto-Catalog

No DATTA, conectar uma fonte já é catalogar. Toda fonte externa consumida pelo DATTABI (Neo4j, OpenSearch, bancos relacionais via JDBC, Kafka e outras) passa pelo cadastro central de conexões da plataforma (Diretrizes do Projeto §7) e, assim que a conexão nasce, a catalogação automática — ACOC, Auto-Catalog On Connect — descobre e publica os datasets no catálogo. Eles aparecem no DATTABI prontos para usar, em tempo real, sem nenhum passo manual de mapeamento. Este guia explica o fluxo do ponto de vista do DATTABI.

Onde cadastrar uma conexão

Todos os caminhos levam ao mesmo cadastro central:

1. Sistema›Conexões — a página de administração dedicada.
2. DATTABI — Preparar Dados — o botão Adicionar conexão no painel "Preparar Dados" do editor de dashboards.
3. Extract Pipeline, Extract Quick e Catálogo de Dados — os mesmos pontos de entrada compartilhados.

O cadastro é idempotente: a impressão digital sha256(tipo + host + porta + banco + usuário) garante que reutilizar a mesma configuração devolva a mesma conexão, nunca uma duplicata.

Catalogação automática ao conectar (ACOC)

Assim que a conexão é criada com sucesso, a plataforma dispara uma varredura em segundo plano que:

1. Introspecciona schemas, tabelas, labels e índices da fonte.
2. Coleta métricas de qualidade — atualidade, completude, contagem de valores distintos e detecção de dados pessoais (PII).
3. Guarda uma amostra de 100 linhas para pré-visualização.
4. Publica cada dataset descoberto no Knowledge Catalog.
5. Emite os eventos de auditoria CONNECTION.AUTO_CATALOG_STARTED | COMPLETED | FAILED.

Não há opt-out para o usuário comum. O administrador pode desabilitar a catalogação de uma conexão individual pela própria interface, com justificativa registrada.

Como o DATTABI consome as fontes

• A lista de datasets disponíveis é filtrada pelo workspace e pelas suas permissões — você só vê o que pode ver.
• Cada dataset carrega o seu script DATTAX de base, que é a consulta inicial (FROM GRAPH, FROM JDBC, FROM INDEX, etc.). Ao montar um visual, a plataforma envolve essa consulta com os bindings que você definiu (eixos X e Y, agregação, filtros e drill) e gera o DATTAX final.
• Os resultados de renderização ficam em cache por 5 minutos, por gráfico e combinação de filtros — reabrir o mesmo dashboard é instantâneo.

Os caminhos de API para listar datasets do workspace, cadastrar conexões e publicar datasets no catálogo estão na referência de API.

Credenciais

Senhas nunca circulam nem são armazenadas em texto claro. Todo cadastro de conexão com senha passa pelo cofre de credenciais da plataforma, que cria um vínculo por usuário — e nenhuma resposta da plataforma jamais devolve a senha.

Escopo e visibilidade

• Por workspace: datasets e conexões pertencem a um workspace; quem tem a permissão DATTABI_VIEW enxerga apenas os workspaces de que é membro.
• Administrador global: quem tem PLATFORM_ADMIN enxerga tudo, para governança e suporte.

Anti-patterns (rejeitados em review)

• Componente que abre conexão direto, sem passar pelo cadastro central.
• Fixar endereço de Neo4j ou OpenSearch na configuração de um componente específico.
• Criar uma conexão sem disparar a varredura de catalogação (o ACOC é obrigatório).
• Guardar senha em arquivo de configuração.