Puedes usar Realm Studio para conectarte a MongoDB Atlas utilizando Device Sync. Realm Studio funciona como un cliente de sincronización, similar a una aplicación que utiliza Device Sync. Puedes:
Agregar y eliminar suscripciones en el esquema de objeto enfocado.
Interactúa con datos de Atlas directamente desde Realm Studio.
Usa Realm Studio para ver los cambios en los datos que realizas al ejecutar una aplicación en desarrollo o para experimentar con cambios en permisos y suscripciones.
Requisitos previos
Versión mínima de Realm Studio: 14.1.2.
Debido a que Device Sync conecta Realm Studio al backend de App Services a través de una aplicación Atlas App Services, debe seguir estos pasos antes de poder comenzar:
Una aplicación de Atlas App Services con autenticación habilitada. Para saber cómo, consulte Cree una aplicación de App Services en la documentación de App Services.
El ID de la aplicación de Servicios de aplicaciones. Para saber cómo encontrarlo, consulta "Buscar el ID de tu aplicación".
Realm Studio puede conectarse a través de Device Sync utilizando cualquiera de estos tipos de proveedores de autenticación:
Anónimo
Correo electrónico y contraseña
Llave API
JWT
Si su aplicación utiliza autenticación por correo electrónico y contraseña, clave API o JWT, debe crear una credencial del tipo adecuado para usarla al conectarse desde Realm Studio. Para obtener más información sobre cómo crear credenciales, consulte la documentación de App Services:
Conéctese a Atlas desde Realm Studio
Proporcione los metadatos solicitados
Proporcione el ID de la aplicación.
Si su aplicación de App Services utiliza una URL personalizada, especifique la URL.
Selecciona la forma de autenticación que utiliza tu aplicación. Si seleccionas un formulario de autenticación que requiera credenciales, proporciona las credenciales.
Conectar
Haga clic en Connect.
Tras conectarse correctamente, Realm Studio muestra el ID de la aplicación en la barra de menú de la ventana de la aplicación. Puede abrir conexiones a varias aplicaciones de App Services simultáneamente. También puede abrir varias conexiones a la misma aplicación de App Services si desea ver los cambios en tiempo real.
Especificar los datos a sincronizar
Después de conectarse a Atlas, Realm Studio muestra una lista de tipos de objetos que coinciden con los esquemas de su aplicación de App Services.
Para obtener más información sobre los esquemas de App Services, consulte Esquemas en la documentación de App Services.
Realm Studio asigna estos esquemas a objetos de Realm. Para obtener información sobre cómo se asignan estos esquemas a objetos de Realm mediante Device Sync, consulte "Asignación de modelos de datos" en la documentación de App Services.
No podrás ver los datos de los tipos de objeto hasta que agregues suscripciones para cada tipo de objeto. Las suscripciones, junto con los permisos que hayas definido para tu aplicación, determinan qué datos se sincronizan.
Para comenzar a visualizar datos de un tipo de objeto Realm específico, agregue una suscripción. Para cambiar los datos que ves, puedes:
Agregue más suscripciones para aplicar filtros adicionales.
Remueve una suscripción.
No puedes cambiar una suscripción que hayas añadido a Realm Studio. Para cambiarla, elimínala y añade una nueva.
Añadir una suscripción
Proporcionar una consulta
Utilice el lenguaje de consulta de Realm (RQL) para crear una consulta para los objetos que desea sincronizar con Realm Studio. Solo los objetos que coincidan con su consulta aparecerán en Realm Studio. Puede usar esto para validar consultas rápidamente al desarrollar su aplicación.
Su consulta de suscripción debe incluir al menos un campo consultable. Para obtener más información sobre los campos consultables, consulte Campos consultables en la documentación de App Services.
Para obtener información sobre los operadores de consulta disponibles, consulte la referencia del lenguaje de consulta Realm.
Device Sync admite el uso de un subconjunto de operadores RQL en las consultas de suscripción de sincronización. Para obtener información sobre estas limitaciones, consulte Limitaciones de RQL de la sincronización flexible.
Ejemplo
Si inicia Device Sync con una aplicación de plantilla, la suscripción que utilizan las aplicaciones de plantilla es:
`owner_id == "${user?.id}"`
Para ver los datos aplicables en Realm Studio, utilice esta consulta con el ID de un usuario específico:
owner_id == "67ee25f483c29fa14cfd7295"
Para ver todos los datos donde las credenciales que proporcionó a Realm Studio tienen los permisos adecuados, utilice la consulta:
TRUEPREDICATE
Añadir la suscripción
Haga clic en Add subscription para completar el proceso de añadir una suscripción. Esto activará una sincronización inicial con Device Sync para:
Elementos del tipo de objeto seleccionado.
Que coinciden con la consulta de suscripción que usted proporciona.
Donde las credenciales que utilizó para iniciar sesión en Realm Studio tienen permisos para ver el elemento.
Después de un momento, verá que el número de objetos cambia de 0 para reflejar el número de objetos que cumplen con este criterio.
Agregue suscripciones a más objetos según sea necesario
Su aplicación de Servicios de Aplicaciones puede tener esquemas para varios tipos de objetos. Debe agregar suscripciones individualmente para cada tipo de objeto que desee ver en Realm Studio.
Si sus objetos incluyen vínculos a otros objetos, como en relaciones de uno a muchos, los objetos vinculados no aparecen en Realm Studio hasta que haya agregado la suscripción adecuada en los tipos de objetos vinculados.
Remover una suscripción
Remover la suscripción
Haga clic en el icono para eliminar una suscripción. Si no ve el icono, arrástrelo para ampliar el panel izquierdo. Las suscripciones largas pueden hacer que el icono deje de estar visible.
Los datos que coinciden con la suscripción desaparecen de Realm Studio después de eliminar la suscripción.
Ver cambios sincronizados en tiempo real
Una vez que hayas añadido una suscripción, si tus credenciales lo permiten según las reglas de tu aplicación, podrás crear, actualizar y eliminar objetos. Al realizar cambios en los objetos mientras estás conectado a Device Sync, estos se sincronizan automáticamente con Atlas y con otros dispositivos. Puedes ver tus cambios reflejados en tiempo real.
Para obtener información sobre cómo crear, modificar y eliminar objetos en Realm Studio, consulte Modificar objetos en un archivo de Realm. No necesita hacer nada para guardar los cambios que realice mientras esté conectado con Device Sync. Estos cambios se sincronizan automáticamente con el servidor y se guardan en Atlas.
Si intenta modificar o agregar un objeto que no coincide con sus suscripciones o para el que no tiene permisos de escritura, Device Sync reacciona con un error de escritura compensatorio. Realm Studio revierte esos cambios y no se sincronizan con Atlas ni con otros dispositivos. Para obtener más información, consulte ErrorCompensatingWrite en la sección "Errores de sincronización flexible" de la documentación de App Services.