관계

이 페이지의 내용

개요

카디널리티
To-One
To-Many
내장된 객체 관계
다른 컬렉션에 내장된 객체
목록에 내장된 객체
관계 정의
1. 스키마 정의
2. 새 관계 만들기
3. 관계 구성
4. 관계 배포

Realm은 Atlas Device SDK로 변경되었습니다. – 자세히 알아보기

개요

관계는 두 문서 사이의 연결입니다. 관계를 사용하면 문서가 별도의 데이터베이스나 컬렉션에 있는 경우에도 읽기 및 쓰기 작업에서 관련 문서를 참조하고 쿼리할 수 있습니다.

'소스' MongoDB 컬렉션에 대한 관계를 정의하고 '외부' 컬렉션의 문서에 연결합니다. Atlas App Services는 소스 필드의 값을 참조하는 외부 문서로 대체하여 동기화된 SDK 데이터 모델의 관계를 자동으로 확인합니다.

관계는 단방향이며 고유성이나 기타 외부 키 제약 조건을 적용하지 않습니다. 소스 필드에서 존재하지 않는 외부 값을 참조하는 경우 App Services는 확인된 관계에서 참조를 자동으로 생략합니다.

예제

두 개의 컬렉션이 있는 애플리케이션을 예로 들어 보겠습니다:

accounts 컬렉션에는 각각 고객 계정을 설명하는 문서가 포함되어 있습니다.

계정 컬렉션 스키마

{
  "title": "Account",
  "properties": {
    "_id": { "bsonType": "objectId" },
    "account_id": { "bsonType": "string" },
    "products": {
      "bsonType": "array",
      "items": { "bsonType": "string" }
    },
    ...
  }
}

customers 컬렉션에는 각각 하나 이상의 계정을 가질 수 있는 단일 고객을 설명하는 문서가 포함되어 있습니다. customers 컬렉션의 모든 문서에는 고객에게 적용되는 accounts 컬렉션의 모든 account_id 값의 배열이 포함된 accounts 필드가 있습니다.
고객 컬렉션 스키마
```
{
  "title": "Customer",
  "properties": {
    "username": { "bsonType": "string" },
    "accounts": {
      "bsonType": "array",
      "items": { "bsonType": "string" }
    },
    ...
  }
}
```

앱은 customers 컬렉션에서 이 관계를 정의합니다. accounts 필드에 저장된 계정 ID 값 배열에서 accounts 컬렉션에 있는 각 문서의 account_id 필드를 가리킵니다.

{
  "accounts": {
    "ref": "#/relationship/mongodb-atlas/sample_analytics/accounts",
    "foreign_key": "account_id",
    "is_list": true
  }
}

이 관계가 정의되면 App Services는 클라이언트 쿼리에서 고객과 해당 고객의 모든 계정을 반환할 수 있습니다. 관계가 없으면 쿼리는 전체 Account 객체 대신 account_id 값 목록만 반환합니다.

카디널리티

관계의 카디널리티에 따라 참조할 수 있는 외부 문서의 수가 결정됩니다. App Services는 'to-one' 및 'to-many', 이렇게 두 가지 관계 카디널리티를 지원합니다.

To-One

'to-one' 관계는 각 소스 문서를 단일 문서 또는 외부 컬렉션의 문서 배열과 연결합니다.

관계에 'to-one' 카디널리티가 있음을 나타내려면 is_list를 false로 설정합니다.

data_sources/mongodb-atlas/example/pets/relationships.json

{
  "owner": {
    "ref": "#/relationship/mongodb-atlas/example/people",
    "foreign_key": "_id",
    "is_list": false
  }
}

App Services는 소스 값을 참조된 객체 또는 SDK 모델의 null 값으로 자동으로 바꿉니다.

{
  "name": "Pet",
  "properties": {
    "name": "string",
    "owner": "Person"
  }
}
{
  "name": "Person",
  "properties": {
    "name": "string"
  }
}

To-Many

'to-many' 관계는 각 소스 문서를 외부 컬렉션의 문서 목록과 연결합니다.

관계에 'to-many' 카디널리티가 있음을 나타내려면 is_list를 true로 설정합니다:

data_sources/mongodb-atlas/example/people/relationships.json

