Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é BSON?

    O BSON serializa documentos do MongoDB em formato binário e distingue tipos como ObjectId, datas e números. O Extended JSON representa os tipos em texto.

    Também chamado de: Binary JSON

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano