/ /

/ /

SDK de Dispositivo Atlas

Node.js SDK

Sync Data

Partition-Based Sync - Node.js SDK

Los SDK de dispositivos Atlas están obsoletos. Consulte deprecation page for details.

Atlas Device Sync tiene dos modos de sincronización: Sincronización flexible y sincronización basada en particiones. Recomendamos usar la sincronización flexible. La información de esta página está destinada a ayudar a los usuarios que ya tienen aplicaciones que usan la sincronización basada en particiones.

Nota

Matching Sync Modes with Atlas Device Sync

Al usar Atlas Device Sync en su aplicación cliente, su implementación debe coincidir con el modo de sincronización seleccionado en la configuración de la aplicación backend. Solo puede usar un modo de sincronización por aplicación. No puede combinar la sincronización basada en particiones y la sincronización flexible en la misma aplicación.

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.

El valor de la partición determina a qué datos puede acceder la aplicación cliente.

You pass in the partition value when you open a synced realm.

Abre un Realm sincronizado basado en particiones

Para abrir un dominio con sincronización basada en particiones, llame a Realm.open(). Pase un objeto de configuración, que debe incluir sync Propiedad que define un objeto SyncConfiguration. En SyncConfiguration, debe incluir user partitionValuey.

const config = {
  schema: [Car],
  sync: {
    user: app.currentUser,
    partitionValue: "myPartition",
  },
};
const realm = await Realm.open(config);

const config: Realm.Configuration = {
  schema: [Car],
  sync: {
    user: app.currentUser!,
    partitionValue: "myPartition",
  },
};
const realm = await Realm.open(config);

Importante

Offline Login is Supported for Partition-Based Sync Configurations You can open a realm immediately with background sync or after a timeout elapses using Partition-Based Sync.

Open a Bundled Partition-Based Synced Realm

Al abrir un realm sincronizado en paquete que use Partition-Based Sync, debes usar la misma llave de partición que se utilizó en la configuración original del realm. Si usas una llave de partición diferente, el SDK lanzará un error al abrir el Realm incluido.

Migrate from Partition-Based Sync to Flexible Sync

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.

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.

Actualizar el código de cliente después de la migración

The automatic migration from Partition-Based Sync to Flexible Sync does not require any changes to your client code. However, to support this functionality, Realm automatically handles the differences between the two Sync Modes by:

Automatically creating Flexible Sync subscriptions for each object type where partitionKey == partitionValue.
Inyectar un campo partitionKey en cada objeto si aún no existe uno. Esto es necesario para la suscripción automática de Flexible Sync.

Si necesitas realizar actualizaciones en el código cliente después de la migración, considera actualizar tu base de código cliente para remover funcionalidades ocultas de migración. Tal vez quieras actualizar tu base de código de cliente cuando:

Agregue un nuevo modelo o cambie un modelo en su base de código de cliente.
You add or change functionality that involves reading or writing Realm objects
Quieres implementar un control más específico sobre los datos que sincronizas

Make these changes to convert your Partition-Based Sync client code to use Flexible Sync:

Agregue flexible:true a su objeto SyncConfiguration donde abra un Realm sincronizado.
Agrega propiedades relevantes a tus modelos de objetos para usarlas en tus suscripciones de Flexible Sync. Por ejemplo, podrías agregar una propiedad ownerId para permitir que un usuario sincronice solo sus propios datos.
Remove automatic Flexible Sync subscriptions and manually create the relevant subscriptions.

For examples of Flexible Sync permissions strategies, including examples of how to model data for these strategies, refer to Device Sync Permissions Guide.

Remove and Manually Create Subscriptions

When you migrate from Partition-Based Sync to Flexible Sync, Realm automatically creates hidden Flexible Sync subscriptions for your app. The next time you add or change subscriptions, we recommend that you:

Esto le permite ver toda su lógica de suscripción junta en su base de código para futuras iteraciones y depuraciones.

For more information about the automatically-generated Flexible Sync subscriptions, refer to Migrate Client App to Flexible Sync.

Volver

Stream Data to Atlas

Registro