Realm en Swift es una base de datos orientada a objetos que una app puede usar para guardar información directamente en el dispositivo. En lugar de convertir cada objeto en una cadena JSON y gestionar a mano su lectura y escritura, defines modelos y trabajas con ellos desde Swift. El cambio más importante para elegirlo hoy es separar el almacenamiento local de la sincronización: son funciones distintas y no deben darse por incluidas una en la otra.
Realm encaja cuando una aplicación necesita conservar datos estructurados, consultarlos con frecuencia y reflejar cambios en la interfaz. No sustituye automáticamente a una API, a una base de datos de servidor ni a la lógica que decide qué datos se comparten entre dispositivos. La elección también depende de si el equipo prefiere Realm o las opciones integradas de Apple, como SwiftData y Core Data.
Qué hace Realm dentro de una aplicación iOS
La biblioteca guarda objetos en un archivo de base de datos local y permite recuperarlos mediante consultas. Por ejemplo, una app de notas podría tener un modelo con título, texto y fecha de modificación; Realm se encarga de persistir esos valores y ofrecer resultados consultables sin que la app tenga que serializar cada nota por su cuenta.
Este modelo resulta útil cuando los datos forman relaciones claras: una lista tiene varias tareas, una tarea pertenece a un proyecto o un registro se puede buscar por estado. Realm mantiene los objetos asociados a la base de datos y permite observar cambios para actualizar la interfaz. Esa integración no elimina la necesidad de decidir qué ocurre si el usuario borra un elemento, modifica dos veces el mismo dato o restaura una copia de seguridad.
Modelo y objeto guardado no son lo mismo que un diccionario
En una base de datos de objetos, las clases o estructuras compatibles con el SDK describen los campos que se almacenan. La forma concreta de declarar modelos ha cambiado entre versiones, así que el código debe corresponder a la versión de Realm Swift instalada en el proyecto. En ejemplos antiguos es habitual encontrar clases que heredan de Object; las versiones recientes también incorporan otras formas de definir modelos, incluidas opciones basadas en macros.
Un modelo hipotético de tarea tendría un identificador estable, un texto y un indicador de finalización. El identificador importa más que el nombre visible: si el texto cambia, la app debe poder seguir reconociendo que se trata de la misma tarea. Para los campos también hay que decidir qué valores pueden faltar, cuáles tienen valores iniciales y qué relaciones deben guardarse.
Una escritura tiene que ser explícita
Las modificaciones de los objetos persistentes se realizan dentro de una transacción de escritura. Así, la base de datos sabe qué cambios debe confirmar como una operación coherente. El patrón conceptual es abrir una instancia de Realm, localizar o crear el objeto y modificarlo dentro de una escritura; la sintaxis exacta varía según la versión del SDK.
// Ejemplo conceptual: el modelo y la API concreta dependen
// de la versión de Realm Swift del proyecto.
try realm.write {
tarea.completada = true
}
Si la transacción falla, la app debe tratar el error en vez de asumir que el cambio quedó guardado. También conviene evitar escrituras innecesarias desde acciones que se ejecutan repetidamente, como cada pulsación de una tecla. En ese caso, se puede agrupar el trabajo o guardar cuando tenga sentido para la experiencia, manteniendo claro qué datos podrían perderse si la app se cierra antes.
Para una operación que pueda repetirse —por ejemplo, importar tareas— define cómo impedir duplicados. Una estrategia común es buscar por un identificador único y actualizar el registro existente en vez de insertar uno nuevo cada vez. La elección depende del modelo y de las reglas de la aplicación; Realm no decide qué significa «duplicado» para el producto.
Consultas, cambios y concurrencia
Las consultas permiten filtrar y ordenar los objetos guardados sin cargar necesariamente todos los registros como una colección independiente. En una pantalla de tareas, por ejemplo, se puede mostrar solo las pendientes y ordenarlas por fecha. Si la pantalla necesita reaccionar cuando cambie el resultado, Realm ofrece mecanismos de observación, aunque la forma de conectarlos depende de si la interfaz usa UIKit o SwiftUI y de la API disponible en el SDK.
Hay una diferencia importante entre observar datos y poder compartir cualquier objeto sin restricciones entre hilos o tareas. Los objetos de Realm tienen reglas de acceso vinculadas a la instancia y al contexto de ejecución. Pasar una referencia directamente de un hilo a otro puede causar errores. En código concurrente, sigue las recomendaciones de la versión instalada: consulta y modifica los datos en el contexto permitido, o utiliza los mecanismos de transferencia que proporcione el SDK. No des por hecho que una referencia observada en la interfaz se puede usar sin más desde una tarea en segundo plano.
En una app SwiftUI, los contenedores y propiedades de Realm pueden facilitar la observación y la presentación de resultados, pero no sustituyen el diseño de estados de carga, errores y pantallas vacías. Si una consulta no devuelve resultados, la interfaz debe distinguir entre «aún no hay datos» y «no se pudo leer la base de datos» cuando esa diferencia sea relevante.
Realm local no equivale a sincronización entre dispositivos
El almacenamiento local permite que cada instalación conserve sus propios datos. Para que una nota escrita en un iPhone aparezca también en un iPad hacen falta una estrategia de sincronización, una cuenta o identidad de usuario y reglas para resolver cambios simultáneos. Una base local por sí sola no envía datos a un servidor ni los comparte con otros dispositivos.
Además, Realm ha estado asociado a servicios de MongoDB para sincronizar datos con Atlas. MongoDB anunció la retirada de Atlas Device Sync y de sus SDK de Device a partir del 30 de septiembre de 2025; el SDK de base de datos local siguió un camino independiente como proyecto de código abierto. Por eso, al iniciar o mantener un proyecto, comprueba qué paquete y qué versión estás usando y no confundas la biblioteca local con el servicio de sincronización. Si necesitas sincronización, tendrás que elegir una solución compatible y definir cómo se comportan los conflictos y la autenticación.
Migraciones: el trabajo que aparece al cambiar el modelo
Una vez que hay usuarios con datos guardados, cambiar un modelo exige pensar en las instalaciones que conservan una versión anterior de la base de datos. Añadir un campo opcional puede ser sencillo; renombrar un campo, cambiar su tipo o dividirlo en varios requiere decidir cómo transformar los valores existentes. Si la migración no conserva el significado de los datos, una actualización puede dejar información inutilizable aunque la app se abra.
Antes de publicar una modificación del esquema, prepara casos de prueba con bases de datos creadas por versiones anteriores. Comprueba tanto una actualización normal como los registros incompletos o antiguos que el modelo ya no esperaba. Para cambios que no puedan transformarse de forma segura, quizá sea mejor crear una nueva estructura y copiar los datos con una regla explícita que borrarlos sin aviso.
Realm frente a SwiftData y Core Data
Realm suele ser atractivo por su modelo de objetos y sus consultas integradas; SwiftData y Core Data ofrecen alternativas del ecosistema Apple para persistencia en sus plataformas. La decisión no se reduce a cuál requiere menos líneas de código: también entran en juego la compatibilidad con las versiones de iOS que se quieran admitir, las herramientas del equipo, el formato de los datos y las necesidades de sincronización.
- Elige Realm si el proyecto ya lo utiliza, sus modelos y consultas resuelven bien el problema y el equipo puede mantener su ciclo de versiones y migraciones.
- Valora SwiftData o Core Data si buscas una solución integrada con Apple y sus patrones encajan con la arquitectura de la aplicación.
- Usa almacenamiento sencillo, como preferencias, para ajustes pequeños; no conviertas una base de datos de objetos en el lugar donde guardar indiscriminadamente cualquier valor.
Si se trata de una aplicación nueva, prueba la operación más representativa antes de decidir: crear registros, buscarlos, actualizarlos y migrarlos. El ejemplo mínimo que funciona en una pantalla no basta para demostrar que la opción servirá cuando haya datos antiguos, uso sin conexión o sincronización externa. Para situar esta decisión dentro del trabajo más amplio de una app, puedes consultar la sección de Swift para iOS.
La comprobación práctica es sencilla: identifica si necesitas guardar datos solo en el dispositivo o compartirlos; confirma qué versión de Realm Swift ofrece las APIs que requiere el proyecto; y prueba la migración desde un esquema anterior. Con esas tres respuestas se evita el error más habitual: escoger Realm pensando que el guardado local, la observación de cambios y la sincronización remota son una única función.
