Sincronización basada en particiones - SDK de React Native

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.

Pasa el valor de la partición cuando abres un reino sincronizado.

Configurar un dominio de sincronización basado en particiones

Para abrir un reino de sincronización flexible, use @realm/reactLa función createRealmContext() y su valor devuelto RealmProvider.

En un RealmProvider que está anidado en UserProvider un, agregue una sync propiedad con un objeto SyncConfiguration que flexible: true contenga.

Tenga en cuenta que UserProvider pasa automáticamente un usuario autenticado a RealmProvider.

<RealmProvider
  schema={[YourObjectModel]}
  sync={{
    partitionValue: 'testPartition',
  }}>
  <RestOfApp />
</RealmProvider>

Copiar datos y abrir un nuevo reino

Para copiar datos de un reino existente a un nuevo reino con diferentes opciones de configuración, pase la nueva configuración al método Realm.writeCopyTo().

En la configuración del nuevo reino, debes especificar.path

Si escribe el dominio copiado en un archivo de dominio ya existente, los datos se escriben objeto por objeto. La operación de copia reemplaza los objetos si ya existen para las claves primarias dadas. Los esquemas del dominio que copia y del dominio en el que escribe deben ser compatibles para que la operación de copia se realice correctamente. Solo se copian los objetos de los esquemas de ambas configuraciones.

El cambio de configuración puede incluir modificaciones en SyncConfiguration:

• Reino local a reino sincronizado

• Reino sincronizado con el reino local

El cambio de configuración también puede incluir cambios en la propiedad encryptionKey del Configuration:

• Reino cifrado a reino no cifrado

• Reino no cifrado a reino cifrado

const localConfig = {
  schema: [Car],
  path: "localOnly.realm",
};
const localRealm = await Realm.open(localConfig);
const syncedConfig = {
  schema: [Car],
  path: "copyLocalToSynced.realm",
  sync: {
    user: app.currentUser,
    partitionValue: "myPartition",
  },
};
localRealm.writeCopyTo(syncedConfig);
const syncedRealm = await Realm.open(syncedConfig);

const localConfig: Realm.Configuration = {
  schema: [Car],
  path: "localOnly.realm",
};
const localRealm = await Realm.open(localConfig);
const syncedConfig: Realm.Configuration = {
  schema: [Car],
  path: "copyLocalToSynced.realm",
  sync: {
    user: app.currentUser!,
    partitionValue: "myPartition",
  },
};
localRealm.writeCopyTo(syncedConfig);
const syncedRealm = await Realm.open(syncedConfig);

También puede combinar cambios en la configuración. Por ejemplo, puede abrir un dominio cifrado local como un dominio sincronizado sin cifrar, o un dominio sincronizado sin cifrar como un dominio sincronizado y cifrado.

// Create a secure key.
const encryptionKey = new Int8Array(64);
// ... store key
const syncedEncryptedConfig = {
  schema: [Car],
  path: "syncedEncrypted.realm",
  sync: {
    user: app.currentUser,
    partitionValue: "myPartition",
  },
  encryptionKey,
};
const syncedEncryptedRealm = await Realm.open(syncedEncryptedConfig);
const localUnencryptedConfig = {
  schema: [Car],
  path: "copyLocalUnencrypted.realm",
};
syncedEncryptedRealm.writeCopyTo(localUnencryptedConfig);
const localUnencryptedRealm = await Realm.open(syncedEncryptedConfig);

// Create a secure key.
const encryptionKey = new Int8Array(64);
// ... store key
const syncedEncryptedConfig: Realm.Configuration = {
  schema: [Car],
  path: "syncedEncrypted.realm",
  sync: {
    user: app.currentUser!,
    partitionValue: "myPartition",
  },
  encryptionKey,
};
const syncedEncryptedRealm = await Realm.open(syncedEncryptedConfig);
const localUnencryptedConfig: Realm.Configuration = {
  schema: [Car],
  path: "copyLocalUnencrypted.realm",
};
syncedEncryptedRealm.writeCopyTo(localUnencryptedConfig);
const localUnencryptedRealm = await Realm.open(syncedEncryptedConfig);

Migrar de la sincronización basada en particiones a la sincronización flexible

Puedes migrar tu App Services Device Sync Mode de Partition-Based Sync a Flexible Sync. La migración es un proceso automático que no requiere ningún cambio en el código de tu aplicación. La migración automática requiere la versión 11.10.0 o superior del SDK de Realm Node.js.

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.