Partition-Based Sync - .NET SDK

valor de la 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.

The partition value determines which data the client application can access. You pass in the partition value when you open a synced realm.

Open a Partition-Based Sync Realm While Online

Los pasos para abrir un realm sincronizado mientras estás en linea son:

1. Your app code walks the user through authenticating.

2. Create a PartitionSyncConfiguration object that includes the partition value and the User object.

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

In the above example, the code shows how to open the realm asynchronously by calling GetInstanceAsync(). You can also open a realm synchronously by calling the GetInstance() method:

var synchronousRealm = Realm.GetInstance(config);

Open a Partition-Based Sync Realm While Offline

Once a user authenticates, the User object persists on the device until the user logs off. This allows your app to retrieve an existing user and open a synced realm in an offline state. Changes that occur while offline will be synced by the SDK once the device reconnects to your App.

El siguiente código muestra cómo comprobar si existe un objeto User. Si no hay ninguno, utiliza el proceso que se indica arriba para obtener un usuario. Si el dispositivo ya tiene un user, se abre el realm 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);
}

Migrate from Partition-Based Sync to Flexible Sync

You can migrate your App Services Device Sync Mode from Partition-Based Sync to Flexible Sync. Migrating is an automatic process that does not require any changes to your application code. Automatic migration requires Realm .NET SDK version 11.1.0 or newer.

Migrating enables you to keep your existing App Services users and authentication configuration. Flexible Sync provides more versatile permissions configuration options and more granular data synchronization.

For more information about how to migrate your App Services App from Partition-Based Sync to Flexible Sync, refer to Migrate Device Sync Modes.

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. Abre el realm 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.

In the following code, we open a non-synced realm, create a new PartitionSyncConfiguration object and then copy the existing realm to the new realm. We then delete the existing realm and open the new 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);