스키마 유형

배열

array 에는 특정 유형의 값이 여러 개 포함되어 있습니다. BSON array 스키마는 표준 JSON schema 배열 을 사용합니다. 형식.

{
  "bsonType": "array",
  "items": <Schema Document> | [<Schema Document>, ...],
  "additionalItems": <boolean> | <Schema Document>,
  "maxItems": <integer>,
  "minItems": <integer>,
  "uniqueItems": <boolean>
}

부울

bool은 true 또는 false입니다.

{ "bsonType": "bool" }

혼합

mixed 필드에는 내장된 객체, 집합, 또는 SDK 지원 카운터를 제외하고 모든 스키마 유형이 포함될 수 있습니다. App Services는 문서 간에 일관적인 유형을 적용하지 않으므로 두 개의 서로 다른 문서가 서로 다른 유형의 값을 가질 수 있습니다.

혼합 필드는 혼합 데이터의 배열과 딕셔너리를 저장할 수 있습니다. Sync는 이들을 각각 배열과 객체로 MongoDB에 변환합니다. 이러한 혼합 데이터 컬렉션에는 최대 깊이가 100 수준인 다른 혼합 데이터 컬렉션도 포함될 수 있습니다. 이러한 유연성을 활용하여 가변 JSON 데이터나 복잡한 MongoDB 문서와 같이 사전 정의된 스키마에 맞지 않는 복잡한 데이터 구조를 저장할 수 있습니다.

혼합 필드는 관계를 나타낼 수도 있습니다. 동기화는 이러한 관계를 MongoDB에 맞게 DBRef로 변환하여 데이터베이스 이름, 컬렉션 이름, 링크의 기본 키를 유지합니다.

{ "bsonType": "mixed" }

번호

number 은(는) 일반적으로 일부 유형의 번호를 구성합니다. BSON 스키마는 JSON schema 숫자 를 확장합니다. 추가 유형을 사용하여 정수, 부동 소수점 및 소수점을 정의할 수 있습니다.

{
  "bsonType": "number" | "int" | "long" | "double" | "decimal",
  "multipleOf": <number>,
  "maximum": <number>,
  "exclusiveMaximum": <boolean>,
  "minimum": <number>,
  "exclusiveMinimum": <boolean>
}

객체

object는 string 키가 각각 입력된 값을 가진 구조화된 객체입니다. 객체는 Realm 객체와 동기화된 영역에 내장된 객체 및 MongoDB에 매핑되는 문서를 나타냅니다.

{
  "bsonType": "object",
  "title": "<Type Name>",
  "required": ["<Required Field Name>", ...],
  "properties": {
    "<Field Name>": <Schema Document>
  },
  "minProperties": <integer>,
  "maxProperties": <integer>,
  "patternProperties": {
    "<Field Name Regex>": <Schema Document>
  },
  "additionalProperties": <boolean> | <Schema Document>,
  "dependencies": {
    "<Field Name>": <Schema Document> | ["<Field Name>", ...]
  }
}

ObjectId

objectId 는 BSON 객체에 대한 12바이트 식별자입니다. ObjectId 값은 가장 일반적으로 MongoDB 컬렉션 에 있는 문서 또는 동기화된 영역 에 있는 객체의 고유한 _id 값으로 사용됩니다.

{ "bsonType": "objectId" }

문자열

string(은)는 일련의 문자로 인코딩된 텍스트입니다. BSON string 스키마는 표준 JSON Schema 문자열 형식을 사용합니다.

{
  "bsonType": "string",
  "maxLength": <integer>,
  "minLength": <integer>,
  "pattern": "<Regular Expression>"
}

UUID

uuid(범용 고유 식별자)는 표준화된 고유의 16바이트 객체 식별자입니다.

{ "bsonType": "uuid" }

이진 데이터

binData는 구조화되지 않은 바이너리 데이터 조각으로, 바이너리 BSON 유형에 매핑되며 항상 하위 유형 0을 사용합니다.

{ "bsonType": "binData" }

카운터

