$toObject（式演算子）

input Type Expectations

以下の表では、さまざまなinputタイプに対する $toObject の動作を説明しています。

解析ルール

string をオブジェクトに変換する場合、$toObject は次のことを行います。

• 有効なJSON構文が必要です。コメントと末尾のカンマは許可されていません。

• 最上位の値がオブジェクトである必要があります。string がオブジェクトを表していない場合、$toObject はエラーを返します。

• $oid、$date、Timestamp(...) などの拡張JSON型ラッパーは解釈されません。これらは結果内に string またはネストされたオブジェクトとして残ります。

• オブジェクトに重複するフィールド名が含まれている場合に最後の値を保持します。同じフィールドの以前の値は破棄されます。

数値型マッピング

$toObject は、値と形式に基づいて数値型を変換します。

• 32 ビット符号付き範囲内の整数は int になります。

• 32 ビットの範囲外、64 ビットの符号付き範囲内の整数は long になります。

• 64 ビットの符号付き範囲外の整数は double になり、精度が失われる可能性があります。

• 点または指数表記の数値は double になります。

string のオブジェクトへの変換

フィールドに保存されている文字列を含むコレクションを作成します。

db.jsonStrings.insertOne({
  _id: 1,
  config: '{"feature": true, "threshold": 10}'
})

次の集計は、config の string をオブジェクトに変換します。

db.jsonStrings.aggregate([
  {
    $project: {
      _id: 0,
      parsedConfig: { $toObject: "$config" }
    }
  }
])

この操作は、parsedConfig がブール値と整数値を持つネストされたdocumentであるdocumentを返します。

{ parsedConfig: { feature: true, threshold: 10 } }