O que é BSON e quais tipos de dados o MongoDB suporta?

Question

Accepted Answer

**BSON** (Binary JSON) é o formato binário que o MongoDB usa para armazenar documentos — estende JSON com **tipos de dados** adicionais (como datas, ObjectId, binário e tipos de número apropriados) e é eficiente para armazenar e percorrer. Entender tipos BSON ajuda você a armazenar dados corretamente.

## BSON — JSON binário com mais tipos

```text
JSON has limited types (string, number, boolean, null, object, array).
BSON adds: ObjectId, Date, Binary, Decimal128, distinct Int/Long/Double, Timestamp, etc.
→ BSON is more efficient (binary, typed, traversable) and richer than plain JSON text.
```

## Tipos de dados BSON comuns

```js
{
  _id: ObjectId("..."),          // ObjectId — 12-byte unique id (the default _id type)
  name: "Ann",                    // String
  age: NumberInt(30),             // Int32 (32-bit integer)
  views: NumberLong(10000000000), // Int64 (64-bit — for large numbers)
  price: NumberDecimal("9.99"),   // Decimal128 — EXACT decimal (use for money!)
  rating: 4.5,                     // Double (default for numbers)
  active: true,                    // Boolean
  createdAt: ISODate("2024-01-15"),// Date (a proper date type, not a string)
  data: BinData(0, "..."),         // Binary data
  tags: ["a", "b"],                // Array
  address: { city: "NY" },          // Embedded document (object)
  deletedAt: null                   // Null
}
```

## ObjectId — o _id padrão

```js
// ObjectId is a 12-byte id: timestamp + machine/process + counter → globally unique
// It even encodes a creation timestamp:
ObjectId("...").getTimestamp();   // get when the document was created
```

O **ObjectId** (_id padrão) é único e contém um timestamp — então é aproximadamente ordenado por tempo e você obtém a hora de criação gratuitamente.

## Considerações importantes de tipo

```text
✓ Use proper DATE type (ISODate), not date strings → enables date queries/sorting
✓ Use Decimal128 (NumberDecimal) for MONEY → exact (avoid Double's rounding errors)
✓ Be aware of Int32 vs Int64 vs Double — numbers default to Double; large ints need Long
✓ ObjectId vs custom _id — you can use your own _id, but ObjectId is convenient/unique
```

## Por que isso importa

Compreender BSON e os tipos de dados do MongoDB é valioso para **armazenar dados correta e eficientemente**, então é um conhecimento fundamental útil para trabalhar com MongoDB.

Saber que o MongoDB usa **BSON** (JSON binário, mais rico e eficiente que JSON simples) e os **tipos de dados que suporta** além do JSON básico — especialmente tipos de **Date** apropriados, **ObjectId**, **Decimal128**, e tipos distintos de inteiro/double — é importante para representar dados com precisão.

Várias considerações de tipo são importantes na prática: usar um tipo de **Date** apropriado (ISODate) em vez de strings de data (permitindo consultas e ordenação de datas corretas — um erro comum é armazenar datas como strings), usar **Decimal128 (NumberDecimal) para dinheiro** (aritmética decimal exata, evitando os erros de arredondamento de Double — o mesmo problema crítico de correção que em SQL), e estar ciente das distinções de tipo de número (números usam Double por padrão; inteiros grandes precisam de Int64/Long).

Compreender o **ObjectId** (o _id padrão — um identificador único de 12 bytes que convenientemente codifica um timestamp de criação, então é aproximadamente ordenado por tempo e fornece a hora de criação gratuitamente) é útil para trabalhar com identificadores de documento.

Como armazenar dados com os tipos corretos afeta a correção (exatidão de dinheiro, funcionalidade de data), eficiência e capacidade de consulta, e como o sistema de tipo mais rico do BSON (especialmente Date, Decimal128 e ObjectId) é como o MongoDB representa dados com precisão, compreender BSON e os tipos de dados do MongoDB — os tipos disponíveis, as considerações de dinheiro/data e ObjectId — é um conhecimento valioso e relevante na prática para projetar dados do MongoDB corretamente e evitar erros comuns relacionados a tipos (como datas como strings ou dinheiro em ponto flutuante), um aspecto útil de trabalhar efetivamente com o banco de dados.