MongoDB 확장 JSON(v2)

MongoDB 확장 JSON v2 사용법

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

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

BSON 데이터 유형 및 관련 표현

다음은 몇 가지 일반적인 BSON 데이터 유형과 표준과 완화 모드에서의 관련 표현입니다.

전체 목록은 여기에서 확인할 수 있습니다.

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 인터넷 날짜/시간 형식의 날짜.

  • 날짜/시간의 최대 시간 정밀도는 밀리초입니다.

    • 분수 초는 분수 부분이 0이 아닌 경우 소수점 이하 3자리까지 정확하게 표시됩니다.

    • 소수부가 0인 경우 소수 자릿수는 반드시 생략해야 합니다.

Decimal128

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

<Same as Canonical>

여기서 값은 다음과 같습니다.

• "<number>"

  • 고정밀 십진수(문자열)입니다.

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이 아닌 정수로 구문 분석됩니다.

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에 대한 비교 순서에 대한 자세한 내용은 Comparison/Sort Order를 참조하세요.

MinKey

{ "$minKey": 1 }

<Same as Canonical>

MinKey BSON 데이터 유형은 비교 순위가 다른 모든 유형보다 낮습니다. BSON 유형의 비교 순서에 대한 자세한 내용은 비교/순서 정렬을 참조하세요.

ObjectId

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

<Same as Canonical>

여기서 값은 다음과 같습니다.

• "<ObjectId bytes>"

  • ObjectId 바이트를 나타내는 24자의 빅엔디안 16진수 문자열입니다.

Regular Expression

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

<Same as Canonical>

여기서 값은 다음과 같습니다.

• "<regexPattern>"

  • 정규 표현식 패턴에 해당하는 문자열입니다. 문자열에는 유효한 JSON 문자와 이스케이프되지 않은 큰따옴표(") 문자가 포함될 수 있지만 이스케이프되지 않은 슬래시(/) 문자는 포함될 수 없습니다.

• "<options>"

  • BSON 정규식 옵션을 지정하는 문자열입니다. 옵션을 알파벳 순서로 지정해야 합니다. 지원되는 옵션에 대한 자세한 내용은 $options을 참조하세요.

Timestamp

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

<Same as Canonical>

여기서 값은 다음과 같습니다.

• <t>

  • 에포크 이후 초에 대한 양의 정수입니다.

• <i>

  • 증분에 대한 양의 정수입니다.

예시

다음 예시에서는 확장 JSON 사용법을 보여 줍니다.

db.conversions.insertOne( { insertDate: new Date() } )

{
  acknowledged: true,
  insertedId: ObjectId("61fbaf25671c45f3f5f4074a")
}

serialized = EJSON.serialize( db.conversions.findOne() )

{
  _id: { '$oid': '61fbaf25671c45f3f5f4074a' },
  insertDate: { '$date': '2022-02-03T10:32:05.230Z' }
}

EJSON.deserialize( serialized )

{
  _id: new ObjectId( "61fbaf25671c45f3f5f4074a" ),
  insertDate: ISODate( "2022-02-03T10:32:05.230Z" )
}

stringified = EJSON.stringify( db.conversions.findOne() )

{
   "_id": {"$oid":"61fbaf25671c45f3f5f4074a"},
   "insertDate":{"$date":"2022-02-03T10:32:05.230Z"}
}

EJSON.parse( stringified )

{
  _id: new ObjectId("61fbaf25671c45f3f5f4074a"),
  insertDate: ISODate("2022-02-03T10:32:05.230Z")
}