Realm 객체 모델 정의 - React Native SDK

선택적 속성 설정

속성을 선택 사항으로 표시하려면 개체 구문을 사용하여 optional을(를) true(으)로 설정합니다. 유형에 ? 물음표를 추가하는 간단한 구문을 사용할 수도 있습니다. 기본 유형에 가장 적합합니다. 더 복잡한 유형에는 더 구체적인 객체 구문을 사용해야 합니다.

다음 Person 클래스 예에서 age 및 birthday 속성은 모두 선택 사항입니다.

class Person extends Realm.Object<Person> {
  name!: string;
  age?: number;
  birthday?: Date;
  static schema: ObjectSchema = {
    name: 'Person',
    properties: {
      name: 'string',
      age: {
        type: 'int',
        optional: true,
      },
      // You can use a simplified syntax instead. For
      // more complicated types, use the object syntax.
      birthday: 'date?',
    },
  };
}

프라이머리 키 설정

속성을 객체 유형의 프라이머리 키로 지정하려면 스키마의 primaryKey 필드를 속성 이름으로 설정하세요.

다음 Task 클래스 예에서는 _id 속성을 프라이머리 키로 지정합니다.

속성 인덱싱

특정 속성을 기반으로 읽기 작업을 자주 실행하는 경우 속성을 인덱싱하여 성능을 최적화할 수 있습니다. Realm은 문자열, 정수, 부울, Date, UUID 및 ObjectId 속성에 대한 인덱싱을 지원합니다.

지정된 속성을 색인화하려면 속성의 indexed 필드를 true(으)로 설정합니다.

다음 Book 클래스 예에서는 name 속성에 대한 인덱스를 정의합니다.

Full Text Search 인덱스 설정

Realm은 표준 인덱스 외에도 문자열 속성에 대한 FTS(Full-Text Search) 인덱스도 지원합니다. 표준 인덱스 유무에 관계없이 문자열 필드를 쿼리할 수 있지만 FTS 인덱스를 사용하면 여러 단어와 구를 검색하고 나머지는 제외할 수 있습니다.

FTS 인덱스 쿼리에 대한 자세한 내용은 Full Text Search를 참조하세요.

FTS 인덱스를 만들려면 인덱싱된 유형을 'full-text' 로 설정합니다. 이를 통해 속성에 대한 전체 텍스트 쿼리가 가능합니다. 다음 예제에서는 name 속성의 인덱싱된 유형을 'full-text' 으)로 설정합니다.

class Book extends Realm.Object<Book> {
  name!: string;
  price?: number;
  static schema: ObjectSchema = {
    name: 'Book',
    properties: {
      name: {type: 'string', indexed: 'full-text'},
      price: 'int?',
    },
  };
}

기본 속성 값 설정

기본값을 정의하려면 속성 값을 type 필드와 default 필드가 있는 객체로 설정하세요.

다음 Car 클래스 예에서는 기본값이 0인 miles 속성을 정의합니다.

Realm.js v11.1.0 이상에서는 함수를 사용하여 아래 예의 timestamp 속성과 같은 동적 기본값을 정의할 수 있습니다.

속성 재매핑

Realm에 저장된 것과 다른 속성 이름을 코드에 사용하려면 코드에 표시되는 속성 이름으로 mapTo을(를) 설정하세요.

다음 Employee 클래스 예에서는 first_name 속성을 firstName에 다시 매핑합니다.

비대칭 객체 정의

유연한 동기화를 사용 중이고 장치에서 Atlas 데이터베이스로 컬렉션을 단방향으로 동기화해야 하는 경우 객체 스키마에서 asymmetric 속성을 설정할 수 있습니다.

JS SDK 버전 12.2.0 이하에서는 비대칭 객체에서 Realm.Object 유형으로 링크할 수 없습니다. SDK 버전 12.2.1 이상에서는 비대칭 개체가 포함된 개체 외에도 Realm.Object 유형에 연결할 수 있습니다.

데이터 수집에 대해 자세히 알아보려면 Atlas로 데이터 스트리밍을 읽어보세요.