Pular para o conteúdo
obm.
API
Conceitos técnicos

Natural key (chave natural)

1 min de leitura
MDX
Definição

Natural key é a chave de negócio que identifica um ativo de forma estável — CNPJ+classe, ISIN, código — em vez de um id artificial sequencial gerado pelo banco de dados.

Natural key (chave natural) é o identificador de um registro que vem do próprio domínio de negócio — CNPJ mais classe de fundo, ISIN, código do papel — em oposição à surrogate key, um id artificial sequencial criado pelo banco. A chave natural carrega significado; a artificial é só um número interno.

O que isso significa na prática

Numa base que ingere dados de várias fontes (CVM, B3, ANBIMA) ao longo do tempo, a chave natural é o que permite reconciliar o mesmo ativo entre cargas. Se um fundo muda de nome ou de administrador, o id interno do banco não ajuda a casar o registro novo com o antigo; o CNPJ casa. Por isso a identidade de um ativo se ancora na chave de negócio estável, e a surrogate key fica só como ponteiro interno entre tabelas.

A regra de ouro: escolher como chave natural um atributo que não muda. CNPJ e ISIN são bons candidatos. Nome comercial e razão social não são — mudam, e quebram o casamento.

Como aparece nos dados reais

Nenhum fundo disponível para este filtro no momento.

Cuidados

Chave natural exige que o atributo seja realmente único e estável; se o campo fonte vier sujo ou nulo, o casamento falha em silêncio e gera ativo duplicado. Composições (CNPJ + classe) são comuns justamente porque um único campo nem sempre identifica o ativo sozinho. Validar unicidade na ingestão evita arrastar duplicata para o resto da base.

Fonte oficial

ISO 6166, norma que define o ISIN como chave natural padronizada de valores mobiliários.

Termos relacionados

355 termos, todos com dado vivo
Cada conceito do mercado brasileiro, explicado e conectado.
Ver glossário completo