O BSON (Binary JSON) é um formato binário de serialização usado pelo MongoDB para armazenar documentos. Serializar significa transformar o documento em uma sequência de bytes que outro componente consegue ler seguindo o mesmo formato.
Cada campo inclui uma indicação de tipo, seu nome e o valor codificado. Além de strings e booleanos, o BSON distingue tipos como o ObjectId, usado para identificadores, e a data. Os números também podem ter representações diferentes, como inteiro de 32 bits ou Decimal128.
Como um ObjectId aparece em texto
O JSON comum não tem um tipo próprio para ObjectId. O MongoDB oferece o Extended JSON para expressar essa informação em texto. Neste exemplo didático, o campo _id contém um ObjectId representado com o marcador $oid:
{ "_id": { "$oid": "507f1f77bcf86cd799439011" }}Um leitor compatível com o Extended JSON interpreta o marcador e reconstrói o ObjectId. Um parser JSON comum lê apenas um objeto com a propriedade $oid. Você precisa conferir o leitor utilizado na importação para que a representação textual recupere o tipo esperado.
Exportar o mesmo identificador como uma string simples preserva seus caracteres, mas perde a indicação de que ele era um ObjectId. Uma importação que mantenha essa string pode produzir um campo com tipo diferente do documento original.
Preservação dos tipos na conversão
O modo Canonical do Extended JSON v2 usa marcadores para priorizar a preservação dos tipos. O modo Relaxed favorece a leitura e pode perder distinções numéricas, por isso o formato escolhido precisa ser compatível com a finalidade da exportação.
O BSON define a codificação do documento, sem prometer um arquivo menor que o JSON. A compressão é um mecanismo separado. Ao comparar tamanhos ou preparar uma restauração, confira tanto o formato quanto as opções da ferramenta utilizada.
Dúvidas frequentes
Perguntas frequentes sobre BSON
- O BSON é uma versão comprimida do JSON?
- O BSON codifica campos e tipos em uma sequência de bytes. Essa serialização não implica compressão, nem permite concluir que um documento ocupará menos espaço que sua representação em JSON.
- O Extended JSON preserva todos os tipos da mesma maneira?
- O modo Canonical prioriza a preservação dos tipos. O modo Relaxed prioriza a legibilidade e pode perder distinções de tipos numéricos. Escolha o modo conforme o procedimento de exportação e leitura.
- Um parser JSON comum reconstrói um ObjectId?
- Um parser JSON comum lê a representação com $oid como um objeto JSON. A reconstrução do ObjectId exige um leitor compatível com o Extended JSON, como os fornecidos pelas ferramentas do MongoDB.
Para continuar
Recursos relacionados
Documentação
MongoDB: tipos BSON
Lista os tipos BSON reconhecidos pelo MongoDB e explica suas particularidades.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática de Desenvolvimento Colaborativo para revisar conversões entre documentos e a aplicação com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A integração da aplicação com o MongoDB exige preservar os tipos dos campos ao serializar documentos ou convertê-los para texto.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.