{
  "pets": {
    "ref": "#/relationship/mongodb-atlas/example/pets",
    "foreign_key": "_id",
    "is_list": true
  }
}

App Services는 소스 값을 참조된 객체 또는 SDK 모델의 null 값으로 자동으로 바꿉니다.

{
  "name": "Pet",
  "properties": {
    "name": "string"
  }
}
{
  "name": "Person",
  "properties": {
    "name": "string",
    "pets": "Pet[]"
  }
}

내장된 객체 관계

내장된 객체는 외부 컬렉션과 관계를 가질 수 있습니다. 점 표기법을 사용하여 내장된 객체의 속성에 액세스합니다.

다른 컬렉션에 내장된 객체

내장된 객체는 외부 컬렉션의 객체와 관계를 가질 수 있습니다.

{
  "title": "Person",
  "properties": {
    "_id": { "bsonType": "objectId" },
    "pet": {
      "bsonType":"object",
      "properties": {
        "favoriteToyBrand": { "bsonType": "objectId" }
      }
    }
    // ...additional model properties
  }
}

점 표기법을 사용하여 외부 컬렉션과 관계가 있는 내장된 객체 속성을 지정합니다. 그런 다음 외부 컬렉션 세부 정보 및 외부 키 필드를 지정할 수 있습니다.

{ "pet.favoriteToyBrand":
   {
      "ref": "#/relationship/mongodb-atlas/example/ToyBrand",
      "foreign_key": "_id",
      "is_list": false }
}

목록에 내장된 객체

목록 속성 내에 내장된 객체는 외부 컬렉션과 관계를 가질 수 있습니다.

{
  "title": "Person",
  "properties": {
    "_id": { "bsonType": "objectId" },
    "pets": {
      "bsonType":"array",
      "items": {
        "bsonType": "object",
        "properties": {
          "favoriteToyBrand": { "bsonType": "objectId" }
        }
      }
    }
   // ...additional model properties
  }
}

목록에 포함된 내장된 객체 속성에 액세스하려면 다음을 사용합니다: field1.[].field2(예: pets.[].favoriteToyBrand). 여기에서 외부 컬렉션 세부 정보 및 외부 키 필드를 지정할 수 있습니다.

팁

사전과 세트에 동일한 구문 사용

사전 및 세트 내에서 관계를 생성할 때 이와 동일한 field1.[].field2 구문을 사용할 수 있습니다.

{
  "pets.[].favoriteToyBrand": {
    "ref": "#/relationship/mongodb-atlas/example/ToyBrand",
    "foreign_key": "_id",
    "is_list": false
  }
}

참고

관계 내 기본(Primitives) vs 목록, 사전 및 세트

위의 예에서는 is_list가 false로 설정되어 있습니다. 여기서 관계 문자열의 끝에 있는 필드는 목록이 아닌 기본(primitive) 필드입니다. 내장된 객체가 목록에 포함되어 있지만 favoriteToyBrand 속성 자체는 사전, 집합 또는 목록이 아닙니다.

관계 정의

관계를 정의할 때는 이러한 제한 사항을 염두에 두세요:

참조 필드에 허용되지 않는 항목 _id
참조 필드는 required 필드가 아니어야 합니다.
외부 키는 필드가 참조하는 컬렉션의 _id 필드여야 합니다.

1. 스키마 정의

관계를 정의하려면 소스 컬렉션과 외부 컬렉션 모두에 대해 정의된 스키마가 있어야 합니다. 스키마를 정의하는 방법을 알아보려면 스키마 적용을 참조하세요.

2. 새 관계 만들기

스키마와 함께 연결된 MongoDB 데이터 소스에서 컬렉션에 대한 관계를 정의합니다.

3. 관계 구성

관계 정의는 소스 컬렉션의 스키마에 포함된 필드를 매핑하고 외부 컬렉션 스키마에 있는 동일한 유형의 필드를 가리킵니다.

4. 관계 배포

← 스키마 유형

값 및 비밀 →

관계.css-134mg1q{-webkit-align-self:center;-ms-flex-item-align:center;align-self:center;padding:0 10px;visibility:hidden;}.css-6vrlzm{border-radius:0!important;display:initial!important;margin:initial!important;}.css-1l4s55v{margin-top:-175px;position:absolute;padding-bottom:2px;}

개요

예제