Tipos de JSON

Dados binários

Um valor binário BSON binData é uma array de bytes. Um valor binData tem um subtipo que indica como interpretar os dados binários. A tabela a seguir mostra os subtipos:

ObjectId

ObjectIds são pequenos, provavelmente únicos, rápidos de gerar e ordenados. Os valores ObjectId têm 12 bytes de comprimento, consistindo em:

• Um carimbo de data/hora de bytes, representando a criação do ObjectID, medido em segundos desde a época do Unix.

• Um valor aleatório de 5bytes gerado uma vez por processo do lado do cliente . Este valor aleatório é exclusivo da máquina e do processo. Se o processo for reiniciado ou o nó primário do processo for alterado, este valor será gerado novamente.

• Um contador incrementador de 3bytes por processo do lado do cliente , inicializado para um valor aleatório. O contador é redefinido quando um processo é reiniciado.

Para valores de carimbo de data/hora e contador, os bytes mais significativos aparecem primeiro na sequência de bytes (big-endian). Isto é diferente de outros valores de BSON, onde os bytes menos significativos aparecem primeiro (little-endian).

Se um valor inteiro for usado para criar um ObjectId, o número inteiro substituirá o carimbo de data/hora.

No MongoDB, cada documento armazenado em uma collection padrão requer um campo _id exclusivo que atua como uma chave primária. Se um documento inserido omitir o _id campo, o driver MongoDB gerará automaticamente um ObjectID para o _id campo.

Isso também se aplica a documentos inseridos por meio de operações de atualização com upsert: true.

Os clientes do MongoDB devem adicionar um campo _id com um ObjectId único. A utilização de ObjectIds para o campo _id fornece os seguintes benefícios adicionais:

• Você pode acessar o tempo de criação de ObjectId em mongosh usando o método ObjectId.getTimestamp().

• Os ObjectIDs são aproximadamente ordenados por hora de criação, mas não estão perfeitamente ordenados. Classificar uma coleção em um campo _id contendo valores ObjectId é aproximadamente equivalente a classificar por hora de criação.

  Importante

  Embora os valores de ObjectId devam aumentar com o tempo, eles não são necessariamente monotônicos. Isso ocorre porque eles:

  • Contêm apenas um segundo de resolução temporal, portanto, os valores de ObjectId criados no mesmo segundo não têm uma ordenação garantida, e

  • São gerados por clientes, que podem ter relógios de sistema diferentes.

Utilize os métodos ObjectId() para configurar e recuperar valores ObjectId.

A partir do MongoDB 5.0, mongosh substitui o shell legado mongo. Os métodos ObjectId() funcionam de maneira diferente em mongosh e no shell mongo herdado. Para obter mais informações sobre os métodos legados, consulte Legacy mongo Shell.

String

As strings JSON são UTF-8. Em geral, os drivers para cada linguagem de programação convertem do formato de cadeia de caracteres da linguagem para UTF-8 ao serializar e desserializar BSON. Isso torna possível armazenar a maioria dos caracteres internacionais em strings BSON com facilidade. [1] Além disso, as $regex queries do MongoDB suportam UTF-8 na string regex.

Carimbos de data e hora

O BSON tem um tipo especial de carimbo de data/hora para uso interno do MongoDB e não está associado ao tipo normal de Data. Esse tipo de carimbo de data/hora interno é um valor de 64 bits em que:

• os 32 bits mais significativos são um valor de time_t (segundos desde a época Unix)

• os 32 bits menos significativos são um ordinal incremental para operações dentro de um determinado segundo.

Enquanto o formato BSON é little-endian e, portanto, armazena os bits menos significativos primeiro, a instância mongod sempre compara o valor time_t antes do valor ordinal em todas as plataformas, independentemente da endianidade.

Na replicação, o oplog tem um campo ts. Os valores neste campo refletem o tempo de operação, que utiliza um valor de carimbo de data/hora BSON.

Dentro de uma única instância mongod, os valores de timestamp no oplog são sempre únicos.

Data

Data de JSON é um número inteiro de 1 bits que representa o número de milissegundos desde a época do Unix (1 de janeiro de 1970). Isso resulta em um período representável de cerca de 290 milhões de anos no passado e no futuro.

A especificação oficial da BSON refere-se ao tipo BSON Date como data e hora UTC.

O tipo de data BSON está assinado. [2] Valores negativos representam datas anteriores a 1970.

Para construir um Date no mongosh, você pode utilizar o construtor new Date() ou ISODate().

var mydate1 = new Date()

mydate1

ISODate("2020-05-11T20:14:14.796Z")

var mydate2 = ISODate()

mydate2

ISODate("2020-05-11T20:14:14.796Z")

mydate1.toString()

Mon May 11 2020 13:14:14 GMT-0700 (Pacific Daylight Time)

mydate1.getMonth()

4

decimal128 Tipo de dados JSON

decimal128 é uma 128representação decimal de bits para armazenar números muito grandes ou muito precisos, sempre que o arredondamento decimais for importante. Foi criado em de agosto 2009 como parte da revisão IEEE 754-2008 de pontos flutuantes. Quando você precisar de alta precisão ao trabalhar com tipos de dados BSON, deverá decimal128 usar.

decimal128 suporta 34 casas decimais de precisão ou significando junto com um intervalo de expoentes de -6143 a6144 +. O significando não é normalizado no decimal128 padrão, permitindo várias representações possíveis: 10 x 10^-1 = 1 x 10^0 = .1 x 10^1 = .01 x 10^2 etc. Ter a capacidade de armazenar valores máximos e mínimos na ordem de 10^6144 10^-6143e, respectivamente, permite um muita precisão.

NumberDecimal("9823.1297")

NumberDecimal(1234.99999999999)

> 0.1
0.1
> 0.2
0.2
> 0.1 * 0.2
0.020000000000000004
> 0.1 + 0.1
0.010000000000000002

1
class Main {
2
   public static void main(String[] args) {
3
      System.out.println("0.1 * 0.2:");
4
      System.out.println(0.1 * 0.2);
5
   }
6
}

1
0.1 * 0.2:
2
0.020000000000000004