Sincronización basada en particiones - SDK .NET

Valor de partición

Cuando se selecciona Partition-Based Sync para la configuración de la aplicación de backend, la implementación del cliente debe incluir un valor de la partición. Este es el valor del campo clave de partición que se selecciona al configurar la Partition-Based Sync.

El valor de la partición determina a qué datos puede acceder la aplicación cliente. Se pasa el valor de la partición al abrir un dominio sincronizado.

Abrir un dominio de sincronización basado en particiones mientras está en línea

Los pasos para abrir un reino sincronizado mientras estás en línea son:

1. El código de su aplicación guía al usuario a través del proceso de autenticación.

2. Cree un objeto PartitionSyncConfiguration que incluya el valor de la partición y el objeto Usuario.

3. Abra un reino sincronizado llamando al método GetInstanceAsync() y pasando el PartitionSyncConfiguration objeto.

El siguiente código demuestra estos pasos:

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

En el ejemplo anterior, el código muestra cómo abrir el dominio de forma asincrónica llamando GetInstanceAsync() a. También puede abrir un dominio de forma sincrónica llamando al método GetInstance():

var synchronousRealm = Realm.GetInstance(config);

Abrir un dominio de sincronización basado en particiones sin conexión

Una vez que un usuario se autentica, el User objeto permanece en el dispositivo hasta que cierra sesión. Esto permite que tu app recupere un usuario existente y abra un dominio sincronizado sin conexión. El SDK sincronizará los cambios que se produzcan sin conexión una vez que el dispositivo se vuelva a conectar a tu app.

El siguiente código muestra cómo comprobar si existe un objeto User. Si no se encuentra ninguno, se utiliza el proceso descrito anteriormente para obtener un usuario. Si el dispositivo ya tiene un user, se abre el dominio sincronizado con ese usuario:

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 de la sincronización basada en particiones a la sincronización flexible

Puedes migrar el modo de sincronización de dispositivos de App Services de la sincronización basada en particiones a la sincronización flexible. La migración es un proceso automático que no requiere cambios en el código de la aplicación. La migración automática requiere la versión 11.1.0 o posterior del SDK de Realm .NET.

La migración le permite conservar sus usuarios y configuración de autenticación de App Services. Flexible Sync ofrece opciones de configuración de permisos más versátiles y una sincronización de datos más granular.

Para obtener más información sobre cómo migrar su aplicación de App Services de sincronización basada en particiones a sincronización flexible, consulte Migrar modos de sincronización de dispositivos.

Migrar de dominios no sincronizados a dominios sincronizados

Puedes convertir un dominio no sincronizado en uno sincronizado (con sincronización basada en particiones). Para convertir un dominio no sincronizado en uno con sincronización basada en particiones, sigue estos pasos:

1. Abra el reino existente.

2. Crear una configuración para un nuevo reino.

3. Llame al método WriteCopy() en el reino existente para copiar los datos al nuevo reino.

En el siguiente código, abrimos un dominio no sincronizado, creamos un nuevo objeto PartitionSyncConfiguration y copiamos el dominio existente al nuevo. A continuación, eliminamos el dominio existente y abrimos el nuevo.

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