Restablecimientos de clientes

Overview

Un error de restablecimiento de cliente es un escenario en el que un dominio cliente no puede sincronizar datos con el backend de la aplicación. Los clientes en este estado pueden continuar ejecutándose y guardando datos localmente, pero no pueden enviar ni recibir conjuntos de cambios de sincronización hasta que realicen un restablecimiento de cliente. Los SDK de dominio proporcionan métodos para gestionar automáticamente los restablecimientos de cliente en la mayoría de los casos.

Los reinicios de clientes ocurren cuando el historial del servidor es incompatible con el del cliente. Las causas más comunes son:

• Fallos del servidor de Atlas App Services: Un servidor puede restaurarse desde una copia de seguridad con una versión anterior. En este caso, un restablecimiento del cliente restablecería la versión anterior y perdería los cambios guardados en el cliente pero no sincronizados con el servidor.

• Deshabilitar y volver a habilitar la sincronización: desactivar y volver a activar la sincronización en la interfaz de usuario de App Services hace que todos los clientes requieran un reinicio del cliente.

• Incompatibilidad de esquemas entre cliente y backend: Si una aplicación cliente intenta sincronizarse con el backend mientras usa un esquema de objeto de dominio que no existe en este, el cliente debe reiniciarlo. Esto solo aplica en una dirección: si el esquema del backend contiene una clase de objeto de dominio que no se usa en un cliente, este no necesita reiniciarlo.

• Tiempo máximo sin conexión del cliente: Cuando un cliente no se ha sincronizado con el backend durante más de los días indicados, ya no podrá sincronizar los cambios locales no sincronizados con el backend. El cliente debe descartar todos los cambios locales desde la última sincronización y descargar el estado actual del dominio desde el backend.

• Cambios de esquema disruptivos: Un cambio disruptivo o destructivo, como cambiar un tipo de propiedad o una clave principal, requiere que finalice y vuelva a habilitar la sincronización. Esto crea un nuevo archivo de dominio sincronizado con una versión no relacionada con el archivo del cliente. En este caso, el proceso de restablecimiento del cliente no puede completarse automáticamente, y la aplicación debe proporcionar un controlador manual de restablecimiento del cliente.

• Actualización de un clúster compartido a uno dedicado: Al actualizar de un clúster compartido a uno dedicado, debe finalizar la sincronización en el clúster anterior. Después de la actualización, puede volver a habilitar la sincronización. Desactivar y volver a activar la sincronización hace que todos los clientes requieran un reinicio.

• Cambios en el rol de sesión: Al usar la Sincronización Flexible, los cambios en el rol de sesión de un usuario provocan el restablecimiento del cliente. Los siguientes escenarios provocan el restablecimiento del cliente:

  • modificaciones del lado del servidor a la función de sesión

  • cambios en el valor de cualquier expansión en las expresiones "aplicar cuando", leer o escribir

  • cambios que califican al usuario para un rol de sesión diferente

  Nota

  Los cambios importantes en el esquema requieren una actualización del esquema de la aplicación

  Después de un cambio de esquema importante:

  • Todos los clientes deben realizar un reinicio manual del cliente.

  • Debe actualizar los modelos de cliente afectados por el cambio de esquema importante.

Gestionar un restablecimiento de cliente

Los SDK detectan automáticamente la necesidad de reiniciar el cliente. Pueden hacerlo automáticamente en la mayoría de los casos, excepto en caso de un cambio de esquema importante.

Durante un reinicio automático del cliente, el cliente:

1. Descarga una copia nueva del reino desde el backend.

2. Realiza una comparación para determinar los pasos necesarios para llevar la copia original (local) del reino al mismo estado que la copia nueva del backend.

3. Aplica ese conjunto de pasos para transformar el ámbito local en un estado donde pueda sincronizarse con el backend.

   Si no hay cambios de esquema, o solo hay cambios de esquema permanentes, el SDK intenta recuperar todos los cambios locales que aún no se han sincronizado con el backend. También aplica las inserciones, actualizaciones y eliminaciones del backend que aún no se han sincronizado con el cliente.

   Si ha optado por descartar los cambios no sincronizados en el SDK, o si el modo de recuperación no puede recuperarlos, el SDK puede descartar los cambios locales que aún no se hayan sincronizado con el backend. A continuación, puede aplicar cualquier inserción, actualización o eliminación del backend que aún no se haya sincronizado con el cliente. Para descartar los cambios locales, elija la versión de su SDK preferida. recoverOrDiscard modo de reinicio del cliente.

4. Descarta la copia nueva. La aplicación continúa usando la copia original del dominio con la diferencia aplicada.

En caso de un cambio de esquema disruptivo, o si falla el restablecimiento automático del cliente, este se ejecuta mediante un controlador manual de restablecimiento que la aplicación debe definir. Los SDK de Realm no pueden realizar automáticamente un restablecimiento del cliente al realizar un cambio de esquema disruptivo.

El modo de reinicio automático del cliente tiene varias ventajas en comparación con la recuperación manual:

• Su aplicación puede reiniciar un cliente sin escribir ninguna lógica personalizada, salvo especificar el modo. No es necesario iniciar manualmente el reinicio ni interactuar con el objeto de error.

• Tu aplicación puede reiniciar un cliente sin cerrar ningún dominio, desconectarse de la aplicación backend ni reiniciar manualmente. Esto significa que no necesitas escribir ninguna lógica para gestionar estas situaciones.

• Los usuarios de la aplicación reciben notificaciones de cambios a medida que el ámbito local se actualiza para coincidir con el estado del ámbito backend.

Habilitar o deshabilitar el modo de recuperación

El modo de recuperación está habilitado de forma predeterminada en todas las configuraciones de sincronización de dispositivos. Puedes deshabilitarlo o volver a habilitarlo si ya lo habías deshabilitado.