Catálogo de dados que o negócio consegue usar

Estante de pastas de dados, cada uma com selo de dono e relógio de atualização

Catálogo de dados útil tem dono, definição e frescor. Uma lista de tabelas sem responsável vira wiki que ninguém abre na hora da dúvida. A pessoa precisa encontrar a métrica, entender o que ela inclui e saber se o número de hoje já chegou.

Catálogo não é o inventário técnico completo no primeiro dia. É o conjunto de dados que a reunião já usa, descrito do jeito que a pergunta aparece. Tabela sem pergunta pode esperar. Métrica que dois times calculam diferente não pode.

Pessoa puxando uma pasta da estante e vendo o selo de dono e o relógio de frescor
Achar a métrica inclui achar quem responde por ela e quando o número foi atualizado.

Qual pergunta o catálogo responde?

Responde quatro coisas, na mesma ficha: o que o número significa, de onde vem, quem é o dono e até quando ele vale. Se a ficha só tem o nome da tabela e uma descrição de uma linha, ela não evita a mensagem “qual receita eu uso?”.

A definição é a de negócio. “Soma do pedido faturado, sem frete, no dia da nota” é definição. “Campo amount da tabela orders” é localização. As duas cabem na ficha, e a primeira vem antes, porque é a que a pessoa compara com a reunião.

Quem é dono, e dono de quê?

Dono é quem responde quando o número muda de significado. Pode ser uma área, com uma pessoa nomeada, não um comitê sem nome. O time de dados mantém a ficha atualizada. Não substitui o dono de negócio na decisão de incluir ou não o cancelamento.

Dado sem dono não entra no catálogo como recomendado. Pode existir num inventário técnico, marcado como sem definição. Publicar tudo com o mesmo selo faz a pessoa confiar na tabela abandonada tanto quanto na métrica oficial.

Como mostrar frescor sem virar monitoramento?

A ficha mostra a última carga bem-sucedida e o atraso tolerado. “Atualizado hoje às 7h, atraso aceito até 9h” basta para a pessoa decidir se usa o número na reunião das 10h. Gráfico de pipeline fica na observabilidade. O catálogo só precisa do estado que muda a decisão.

Frescor vencido aparece na ficha e, se a métrica é oficial, no próprio relatório. Esconder o atraso no catálogo e mostrar o número normal no dashboard é o pior combinado: a documentação avisa e a tela que a diretoria abre não avisa.

Campo da fichaExemploNão serve
DefiniçãoPedido faturado, sem frete, pelo dia da nota“Receita da empresa”
OrigemNota fiscal do ERP, carga da manhã“Vem do banco”
DonoControladoria, pessoa nomeada“Time de dados”
FrescorÚltima carga e atraso aceito“Quase em tempo real”
Não incluiFrete, cancelamento do dia seguinteSilêncio sobre a exceção

Por onde começar, se já existem centenas de tabelas?

Comece pelas métricas que já travam reunião: receita, pedido, margem, lead, o que for o vocabulário da empresa. Uma dezena de fichas usadas toda semana vale mais do que um crawler que listou o banco inteiro. O inventário automático pode alimentar a localização. Não escreve a definição.

Cada ficha nova nasce de uma dúvida real. Se ninguém perguntou, a ficha espera. Isso mantém o catálogo pequeno o bastante para o dono revisar. Catálogo que cresce por varredura, sem revisão, volta a ser lista.

Como a pessoa encontra, em vez de só o analista?

A busca usa a palavra da pergunta, não o nome da tabela. “Receita faturada” acha a ficha mesmo que a coluna se chame net_amount. Sinônimos entram na ficha: os nomes que comercial, financeiro e produto usam para a mesma coisa, e os nomes que parecem iguais e são outra métrica.

O caminho até o relatório também está na ficha. Achar a definição e não achar onde o número aparece faz a pessoa voltar para a planilha antiga. Link para o painel oficial, com o mesmo nome da ficha, fecha o circuito.

Como o catálogo não apodrece?

Toda mudança de regra de negócio passa pela ficha no mesmo ciclo em que muda o número. Dono revisa as suas fichas numa cadência curta. Ficha sem revisão no prazo perde o selo de oficial e continua visível como desatualizada. Sumir com ela esconde o problema.

Um exemplo: a controladoria decide tirar o bonificado da receita. A ficha muda a definição e a data de vigência no dia em que o painel muda. O relatório do mês anterior permanece com a definição da época, apontada na própria ficha. Sem a data de vigência, a pessoa compara dois meses que não medem a mesma coisa e acha que o catálogo mentiu.

Checklist prático

O catálogo presta quando a dúvida da reunião se resolve na ficha, sem uma segunda reunião.

  • Ficha com definição, origem, dono e frescor
  • Dono de negócio nomeado, separado de quem mantém a ficha
  • Palavra da pergunta na busca, não só o nome da tabela
  • O que a métrica não inclui escrito na ficha
  • Selo diferente para dado oficial e dado sem definição
  • Link para o relatório que usa aquela definição
  • Vigência quando a regra muda, para o mês antigo continuar explicável
  • Revisão com prazo, e perda de selo quando a revisão atrasa

Erros comuns

O catálogo que ninguém abre em geral nasceu de um destes atalhos.

  • Listar todas as tabelas e chamar a lista de catálogo
  • Descrição de uma linha, sem dizer o que entra e o que fica fora
  • Dono genérico “dados” para métrica que o financeiro define
  • Não mostrar se a carga de hoje já chegou
  • Busca só pelo nome técnico da coluna
  • Mudar a regra do número e esquecer a ficha
  • Esconder a ficha vencida em vez de marcar que perdeu o selo
  • Começar pelo inventário completo antes das métricas que travam a reunião

Onde a ficha entra no uso do dado?

Num trabalho de dados, tecnologia e automações, o catálogo é a porta de entrada: a pessoa acha a definição oficial antes de abrir outro relatório.

Perguntas frequentes

▸Catálogo é o mesmo que documentação do banco?

Não. A documentação técnica lista coluna e tipo. O catálogo responde o que o número significa, quem é o dono e se ele está fresco. Uma pode apontar para a outra. Publicar o dicionário técnico no lugar da ficha não evita a discussão de receita.

▸Preciso catalogar todas as tabelas?

Não no começo. Catalogue as métricas que a reunião já usa e que hoje têm mais de uma definição. O restante pode ficar num inventário sem selo de oficial. Varredura completa sem dono vira lista que ninguém mantém.

▸Quem escreve a definição?

A área que responde pelo número, com o time de dados ajudando a ligar a definição à origem. Se o financeiro diz o que é receita, a ficha não pode ser escrita só por quem modelou a tabela. Dono genérico não serve.

▸Como lidar com duas receitas legítimas?

Com duas fichas, nomes diferentes e o uso de cada uma. “Receita faturada” e “receita para comissão” podem coexistir. O erro é chamar as duas de receita e deixar a pessoa descobrir a diferença no meio da reunião.

▸O que fazer quando a carga atrasa?

A ficha e, se a métrica é oficial, o relatório mostram o atraso. A pessoa decide se usa o número. Esconder o atraso no dashboard e anotar só no catálogo faz a documentação avisar quem não está na reunião.

▸Com que frequência revisar?

Quando a regra muda, no mesmo ciclo, e numa cadência curta mesmo sem mudança, para confirmar que a ficha ainda vale. Ficha sem revisão no prazo perde o selo. Ela continua visível, marcada como desatualizada.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *