MongoDB 拡張 JSON（v2）

MongoDB 拡張 JSON v2 の使用法

EJSON.serialize( db.<collection>.findOne() )

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

BSON データ型と関連表現

以下は、一般的な BSON データ型と、それに関連する Canonical および Relaxed での表現です。

完全なリストは ここにあります。

Array

[ <elements> ]

<Same as Canonical>

ここで、配列要素は次のとおりです。

• <elements>

  • 配列要素は拡張 JSON を使用します。

  • 空の配列を指定するには、コンテンツ [ ] を省略します。

Binary

{ "$binary":
   {
      "base64": "<payload>",
      "subType": "<t>"
   }
}

<Same as Canonical>

ここで、値は次のとおりです。

• "<payload>"

  • Base64 エンコード（パディングは " = "）のペイロード文字列。

• "<t>"

  • BSON バイナリ サブタイプに対応する 1 文字または 2 文字の 16 進文字列。使用可能なサブタイプについては、拡張 bson ドキュメント（http://bsonspec.org/spec.html）を参照してください。

Date

1970 年から 9999 年までの日付（以下を含みます）:

{"$date": {"$numberLong": "<millis>"}}

{"$date": "<ISO-8601 Date/Time Format>"}

1970 年以前または 9999 年以降の日付の場合:

{"$date": {"$numberLong": "<millis>"}}

<Same as Canonical>

ここで、値は次のとおりです。

• "<millis>"

  • 文字列としての 64 ビット符号付き整数。この値は、エポックに対するミリ秒単位を表します。

• "<ISO-8601 Date/Time Format>"

  • ISO-8601 インターネット日付や時刻形式 の日付を string として指定します。

  • 日付や時刻の最大時間精度はミリ秒です。

    • 小数部がゼロ以外の場合、小数秒の小数点は正確に 3 桁になります。

    • それ以外の場合、小数秒がゼロの場合は省略してください。

Decimal128

{ "$numberDecimal": "<number>" }

<Same as Canonical>

ここで、値は次のとおりです。

• "<number>"

  • stringとしての高精度の10進数。

Document

{ <content> }

<Same as Canonical>

ドキュメントのコンテンツは次のとおりです。

• <content>

  • 名称: 拡張 JSON を使用する値のペア。

  • 空のドキュメントを指定するには、コンテンツ { } を省略します。

Double

有限数の場合:

{"$numberDouble": "<decimal string>" }

<non-integer number>

無限数または NAN の場合:

{"$numberDouble": <"Infinity"|"-Infinity"|"NaN"> }

<Same as Canonical>

ここで、値は次のとおりです。

• "<decimal string>"

  • 64 ビットの符号付き浮動小数点を文字列として表します。

• <non-integer number>

  • 非整数。整数は double ではなく integer として解析されます。

Int64

{ "$numberLong": "<number>" }

<integer>

ここで、値は次のとおりです。

• "<number>"

  • 文字列としての 64 ビット符号付き整数。

• <integer>

  • 64 ビットの符号付き整数。

Int32

{ "$numberInt": "<number>" }

<integer>

ここで、値は次のとおりです。

• "<number>"

  • 文字列としての 32 ビット符号付き整数。

• <integer>

  • 32 ビットの符号付き整数。

MaxKey

{ "$maxKey": 1 }

<Same as Canonical>

MaxKey BSON データ型は、他のすべての型よりも高位にあります。BSON types の比較順序について詳しくは、「比較/並べ替え順序」を参照してください。

MinKey

{ "$minKey": 1 }

<Same as Canonical>

MaxKey BSON データ型は、他のすべての型よりも低位にあります。BSON types の比較順序について詳しくは、「比較/並べ替え順序」を参照してください。

ObjectId

{ "$oid": "<ObjectId bytes>" }

<Same as Canonical>

ここで、値は次のとおりです。

• "<ObjectId bytes>"

  • ObjectId バイトを表す 24 文字のビッグ エンディアンの文字列。

Regular Expression

{ "$regularExpression":
   {
      "pattern": "<regexPattern>",
      "options": "<options>"
  }
}

<Same as Canonical>

ここで、値は次のとおりです。

• "<regexPattern>"

  • 正規式パターンに対応する string。string には有効な JSON 文字とエスケープされていない二重引用符（" ）文字を含めることができますが、エスケープされていないスラッシュ（/）文字を含めることはできません。

• "<options>"

  • BSON 正規表現オプションを指定する string。 オプションはアルファベット順に指定する必要があります。 サポートされているオプションの詳細については、 $optionsを参照してください。

Timestamp

{"$timestamp": {"t": <t>, "i": <i>}}

<Same as Canonical>

ここで、値は次のとおりです。

• <t>

  • エポックからの秒数の正の整数。

• <i>

  • 増分を表す正の整数。

例

このページの例では、sample_mflix データセット のデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

次の例は、拡張 JSON の使用方法を示しています。

serialized = EJSON.serialize(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{
  _id: {
    '$oid': '5a9427648b0beebeb69579e7'
  },
  date: {
    '$date': '2002-08-18T04:56:07.000Z'
  }
}

EJSON.deserialize( serialized )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}

stringified = EJSON.stringify(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{"_id":{"$oid":"5a9427648b0beebeb69579e7"},"date":{"$date":"2002-08-18T04:56:07.000Z"}}

EJSON.parse( stringified )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}