If your organization already has data in MongoDB Atlas, you can sync that data to client devices using Device Sync and Realm Database. Follow these high-level steps to get started:
Configurar Atlas Access
Crear una aplicación de Atlas App Services
La aplicación App Services es la puerta de entrada que permite que tu dispositivo cliente se conecte a MongoDB Atlas. Al crear una aplicación, debes ponerle nombre, vincularla a un clúster de Atlas y especificar el modelo de implementación y la región de implementación que mejor se adapten a tu aplicación.
Para saber cómo crear una aplicación de App Services,consulte Crear una aplicación.
Configure Device Sync
Device Sync is the service that manages synchronizing your Atlas data with your client devices. Device Sync, together with the Realm SDKs, automatically manages network connectivity, conflict resolution, user authentication, and user permissions and data access.
When you configure Device Sync, you specify the data source that the client devices can access, as well as the permissions that determine what data a user can read and write.
Puede configurar la Sincronización de Dispositivos mediante la interfaz de usuario de Atlas, la interfaz de línea de comandos de los Servicios de Aplicaciones de Atlas o la API de administración de los Servicios de Aplicaciones. La primera vez que configure la Sincronización de Dispositivos, puede resultarle útil usar la interfaz de usuario de Atlas, ya que proporciona enlaces e información sobre diversas configuraciones y opciones.
Habilita un proveedor de autenticación
Los usuarios de su cliente deben autenticarse para acceder a los datos sincronizados. App Services ofrece varios proveedores de autenticación para que sus usuarios puedan autenticarse. Configure uno o más de estos proveedores para habilitar la autenticación en su aplicación cliente.
Puede configurar proveedores de autenticación dentro de la interfaz de usuario de la aplicación App Services seleccionando Authentication En el menú de navegación izquierdo, haga clic en un proveedor para configurarlo. También puede configurar proveedores de autenticación editando la configuración de App Services con la interfaz de línea de comandos de Atlas App Services o API de administración de servicios de aplicaciones.
Generar modelos de objetos cliente
When you already have data in Atlas, you can generate object models that match that data to use in your client application.
To generate an object model, you must have an App Services schema. Once you have a schema, you can generate object models that match that schema. You can select a programming language to use to generate the schema, which you can then view and copy to use in your client application code.
Puede generar un esquema a partir de datos Atlas existentes mediante la interfaz de usuario de App Services. Para obtener más información, consulte: Crear un esquema de objeto de dominio a partir de un esquema de App Services.
Once you have a schema, you can generate a Realm object model using the App Services UI or the Atlas App Services Command Line Interface.
Add Sync to the Client Application
After this, you've got everything set up that you need on the Atlas side, and you can prepare your client application to sync data. Device Sync synchronizes data with Atlas using a Realm Database SDK. You can use the Realm SDK in your client application code to connect to Atlas and sync data with a Realm Database on the device.
Conectar el cliente a un backend de App Services
In your client application code, initialize an App client to connect your client to your App Services backend. This lets your client use App Services features like authentication, and enables opening a synced realm.
Open a Synced Realm
Una vez que tenga un usuario autenticado, puede abrir una instancia sincronizada de Realm Database para usarla para ese usuario.
You define a Flexible Sync query subscription in your client code to determine what data to sync to the client application. Device Sync looks for Atlas documents that match the query, which the user has permission to read and possibly write, and synchronizes those documents to the client device as Realm objects. You can add, remove, or update Flexible Sync query subscriptions to change the documents that sync to the device.
SDK de C++
Flutter SDK
Java SDK
Kotlin SDK
Kit de desarrollo de software .NET
Node.js SDK
React Native SDK
Kit de desarrollo de software de Swift
Utilice el reino sincronizado
La sintaxis para leer, escribir y observar cambios en un dominio sincronizado es idéntica a la de los dominios no sincronizados. Mientras trabaja con datos locales, un subproceso en segundo plano integra, carga y descarga conjuntos de cambios de forma eficiente. Cuando un usuario con permisos de escritura realiza cambios en el dispositivo, los datos se conservan localmente. Si el usuario tiene conexión de red, los datos se sincronizan automáticamente con Atlas y otros dispositivos.
Para obtener una guía rápida sobre cómo realizar tareas comunes con la base de datos de Realm, consulte los inicios rápidos del SDK de Realm.
Si prefieres estudiar una aplicación cliente funcional para aprender, algunos SDK ofrecen una aplicación de sincronización de dispositivos funcional, que llamamos aplicaciones de plantilla. Opcionalmente, puedes consultar tutoriales específicos del SDK basados en la aplicación de plantilla de sincronización de dispositivos.
SDK de C++
Flutter SDK
Java SDK
Kotlin SDK
Kit de desarrollo de software .NET
Node.js SDK
React Native SDK
Kit de desarrollo de software de Swift