データモデルの作成

開発モードの同期の有効化

開発モードは App Services UI で設定されます。

開発モードを有効にするには、Development Mode の右側にあるスライダーをクリックします。

クリックして拡大します

Realm オブジェクト スキーマの編集

アプリケーションの開発を続けると、その変更に基づいてさまざまなデータ検証ルールを適用するように、そのアプリケーションとともにデータモデルを変更する必要があります。Development Mode がオンの場合、クライアント コード内で Realm オブジェクト スキーマを編集できます。Development Mode がオフの場合、データ検証が行われるため、 Development Mode がオンでない間は、App Services は Realm オブジェクト スキーマへの変更を受け入れません。

const realmObjectModel = {
  name: 'User',
  properties: {
    _id: 'objectId',
    _partition: 'string',
    name: 'string',
    // developers set optional: true to adhere to the new requirement
    birthday: {type: 'date', optional: true},
  },
  primaryKey: '_id'
};
Realm.open({schema: realmObjectModel, sync: {/*...*/}})
  .then(realm => {
    // ... use the realm instance to read and modify data
  })

Realm オブジェクト スキーマの変更に合わせた App Services スキーマの更新

Development Mode がオンになっている間は、Atlas App Servicesはデータモデルへの書き込みを検証しないため、Realm オブジェクトモデルを自由に更新できます。Development Mode をオフにすると、MongoDB Atlas Application Services は Atlas App Services スキーマを自動的に更新し、それに基づいて Atlas クラスターに対する強制的なデータ検証を開始します。

Sync 画面で、Development Mode の横にあるスライダーをクリックして Development Mode をオフにします。そのUI は、開発モードがオフになっていることを示します。

クリックして拡大します

App Services スキーマの定義

開始するには、Atlas App Services スキーマが定義されていることを確認します。App Services は、この App Services スキーマを、モバイル アプリケーションで構成されて利用される Realm オブジェクト スキーマに変換します。

次の要件に注意してください。

• The App Services スキーマは、_id と呼ばれるプライマリキー フィールドが必要です。_id は、string、int、または objectId のいずれかのタイプになります。

• スキーマ オブジェクト タイプ名は、57 文字以下の UTF-8 文字とする必要があります。

Realm オブジェクト スキーマの表示

Realm オブジェクト スキーマは、モバイル クライアント アプリケーション内のデータの定義および検証を行います。Realm オブジェクト スキーマを表示するには、 Atlas Device SDKs ページに移動し、[Realm Object Models] タブをクリックします。このページでは、Atlas App Services スキーマを、生成された Realm オブジェクト スキーマとして、選択した言語で表示できます。

クリックして拡大します

Realmオブジェクト スキーマを使った Realm のオープン

生成された Realm オブジェクト スキーマをクライアント アプリケーションで使用できます。データモデルでデータ検証を強制的に実施するには、Realm オブジェクト スキーマを使用してRealmを開きます。これにより、モバイル クライアントからデータベースに不適切なデータが入力されることを防止します。

モバイル アプリケーションのコードに統合したいオブジェクト モデルの Realm オブジェクト スキーマの右側にある [Copy] をクリックします。これにより、選択した SDK の Realm オブジェクト スキーマのコードがクリップボードにコピーされます。

IDE でモバイル アプリケーションのコードを開き、Realm オブジェクト スキーマのコードを貼り付けます。

const UserSchema = { // your copied and pasted Realm Object Schema
  name: 'User',
  properties: {
    _id: 'objectId',
    _partition: 'string',
    name: 'string',
    birthday: 'date'
  },
  primaryKey: '_id'
};
// Initialize a realm with your Realm Object Schema
Realm.open({schema: UserSchema, sync: { /* ... */ }})
  .then(realm => {
    // ... use the realm instance to read and modify data
  })