Dicionário de dados: o documento que evita mal-entendidos
O que é um dicionário de dados, quais informações ele deve conter e como criá-lo e mantê-lo atualizado para que todos interpretem os dados da mesma forma.
2 min de leituraPor Equipe CavData
"Esse campo é a data do pedido ou a data do faturamento?" "Esse valor já inclui impostos?" "O que significa o status 3?" Perguntas assim consomem tempo de analistas e geram interpretações diferentes do mesmo dado. Um dicionário de dados existe para responder a elas de uma vez por todas.
O que é
É um documento, ou uma ferramenta, que descreve os dados de uma base ou sistema: quais tabelas existem, o que cada campo significa, quais valores são possíveis e de onde a informação vem.
É, em outras palavras, o manual de leitura dos dados da empresa.
O que registrar
Para cada tabela ou conjunto de dados
- Nome e descrição em linguagem de negócio.
- Origem: de qual sistema ou processo os dados vêm.
- Frequência de atualização.
- Responsável.
- Granularidade: o que cada linha representa.
Para cada campo
- Nome técnico e nome de negócio.
- Descrição clara do significado.
- Tipo de dado: texto, número, data.
- Valores possíveis, quando houver uma lista, com o significado de cada código.
- Regras de cálculo, para campos derivados.
- Se é obrigatório.
- Se contém dado pessoal ou sensível.
Para indicadores
- Nome e definição de negócio.
- Fórmula, com numerador, denominador e filtros.
- Periodicidade.
- Responsável.
Um exemplo simples
| Campo | Descrição | Tipo | Observações |
|---|---|---|---|
| data_pedido | Data em que o cliente confirmou o pedido | Data | Não é a data de faturamento |
| valor_liquido | Valor do pedido após descontos, sem impostos | Número | Em reais |
| status | Situação do pedido | Código | 1 = aberto, 2 = faturado, 3 = cancelado |
| email_cliente | E-mail de contato do cliente | Texto | Dado pessoal |
Benefícios
- Menos dúvidas e retrabalho para quem analisa dados.
- Interpretações consistentes entre áreas.
- Integração mais rápida de novas pessoas.
- Apoio à LGPD, ao identificar onde estão os dados pessoais.
- Base para automações e integrações, que dependem de entender os campos corretamente.
Como criar sem paralisar o trabalho
- Comece pelos dados mais usados, como os que alimentam os principais painéis.
- Envolva quem conhece: a área de negócio explica o significado, a equipe técnica explica a estrutura.
- Use um formato simples e acessível a todos.
- Cresça aos poucos, documentando novos dados à medida que entram em uso.
Como manter atualizado
O maior desafio não é criar, e sim manter. Algumas práticas ajudam:
- Atualizar o dicionário como parte de qualquer mudança em sistemas ou painéis.
- Definir um responsável pela sua manutenção.
- Revisar periodicamente os itens mais consultados.
- Disponibilizar o dicionário perto de onde os dados são usados, como nos próprios painéis.
A CavData documenta dados e indicadores nos projetos que desenvolve. Conheça o serviço de dashboards e automações.