파티션 기반 동기화 - .NET SDK

파티션 값

백엔드 앱 구성에 파티션 기반 동기화 를 선택하는 경우 클라이언트 구현에 파티션 값이 포함되어야 합니다. 이는 파티션 기반 동기화를 구성할 때 선택하는 파티션 키 필드의 값입니다.

파티션 값에 따라 클라이언트 애플리케이션이 액세스할 수 있는 데이터가 결정됩니다. 동기화된 영역을 열 때 파티션 값을 전달합니다.

온라인 상태에서 파티션 기반 동기화 Realm 열기

온라인 상태에서 동기화된 영역을 여는 단계는 다음과 같습니다.

1. 앱 코드는 사용자를 인증하는 과정을 안내합니다.

2. 파티션 값 과 사용자 객체를 포함하는 PartitionSyncConfiguration 객체를 만듭니다.

3. GetInstanceAsync() 메서드를 호출하고 PartitionSyncConfiguration 객체를 전달하여 동기화된 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() 을(를) 호출하여 비동기적 으로 영역을 여는 방법을 보여줍니다. GetInstance() 메서드를 호출하여 Realm을 동기적 으로 열 수도 있습니다.

var synchronousRealm = Realm.GetInstance(config);

오프라인 상태에서 파티션 기반 동기화 Realm 열기

사용자가 인증되면 사용자가 로그오프할 때까지 User 객체가 기기에 유지됩니다. 이렇게 하면 앱이 기존 사용자를 검색 하고 오프라인 상태에서 동기화된 영역을 열 수 있습니다. 오프라인 상태에서 발생하는 변경 사항은 기기가 앱에 다시 연결되면 SDK에 동기화됩니다.

다음 코드는 기존 User 객체가 있는지 확인하는 방법을 보여줍니다. 아무 것도 발견되지 않으면 에 설명된 프로세스를 사용하여 사용자를 얻습니다. 기기에 이미 user 있는 경우 해당 사용자와 동기화된 영역이 열립니다.

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 Realm Mobile 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을 열고 새 PartitionSyncConfiguration 객체를 만든 다음 기존 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);