パーティションベースの同期 - .NET SDK

パーティション値

バックエンド アプリ構成にパーティションベースの同期を選択する場合、クライアント実装にはパーティション値を含める必要があります。 これは、 Flexible Sync を設定するときに選択したパーティションキーフィールドの値です。

パーティション値によって、クライアント アプリケーションがアクセスできるデータが決まります。 同期された Realm を開くときに、パーティション値を渡します。

オンライン中にパーティションベースの同期Realmを開く

オンライン中に同期された Realm を開く手順は次のとおりです。

1. アプリ コードでは、ユーザーの認証手順を説明します。

2. パーティション値とユーザーオブジェクトを含む FlexibleSyncConfiguration オブジェクトを作成します。

3. PartitionSyncConfigurationオブジェクトを渡して、 GetInstanceAsync()メソッドを呼び出して、同期された Realm を開きます。

次のコードは、これらの手順を示しています。

user = await app.LogInAsync(
    Credentials.EmailPassword("caleb@mongodb.com", "MySekritPwd"));
config = new PartitionSyncConfiguration("myPart", user);
try
{
    realm = await Realm.GetInstanceAsync(config);
}
catch (Exception ex)
{
    Console.WriteLine($@"Error creating or opening the
        realm file. {ex.Message}");
}

上記の例では、コードはGetInstanceAsync()を呼び出して Realm を非同期に開く方法を示しています。 GetInstance() メソッドを呼び出して、Realm を 同期 的に開くこともできます。

var synchronousRealm = Realm.GetInstance(config);

オフライン時にパーティションベースの同期Realmを開く

ユーザーが認証を行うと、ユーザーがログオフするまでUserオブジェクトはデバイス上に保持されます。 これにより、アプリは既存のユーザーを取得し、オフラインの状態で同期された Realm を開くことができます。 オフライン中に発生した変更は、デバイスがアプリに再接続すると、SDK によって同期されます。

次のコードは、既存のUserオブジェクトがあるかどうかを確認する方法を示しています。 何も見つからない場合は、 について説明されているプロセスを使用してユーザーを取得します。 デバイスにすでにuserがある場合は、そのユーザーと同期された Realm が開きます。

if (app.CurrentUser == null)
{
    // App must be online for user to authenticate
    user = await app.LogInAsync(
        Credentials.EmailPassword("caleb@mongodb.com", "MySekritPwd"));
    config = new PartitionSyncConfiguration("_part", user);
    realm = await Realm.GetInstanceAsync(config);
}
else
{
    // This works whether online or offline
    user = app.CurrentUser;
    config = new PartitionSyncConfiguration("_part", user);
    realm = Realm.GetInstance(config);
}

パーティションベースの同期から Flexible Sync への移行

App Services Device Sync モードを、パーティションベースの同期から Flexible Sync に移行できます。 移行は自動プロセスであり、アプリケーション コードを変更する必要はありません。 自動移行には Realm .NET SDK バージョン 11.1.0 が必要です。 またはそれ以降

移行により、既存の App Services ユーザーと認証構成を維持できます。 Flexible Sync は、より多目的の権限構成オプションとよりきめの細かいデータ同期を提供します。

App Services App をパーティションベースの同期から Flexible Sync に移行する方法の詳細については、「 Device Sync モードの移行 」を参照してください。

同期されていない Realm から同期された Realm への移行

同期されていない Realm を同期された Realm（パーティションベースの同期を使用）に変換できます。 同期されていないRealmから、パーティションベースの同期を使用するRealmに変換するには、次の手順を実行します。

1. 既存のRealmを開きます。

2. 新しいRealm の構成を作成します。

3. 既存の Realm でWriteCopy()メソッドを呼び出して、データを新しい Realm にコピーします。

次のコードでは、同期されていない Realm を開き、新しいFlexible Object オブジェクトを作成し、既存の Realm を新しい Realm にコピーします。 次に、既存の Realm を削除し、新しい Realm を開きます。

var existingConfig = new RealmConfiguration("example.realm");
var existingRealm = Realm.GetInstance(existingConfig);
var app = App.Create("my-app-id");
var user = await app.LogInAsync(
    Credentials.EmailPassword("email@example.com", "password"));
var syncConfig = new PartitionSyncConfiguration("user_partition", user);
existingRealm.WriteCopy(syncConfig);
// You can now delete the nonsynced realm:
Realm.DeleteRealm(existingConfig);
// You can now use the synced realm:
var syncedRealm = Realm.GetInstance(syncConfig);