Mapeo de modelos de datos

Mapeo con modo de desarrollo

Al habilitar el modo de desarrollo en la configuración de sincronización de dispositivos, App Services puede crear automáticamente colecciones y esquemas para los objetos de la base de datos de Realm que sincronice. Estas colecciones se crean en la base de datos que especifique al habilitar el modo de desarrollo.

Con el Modo de Desarrollo habilitado, Sync busca una colección cuyo esquema de App Services tenga un title que coincida con el nombre del tipo de objeto de la base de datos de Realm. Esta colección puede estar en cualquier base de datos de la fuente de datos vinculada. No es necesario que esté en la base de datos que agregue al configurar el Modo de Desarrollo.

Si no hay un title correspondiente en ningún esquema de App Services de tu fuente de datos vinculada, App Services crea una nueva colección para este tipo de objeto. Esta colección se crea en la base de datos que especifiques al habilitar el modo de desarrollo. El nombre de la colección coincide con el tipo de objeto, y el esquema de App Services correspondiente tiene un campo title cuyo valor es el nombre del tipo de objeto. Esto crea la asignación entre el objeto de la base de datos de Realm y la nueva colección.

Nombre del tipo

El campo title contiene el nombre del tipo de objeto representado por el esquema. Esto equivale a un nombre de clase o esquema en un SDK de dispositivo Atlas. El nombre del tipo debe ser único entre todos los esquemas del clúster sincronizado; de lo contrario, es arbitrario y no necesita coincidir con el nombre de la colección.

Un enfoque convencional consiste en nombrar cada tipo de objeto con un sustantivo singular, como "Perro" o "Persona". Los esquemas generados en modo de desarrollo o mediante el muestreo de documentos existentes utilizan esta convención.

Tipos de propiedad

Puede configurar las siguientes restricciones para una propiedad determinada:

Para obtener detalles específicos del SDK sobre los tipos de datos, consulte lo siguiente:

• Tipos admitidos - SDK de C++

• Tipos de datos - SDK de Flutter

• Tipos de datos de Realm - SDK de Java

• Tipos compatibles - SDK de Kotlin

• Tipos de campo - .NET SDK

• Tipos de datos de Realm - SDK de Node.js

• Tipos de propiedad - SDK de React Native

• Tipos de propiedades compatibles - Swift SDK

Propiedades del arreglo

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten propiedades de matriz.

Para obtener detalles específicos del SDK sobre las propiedades de la matriz, consulte lo siguiente:

• Tipos admitidos - SDK de C++

• Tipos de Dart - SDK de Flutter

• Listas - SDK de Java

• Tipos compatibles - SDK de Kotlin

• Listas - SDK .NET

• Tipos de propiedades compatibles - SDK de Node.js

• Tipos de propiedades compatibles - SDK de React Native

• Tipos admitidos - Swift SDK

Para obtener más información sobre el modelado de propiedades de matriz en un esquema de App Services, consulte Tipos BSON - Matriz. Los esquemas de App Services admiten ciertas restricciones que los modelos de objetos del SDK no admiten, como especificar el número mínimo y máximo de elementos.

Propiedades mixtas

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten propiedades de tipo mixto.

Un campo mixto puede contener cualquier tipo de datos admitido y actúa funcionalmente como un objeto o documento sin una estructura predefinida.

Para obtener más información sobre cómo modelar propiedades mixtas en un esquema de App Services, consulte Mixto: Tipos de esquema.

Objetos incrustados

Los objetos incrustados se integran como datos anidados dentro de un objeto principal. Un objeto incrustado hereda el ciclo de vida de su objeto principal. No puede existir como un objeto de base de datos independiente.

Para obtener detalles específicos del SDK sobre objetos integrados, consulte lo siguiente:

• Definir un objeto incrustado - SDK de C++

• Objetos incrustados - SDK de Flutter

• Definir un campo de objeto incrustado - SDK de Java

• Objetos incrustados - SDK de Kotlin

• Objetos Incrustados - .NET SDK

• Objetos incrustados - SDK de Node.js

• Objetos incrustados - SDK de React Native

• Definir una propiedad de objeto incrustado - Swift SDK

Para obtener más información sobre cómo modelar relaciones de uno a uno en un esquema de App Services, consulte Relaciones de objetos integrados.

Establece

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten el tipo de datos Conjunto. Un conjunto es una colección de valores únicos.

Para obtener detalles específicos del SDK sobre conjuntos, consulte lo siguiente:

• Conjunto - SDK de C++

• RealmSet - SDK de Flutter

• RealmSet - Java SDK

• RealmSet - Kotlin SDK

• Conjuntos - SDK .NET

• Conjuntos - SDK de Node.js

• Conjuntos - SDK de React Native

• Conjunto mutable - Swift SDK

Para obtener más información sobre el modelado de conjuntos en un esquema de App Services, consulte Conjunto.

