sincronização baseada em partição - .NET SDK

Valor da partição

Quando você seleciona sincronização baseada em partição para a configuração do aplicativo de backend, a implementação do cliente deve incluir um valor da partição}. Esse é o valor do campo da chave da partição que você seleciona ao configurar a sincronização baseada em partição.

O valor da partição determina quais dados o aplicativo cliente pode acessar. Você passa no valor da partição quando abre um Realm sincronizado.

Abra um domínio de sincronização baseado em partição enquanto estiver online

As etapas para abrir um Realm sincronizado enquanto estiver online são:

1. O código do seu aplicativo orienta o usuário na autenticação.

2. Crie um objeto PartitionSyncConfiguration que inclua o valor da partição e o objeto de usuário .

3. Abra um Realm sincronizado chamando o método GetInstanceAsync() , passando no objeto PartitionSyncConfiguration .

O seguinte código demonstra estas etapas:

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}");
}

No exemplo acima, o código mostra como abrir o domínio de forma assíncrona chamando GetInstanceAsync(). Você também pode abrir um domínio de forma síncrona chamando o método GetInstance() :

var synchronousRealm = Realm.GetInstance(config);

Abra um Realm de sincronização baseada em partição enquanto estiver offline

Após o usuário autenticar, o objeto User persiste no dispositivo até que o usuário faça logout. Isso permite que seu aplicativo recupere um usuário existente e abra um Realm sincronizado em um estado offline. As alterações que ocorrem enquanto estiver offline serão sincronizadas pelo SDK assim que o dispositivo for reconectado ao seu aplicativo.

O código a seguir mostra como verificar se há um objeto User existente. Se nenhum for encontrado, ele usará o processo descrito sobre para obter um usuário. If the device already has a user, it opens the synced realm with that 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);
}

Migrar da sincronização baseada em partição para a Flexible Sync

Você pode migrar seu Realm Mobile Sync do App Services da sincronização baseada em partição para a Flexible Sync. A migração é um processo automático que não exige alterações no código do aplicativo. A migração automática requer o Realm .NET SDK versão 11.1.0 ou mais recente.

A migração permite que você mantenha os usuários existentes do App Services e a configuração de autenticação. O Flexible Sync fornece opções de configuração de permissões mais versáteis e sincronização de dados mais granular.

Para obter mais informações sobre como migrar seu aplicativo do App Services App da Partition-Based Sync para o Flexible Sync, consulte Migrar modos de Device Sync .

Migrar de domínios não sincronizados para domínios sincronizados

Você pode converter um Realm não sincronizado em um Realm sincronizado (com sincronização baseada em partição). Para converter de um Realm não sincronizado para um que usa sincronização baseada em partição, faça o seguinte:

1. Abra o Realm existente.

2. Crie uma configuração para um novo Realm.

3. Ligue para o método WriteCopy() no Realm existente para copiar os dados para o novo Realm.

No código a seguir, abrimos um Realm não sincronizado, criamos um novo objeto PartitionSyncConfiguration e, em seguida, copiamos o Realm existente para o novo Realm. Em seguida, excluímos o Realm existente e abrimos o novo 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);