Ficha do Ativo e Linhagem observada

Quem vai usar um dataset precisa de três respostas antes de confiar nele: o que é, de onde veio e quem responde por ele. A Ficha do Ativo reúne as informações que respondem a isso numa vista só — e a aba Linhagem mostra, a partir do que realmente rodou, quem lê e quem grava cada ativo.

Onde a Ficha aparece

A mesma ficha abre em três lugares:

• Knowledge Catalog › Descoberta — clique num card de dataset. O painel de detalhe traz a ficha inteira e, abaixo dela, a lista de colunas.
• Knowledge Catalog › Conhecimento — na busca semântica, clique num resultado: o detalhe mostra a ficha e a classificação por LLM.
• Governança de Dados — depois de selecionar um dataset, a ficha aparece abaixo da governança atual.

O dataset é identificado pela chave natural que você vê em cinza sob o nome (por exemplo neo4j:FEBRABAN:Empresa ou opensearch:datta_bcb). É a mesma chave em todas as telas, na API e na linhagem.

As seções

Cada seção carrega de forma independente: se uma estiver indisponível, as outras continuam aparecendo.

Colunas: o dicionário de dados

A seção Colunas responde "o que significa esta coluna?" — a pergunta que a descrição do ativo não alcança. Clique em Descrever na linha da coluna, escreva até 300 caracteres e salve; o texto passa a aparecer para todo mundo, com quem escreveu e quando.

Coluna ainda não descrita continua na lista, com o tipo e o convite para descrever: nenhum ativo perde a seção por não ter o campo. O contador ao lado do título (3/28 descritas) mostra o quanto do dicionário já está escrito, e o filtro acha a coluna pelo nome em ativos largos.

A descrição é curada por gente e só muda quando alguém a edita. Nulos, unicidade e distribuição da mesma coluna são medidos e ficam na seção Qualidade, reescritos a cada profiling.

Certificação

O selo ✓ Certificado diz ao analista "este é o ativo de referência". Aparece no card da Descoberta, no resultado da busca do Conhecimento e no nó da aba Linhagem. Depreciado avisa que o ativo não deve mais ser usado — use o campo Motivo para dizer o que usar no lugar. Na busca do Conhecimento os certificados vêm primeiro, e a caixa Só certificados filtra os demais.

Certificar exige a permissão DATASET_CERTIFY (administrador e usuário avançado). Sem ela o botão responde "Você não tem permissão para esta ação".

Documentação e busca

O que você escreve na seção Documentação é gravado num índice próprio e vetorizado com o modelo de embedding ativo da plataforma. A busca do Conhecimento passa a encontrar o dataset pelo texto da documentação — o resultado vem marcado via documentação quando só a documentação casou. Se o serviço de embeddings estiver fora do ar, o texto é gravado mesmo assim e o vetor fica para a próxima gravação.

Tags na busca

Na aba Conhecimento, o campo Filtrar por tag restringe a busca aos datasets com aquela tag. As tags são normalizadas (minúsculas, hífen no lugar de espaço): Dados Pessoais e dados-pessoais são a mesma tag.

Linhagem observada

A aba Linhagem do Knowledge Catalog mostra o grafo de datasets e processos em três camadas:

• Observada (padrão) — o que de fato leu e gravou dado: cada execução de um pacote do Datta Extract, cada ingestão de documento e cada consumo por chat ou relatório. A espessura da seta cresce com o número de execuções.
• Arquitetura — a topologia declarada dos serviços da plataforma (só existe quando o administrador liga o bootstrap de arquitetura).
• Todas — as duas juntas.

Selecione um nó para ver, no painel à direita, quantas vezes ele executou, a última execução e o que vem de e o que alimenta ele. Num dataset, o botão Abrir no catálogo leva à Ficha do Ativo. O filtro de contexto acompanha o workspace ativo.

Se a aba mostrar "Nenhuma execução observada", é porque nenhum pacote do Extract rodou ainda naquele contexto: execute um pacote e volte — a linhagem aparece assim que a execução termina.

Permissões

Toda mudança fica na trilha de auditoria com quem fez e quando.