카운터는 값을 늘리거나 줄일 수 있는 특수 숫자 유형입니다. App Services의 long 숫자 유형에 매핑됩니다.

{ "bsonType": "long" }

카운터 데이터 유형은 다음 SDK에서만 지원됩니다.

• 카운터 - Java SDK

• MutableRealmInt(카운터) - Kotlin SDK

• RealmInteger - .NET SDK

• 카운터 - Node.js SDK

세트

세트는 고유한 값의 컬렉션입니다.

설정된 스키마는 uniqueItems이 true로 설정된 array 스키마입니다.

{
   "bsonType": "array",
   "uniqueItems": true,
   "items": {
      "bsonType": "long"
   }
}

Dictionary

사전은 특정 유형의 값과 쌍을 이루는 동적이고 고유한 string 키의 컬렉션을 말합니다. 사전은 기능적으로 사전에 정의된 필드 이름이 없는 객체 또는 문서입니다.

딕셔너리 스키마는 properties가 정의되지 않은 object 스키마이고 additionalProperties 값은 딕셔너리 값 유형에 대한 스키마입니다.

{
   "bsonType": "object",
      "additionalProperties": {
         "bsonType": "string"
      }
   }
}

{
   "bsonType": "object",
      "additionalProperties": true
   }
}

{
   "bsonType": "object",
      "additionalProperties": {
         "bsonType": "mixed"
      }
   }
}

{
   "bsonType": "object",
      "additionalProperties": {
         "bsonType": "object",
         "title": “Address”,
         "properties": {
           "streetNumber": { "bsonType": "string" },
           "street": { "bsonType": "string" },
           "city": { "bsonType": "string" },
           "province": { "bsonType": "string" },
           "country": { "bsonType": "string" },
           "postalCode": { "bsonType": "string" }
         }
   }
}

GeoJSON 포인트

GeoJSON 포인트(GeoPoint)는 지구 표면의 단일 위치를 말합니다. GeoPoint 스키마에는 string 유형의 필수 type 필드가 있어야 하며, 이 필드는 항상 'Point'로 설정되어 있습니다.

double의 배열인 coordinates 필드도 제공해야 합니다. coordinates 배열은 double 값을 적어도 두 개 포함해야 하며, 세 번째 값을 포함할 수도 있습니다.

• 첫 번째 double은 -180에서 180 사이의 점의 경도입니다.

• 두 번째는 -90에서 90 사이의 위도입니다.

• 선택 사항인 세 번째 값은 지점의 높이/고도를 미터 단위로 나타냅니다. Atlas는 쿼리를 수행할 때 이 값을 무시합니다.

Device Sync를 사용하지 않을 경우에는 일반 지리 공간적 연산자로 지리 공간적 데이터를 쿼리할 수 있습니다. 그러나 Atlas Device Sync를 사용하는 경우 GeoPoint 객체에는 다음 규칙도 적용됩니다.

• 반드시 object 유형이어야 합니다.

• 다른 유형에 포함해야 합니다.

• double 값이라면 coordinates 배열 내에서 추가 값이 허용됩니다.

• GeoPoint 객체의 추가적인 속성도 허용됩니다.

다음은 'location'이라는 GeoPoint 속성이 내장된 객체의 장치 동기화 스키마입니다.

{
  "title": "MyObject",
  "properties": {
     "_id": {
       "bsonType": "objectId"
     },
     "location": {
       "bsonType": "object",
       "required": [ "type" ],
       "properties": {
         "type": {
           "bsonType": "string",
         },
         "coordinates": {
           "bsonType": "array",
           "items": {
             "bsonType": "double"
           }
         }
       }
     }
   }
}

다음 코드 차단은 스키마를 따르는 문서를 보여줍니다. 여기에는 "location"이라는 단일 GeoPoint 객체가 포함되어 있습니다.

{
  "_id": { "$oid": "65039d09fe4e46dddee31a3f" },
  "location": {
    "type": "Point",
    "coordinates": [-122.4, 48.12, 23.0]
   }
}