Data Formats

標準JSON （アプリケーション/ JSON ）

JSON形式は、どのツールも解析して理解できる標準タイプを使用します。 ただし、JSON ではすべての BSON types を表現できないため、JSON 応答で一部のフィールドのタイプ情報が失われる場合があります。 たとえば、BSON には 32 ビット整数と 64 ビット浮動小数点数の異なるタイプがありますが、JSON 応答は両方をnumberとして表します。

標準および緩和EJSON （アプリケーション/ EJSON ）

MongoDB Extended JSON の短縮形である EJSON 形式は、対応する JSON タイプがない BSON データを表すために構造化フィールドを使用する標準 JSON のスーパーセットです。これはデータを完全に表しますが、クライアントが EJSON の扱い方を理解している必要があります。

EJSON には次の 2 つのバリアントがあります。

• 標準型 EJSONは、読みやすさと相互運用性を犠牲にして、型の保存を重視した冗長な構造を使用します。 これは BSON types を完全に表しますが、それを操作するにはライブラリまたはカスタム コードを使用する必要がある場合があります。

• 緩和型 EJSONは、読み取りと操作が簡単なより圧縮された構造を使用しますが、一部の BSON types のタイプ情報が失われる場合があります。 たとえば、挿入されたドキュメント内の数値フィールドは、予想とは異なる数値 BSON 型として推測される場合があります。

リクエストでは、標準または緩和ベースの EJSON のいずれかを使用できます。 EJSON を返すように構成されているデータ API エンドポイントは、常に標準の EJSON を返します。

BSON types

このセクションでは、データ API がサポートする BSON types を一覧表示し、各タイプが JSON および EJSON 形式で表される方法を示します。

[ <elements> ]

[ <elements> ]

{
   "$binary": {
      "base64": "e67803a39588be8a95731a21e27d7391",
      "subType": "05"
   }
}

{
   "Subtype": 5,
   "Data": "e67803a39588be8a95731a21e27d7391"
}

{
   "$date": {
      "$numberLong": "1641954803067"
   }
}

{
   "$date": "2022-01-12T02:33:23.067Z"
}

"2022-01-12T02:33:23.067Z"

{ "$numberDecimal": "9823.1297" }

"9823.1297"

{ <content> }

{ <content> }

{ "$numberDouble": "10.5" }

10.5

10.5

{ "$numberInt": "10" }

10

10

{ "$numberLong": "50" }

50

{ "$maxKey": 1 }

{}

{ "$minKey": 1 }

{}

{ "$oid":"5d505646cf6d4fe581014ab2" }

"5d505646cf6d4fe581014ab2"

{
  "$regularExpression": {
    "pattern":"^H",
    "options":"i"
  }
}

{
   "Pattern": "^H",
   "Options": "i"
}

{
  "$timestamp": {
    "t":1565545664,
    "i":1
  }
}

{
   "T": 1565545664,
   "I": 1
}