Diccionarios

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten el tipo de dato Diccionario. Un conjunto es una colección de valores únicos. Un diccionario es una colección de claves de cadena dinámicas y únicas emparejadas con valores de un tipo determinado. Un diccionario es funcionalmente un objeto o documento sin nombres de campo predefinidos.

Para obtener detalles específicos del SDK sobre los diccionarios, consulte lo siguiente:

• Mapa/Diccionario - SDK de C++

• Mapa del reino - SDK de Flutter

• RealmDictionary - Java SDK

• Diccionario Real - SDK de Kotlin

• Diccionarios - .NET SDK

• Diccionarios - SDK de Node.js

• Diccionarios - React Native SDK

• Mapa/Diccionario - Swift SDK

Para obtener más información sobre el modelado de diccionarios en un esquema de App Services, consulte Diccionario.

Esquema de servicios de aplicaciones

Este esquema de servicios de aplicaciones crea el modelo de datos Dog utilizado por Device Sync.

{
  "title": "Dog",
  "bsonType": "object",
  "required": [
    "_id",
    "name"
  ],
  "properties": {
    "_id": {
      "bsonType": "objectId"
    },
    "name": {
      "bsonType": "string"
    },
    "age": {
      "bsonType": "int"
    }
    "breed": {
      "bsonType": "string"
    }
    "details": {
      "bsonType": "mixed"
    }
  }
}

Modelo de objetos del SDK

Los siguientes ejemplos de código crean el modelo de objeto del SDK Dog en cada uno de los SDKs de Dispositivos Atlas.

import Foundation
import RealmSwift
class Dog: Object {
    @Persisted(primaryKey: true) var _id: ObjectId
    @Persisted var age: Int?
    @Persisted var breed: String?
    @Persisted var name: String = ""
    @Persisted var details: AnyRealmValue
}

import io.realm.RealmObject;
import org.bson.types.ObjectId;
public class Dog extends RealmObject {
    @PrimaryKey
    @Required
    private ObjectId _id;
    private Integer age;
    private String breed;
    @Required
    private String name;
    private RealmAny details;
    // Standard getters & setters
    public ObjectId getId() { return _id; }
    public void setId(ObjectId _id) { this._id = _id; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public String getBreed() { return breed; }
    public void setBreed(String breed) { this.breed = breed; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public RealmAny getDetails() { return details; }
    public void setDetails(RealmAny details) { this.details = details; }
}

import io.realm.RealmObject;
import org.bson.types.ObjectId;
open class Dog : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId(),
    var age: Int? = null,
    var breed: String? = null,
    var name: String = ""
    var details: RealmValue? = null
}

import 'package:realm/realm.dart';
part 'realm_models.realm.dart';
@RealmModel()
class _Dog {
  @PrimaryKey()
  @MapTo('_id')
  late ObjectId id;
  int? age;
  String? breed;
  late String name;
  late RealmValue details;
}

using System;
using System.Collections.Generic;
using Realms;
using MongoDB.Bson;
public class Dog : RealmObject
{
    [MapTo("_id")]
    [PrimaryKey]
    public ObjectId Id { get; set; }
    [MapTo("age")]
    public int? Age { get; set; }
    [MapTo("breed")]
    public string Breed { get; set; }
    [MapTo("name")]
    [Required]
    public string Name { get; set; }
    [MapTo("details")]
    public RealmValue Details { get; set; }
}

export const DogSchema = {
  name: 'Dog',
  properties: {
    _id: 'objectId',
    age: 'int?',
    breed: 'string?',
    name: 'string',
  },
  primaryKey: '_id',
  details: 'mixed',
};

export const DogSchema = {
   class Dog extends Realm.Object<Dog> {
     _id!: Realm.BSON.ObjectId;
       age?: number;
       breed?: string;
       name!: string;
       details?: Realm.Mixed;
     static schema: ObjectSchema = {
       name: 'Dog',
         properties: {
           _id: 'objectId',
           age: 'int?',
           breed: 'string?',
           name: 'string',
           details: 'mixed?',
         },
       primaryKey: '_id',
};

Datos en Atlas

Una aplicación que utiliza Device Sync para el modelo de datos Dog crea documentos MongoDB en Atlas según los esquemas anteriores.

{
  "_id": ObjectId('616f44305a205add93ff1081'),
  "age": 8,
  "breed": "Golden Retriever",
  "name": "Jasper",
  "details": null
}

{
  "_id": ObjectId('616f44305a205add93ff1081'),
  "age": 8,
  "breed": "Golden Retriever",
  "name": "Jasper",
  "details": {
    "vaccinations": ["rabies", "distemper"],
    "weight": 65.5,
    "isNeutered": true,
    "vetVisits": [
      {
        "date": 2002-08-18T04:56:07.000+00:00,
        "reason": "annual checkup"
      },
      {
        "date": 2003-08-18T04:56:07.000+00:00,
        "reason": "annual checkup"
      }
    ]
  }
}