데이터 형식

표준 JSON(application/json)

JSON 형식은 모든 도구가 구문 분석하고 이해할 수 있는 표준 유형을 사용합니다. 그러나 JSON은 모든 BSON types를 나타낼 수 없으므로 JSON 응답은 일부 필드에 대한 유형 정보가 손실될 수 있습니다. 예를 들어 BSON에는 32비트 정수와 64비트 실수에 대한 고유한 유형이 있지만 JSON 응답은 둘 다 number 로 나타납니다.

표준 및 완화 EJSON(application/ejson)

MongoDB Extended JSON 의 약자인 EJSON 형식은 구조화된 필드를 사용하여 해당 JSON 유형이 없는 BSON 데이터를 나타내는 표준 JSON 의 상위 집합입니다. 이는 데이터를 완전히 나타내지만 클라이언트 가 EJSON으로 작업하는 방법을 이해해야 합니다.

EJSON에는 두 가지 변형이 있습니다.

• 표준 EJSON 은 가독성과 상호 운용성을 희생하면서 유형 보존을 강조하는 장황한 구조를 사용합니다. BSON types를 완전히 나타내지만 이를 사용하려면 라이브러리나 사용자 지정 코드를 사용해야 할 수도 있습니다.

• 완화된 EJSON 은 읽고 작업하기 더 쉽지만 일부 BSON types의 경우 유형 정보가 손실될 수 있는 더 간결한 구조를 사용합니다. 예를 들어, 삽입된 문서의 숫자 필드는 예상과 다른 숫자 BSON type으로 유추될 수 있습니다.

요청 본문에는 표준 또는 완화 EJSON을 사용할 수 있습니다. EJSON을 반환하도록 구성된 데이터 API 엔드포인트는 항상 표준 EJSON을 반환합니다.

BSON 유형

이 섹션에서는 Data 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
}