Para sincronizar datos entre dispositivos, habilite la sincronización de dispositivos y luego use los métodos y propiedades relacionados con la sincronización en SDK del dispositivo Atlas.
Tip
Mira el tutorial
Si prefiere aprender con el ejemplo, consulte el tutorial de sincronización de dispositivos, que utiliza una aplicación de lista de tareas pendientes sincronizada con clientes para plataformas comunes compatibles con App Services.
Antes de comenzar
Si aún no tiene una, regístrese para obtener una cuenta gratuita de MongoDB Atlas.
La sincronización de dispositivos requiere un clúster Atlas con MongoDB versión 5.0 o posterior. Puede usar un clúster M compartido gratuito0 para explorar y desarrollar su aplicación. Recomendamos usar un clúster de nivel dedicado (M10 y superior) para aplicaciones de producción. No puede usar la sincronización con una instancia sin servidor ni una instancia de base de datos federada.
If you don't already have one, create a new App Services App linked to your Atlas cluster.
Configurar su modelo de datos
Elija un SDK
Atlas Device SDK envuelve Realm Core Database, una base de datos de objetos optimizada para dispositivos móviles. El SDK, disponible para varios lenguajes y plataformas, incluye todo lo necesario para trabajar con bases de datos sincronizadas en el código del cliente. Se pueden usar varios lenguajes de SDK para trabajar con el mismo conjunto de datos sincronizados a través de dispositivos y plataformas.
Esta guía se centra en configurar Device Sync con el SDK. Para obtener una documentación más detallada, que incluya detalles sobre cómo instalar y utilizar el Atlas Device SDK de manera general, consulte los SDK docs:
Nota
Using Device Sync with the Realm JS WebAssembly SDK
Para obtener más información sobre cómo crear aplicaciones web en tiempo real para el navegador con la API de base de datos de Realm y Atlas Device Sync, consulte Introducción a Realm Web y Atlas Device Sync (versión preliminar). También puede consultar los mismos datos en un clúster de Atlas mediante MongoDB Data Access.
Definir modelo de datos
Una base de datos sincronizada utiliza modelos de objetos definidos por el usuario para determinar el tipo de objetos en la base de datos. Además, Sync requiere un esquema de documento del servidor para cada tipo de objeto sincronizado, de modo que el servidor pueda traducir y aplicar cambios entre las bases de datos sincronizadas y MongoDB Atlas.
To define your synced object models, do one of the following for each object type:
Sync object models from an SDK: In Development Mode, you can automatically generate a document schema for each synced object type and assigns that schema to a collection in the linked cluster with the same name as the object type. Development mode lets you configure your synced data model from a client application using the same object models and code that you use in your production app. This is useful if you prefer a client-first approach that uses idiomatic object models in your preferred programming language.
Para comenzar, consulte Crear un modelo de datos.
Generar modelos de objetos a partir de un esquema de documento: Si ya tiene datos en Atlas, puede generar automáticamente modelos de objetos específicos del lenguaje que coincidan con los esquemas de documento definidos para el clúster sincronizado de su aplicación. Puede definir estos esquemas manualmente o App Services puede muestrear los datos existentes en el clúster para crearlos automáticamente. Esto resulta útil si prefiere un enfoque centrado en el servidor o si planea crear aplicaciones con varios SDK.
For a walkthrough of how to generate object models that you can use in your client applications, see Generate SDK Object Models.
Una vez que tenga los modelos de objetos generados, puede copiarlos directamente en su aplicación cliente y usarlos de la misma manera que lo haría con cualquier objeto o estructura normal en su lenguaje de programación preferido.
Define Data Access Patterns
Una vez que haya decidido el modelo de datos de su aplicación, puede definir un patrón de acceso a datos y reglas de acceso para los datos de su aplicación.
Client applications can query the queryable fields of a document to determine which objects to sync. Then, App Services applies rules and default roles to determine whether users can read or write the objects that match the query.
Definir reglas de acceso a datos
Las reglas de acceso a los datos determinan los datos que se sincronizan, así como la capacidad de cada usuario para leer y escribir datos. Las reglas están estrechamente vinculadas al modelo de datos de tu aplicación.
With Device Sync, you specify which data to sync through queries for matching objects in a client application. App Services then evaluates roles and rules to determine which of those matching objects a user can read and write.
Puedes definir roles en colecciones específicas. Los roles por defecto proporcionan permisos de lectura y guardar cuando los roles más específicos no se aplican. Los roles por defecto se aplican a todas las colecciones a las que una aplicación puede acceder, pero puedes restringir un rol a una colección específica especificando el nombre de la colección.
Configurar sincronización
La sincronización de dispositivos le permite especificar cómo los clientes pueden acceder a los datos en su aplicación. Para obtener una guía sobre cómo habilitar y configurar la sincronización, consulte Configurar y habilitar la sincronización de dispositivos Atlas.
Optimizar el uso de datos de sincronización
Device Sync sincroniza todos los datos de las colecciones con un esquema definido en tu clúster de Atlas. Si no se especifica un campo en el esquema, Device Sync no sincronizará ese campo con los clientes.
Sync almacena datos de servicios públicos en su clúster sincronizado para facilitar la sincronización con los clientes. Device Sync cuenta con optimizaciones integradas para reducir la cantidad de datos de servicios públicos almacenados en clústeres sincronizados. Si desea reducir aún más la cantidad de datos de servicios públicos para adaptarla a su caso de uso, consulte nuestra guía para optimizar el uso de Device Sync Atlas.
Crear consultas en su aplicación cliente
Con la sincronización de dispositivos habilitada, puede comenzar a crear consultas desde su aplicación cliente.
El SDK de dispositivos Atlas proporciona métodos para crear, actualizar y eliminar consultas de la aplicación cliente. Los SDK utilizan suscripciones para mantener dichas consultas en el cliente. Mediante estas suscripciones, las aplicaciones sincronizan objetos con la aplicación backend y pueden detectar y reaccionar ante los cambios.
Para crear queries desde tu aplicación cliente, consulta la documentación del SDK de Atlas Device en tu lenguaje de programación preferido:
Advertencia
Query Size Limit
The size limit for queries from your client application when using Device Sync is 256 kB. Exceeding this limit in a query results in a LimitsExceeded Error.
Importante
Flexible Sync Ignores Custom Collation
La sincronización flexible ignora cualquier intercalación personalizada que haya configurado en una colección de MongoDB en Atlas. En cambio, las colecciones sincronizadas siempre usan
{locale: "simple"} al evaluar suscripciones o permisos de sincronización.