Sincronización basada en particiones

Dividir

Una partición es una colección de objetos que comparten el mismo valor de clave de partición.

Un clúster de MongoDB Atlas consta de varios servidores remotos. Estos servidores proporcionan el almacenamiento para los datos sincronizados. El clúster Atlas almacena documentos en colecciones. Cada colección de MongoDB se asigna a un tipo de objeto Realm diferente. Cada documento de una colección representa un objeto Realm específico.

Un dominio sincronizado es un archivo local en un dispositivo. Un dominio sincronizado puede contener algunos o todos los objetos relevantes para el usuario final. Una aplicación cliente puede usar más de un dominio sincronizado para acceder a todos los objetos que necesita.

Las particiones vinculan objetos de la base de datos Realm con documentos de MongoDB. Al inicializar un archivo de dominio sincronizado, uno de sus parámetros es un valor de partición. La aplicación cliente crea objetos en el dominio sincronizado. Cuando estos objetos se sincronizan, el valor de partición se convierte en un campo en los documentos de MongoDB. El valor de este campo determina a qué documentos de MongoDB puede acceder el cliente.

A un alto nivel:

• Una partición se asigna a un subconjunto de los documentos en un clúster sincronizado.

• Todos los documentos de una partición tienen los mismos permisos de lectura y escritura para un usuario determinado.

• Atlas App Services asigna cada partición a un archivo .realm sincronizado individual.

• Cada objeto en un reino sincronizado tiene un documento correspondiente en la partición.

Particiones de datos de formas en un clúster Atlas. Cada forma representa un tipo de objeto. Las particiones se determinan por el color de cada forma: rojo, verde o azul.

Clave de partición

Una clave de partición es un campo con nombre que se especifica al configurar Atlas Device Sync. Device Sync utiliza esta clave para determinar qué partición contiene un documento determinado.

Dependiendo de su modelo de datos y la complejidad de su aplicación, su clave de partición podría ser:

• Una propiedad que ya existe en cada documento y que particiona los datos de forma lógica. Por ejemplo, considere una aplicación donde cada documento es privado para un usuario específico. Podría almacenar el valor del ID del usuario en un campo owner_id y usarlo como clave de partición.

• Una propiedad sintética que se crea para particionar datos (p. ej., _partition). Puedes usarla cuando tu aplicación no incluye una clave de partición natural.

Puedes configurar la clave de partición como obligatoria u opcional en tus objetos. App Services asigna cualquier objeto que no incluya una clave de partición a una partición predeterminada: una partición nula.

Tenga en cuenta lo siguiente al elegir una clave de partición:

• Las claves de partición deben ser de uno de estos tipos: String, ObjectID, Long o UUID.

• Los clientes de App Services nunca deben modificar el valor de la partición directamente. No se puede usar ningún campo modificable por los clientes como clave de partición.

• Las claves de partición usan el mismo nombre de campo en todos los documentos sincronizados. La clave de partición no debe coincidir con ningún nombre de campo en el modelo de ningún objeto.

{
  "title": "note",
  "bsonType": "object",
  "required": [
    "_id",
    "_partition",
    "owner_id",
    "text"
  ],
  "properties": {
    "_id": { "bsonType": "objectId" },
    "_partition": { "bsonType": "string" },
    "owner_id": { "bsonType": "string" },
    "text": { "bsonType": "string" }
  }
}
{
  "title": "notebook",
  "bsonType": "object",
  "required": [
    "_id",
    "_partition",
    "owner_id",
    "notes"
  ],
  "properties": {
    "_id": { "bsonType": "objectId" },
    "_partition": { "bsonType": "string" },
    "owner_id": { "bsonType": "string" },
    "notes": {
      "bsonType": "array",
      "items": { "bsonType": "objectId" }
    }
  }
}

Valor de partición

Un valor de partición es el valor del campo de clave de partición de un documento determinado. Los documentos con el mismo valor de partición pertenecen a la misma partición. Se sincronizan con el mismo archivo de dominio y comparten permisos de acceso a datos a nivel de usuario.

El valor de una partición es el identificador de su dominio sincronizado correspondiente. Se especifica al abrirla como dominio sincronizado en el cliente. Si se modifica el valor de una partición en Atlas, App Services interpreta el cambio como dos operaciones:

• Una eliminación de la partición antigua.

• Una inserción en la nueva partición.

Antes de comenzar

Necesitará lo siguiente para habilitar la sincronización basada en particiones:

• Una aplicación de App Services. Para aprender cómo crear una aplicación, consulta Crear una aplicación.

• Una fuente de datos Atlas vinculada. Para saber cómo agregar una fuente de datos, consulte Vincular una fuente de datos.

Procedimiento

Interfaz de usuario de servicios de aplicaciones

CLI de servicios de aplicaciones

API de administración

1

Navegue a la pantalla de configuración de sincronización

Para definir las reglas de sincronización de dispositivos y habilitar la sincronización de dispositivos para su aplicación, navegue hasta la Device Sync Pantalla de configuración a través del menú de navegación izquierdo.

Nota

Las reglas de sincronización no se pueden cambiar

Las reglas de sincronización de dispositivos se definen al mismo tiempo que se habilita. Una vez habilitada, no se pueden cambiar las reglas de sincronización de dispositivos de la aplicación a menos que se cancele y se vuelva a habilitar con nuevas reglas.

2

Seleccionar detalles de desarrollo

Puede habilitar la sincronización de dispositivos para un solo clúster vinculado en su aplicación. Determine qué clúster desea usar y selecciónelo en el menú desplegable Select a Cluster To Sync.

3

Elija una clave de partición

La clave de partición de Device Sync es un campo en cada documento sincronizado que asigna cada documento a un dominio del cliente. Las reglas de Device Sync se aplican a nivel de partición, por lo que es fundamental considerar el modelo de datos y los patrones de acceso. Para obtener más información sobre las claves de partición y cómo elegir una, consulte Particiones.

Nota

La clave de partición puede ser obligatoria u opcional. Si el campo de clave de partición es opcional, todos los documentos de MongoDB que excluyan la clave de partición o tengan un valor nulo para esta se enviarán a la partición nula. Si el campo de clave de partición es obligatorio, Device Sync ignora cualquier documento de MongoDB que no tenga un valor válido para la clave de partición. Recomendamos una clave de partición obligatoria a menos que desee sincronizar con Device Sync datos preexistentes con valores de partición no válidos o faltantes de una colección de MongoDB.

4

Definir permisos de lectura y escritura

La Define Permissions sección le permite definir expresiones JSON que App Services evalúa dinámicamente para determinar los permisos de lectura y escritura de un usuario para los datos en una partición determinada.

Las expresiones de regla de sincronización de dispositivos tienen acceso a%%user, que se resuelve al usuario que abrió el dominio, y a%%partition, que se resuelve al valor de la clave de partición del dominio. También puede usar operadores, como%function, para gestionar casos más complejos. Para ver ejemplos, consulte Permisos basados ​​en roles.

Una vez que haya determinado cómo decidir los permisos de lectura y escritura de un usuario para una partición determinada, defina las expresiones JSON correspondientes en las entradas Read y Write.

5

Comprobar comportamientos de configuración avanzada predeterminados

Expandir la sección Advanced Configuration.

Servicios de aplicaciones Las aplicaciones proporcionan funciones de optimización avanzadas que están habilitadas de forma predeterminada:

• Tiempo máximo sin conexión del cliente

• Recuperación de clientes

Si desea cambiar el tiempo que un cliente puede estar sin conexión, puede hacerlo en la sección Advanced Configuration.

6

Activar la sincronización

Ahora que has configurado las reglas para tu clúster sincronizado, solo queda activar la sincronización de dispositivos para las aplicaciones cliente. Haz clic en Enable Sync, toma nota de las recomendaciones que aparecen y confirma tu elección.

1

Autenticar un usuario de MongoDB Atlas

Utilice su clave API de administrador de MongoDB Atlas para iniciar sesión en la CLI:

appservices login --api-key="<my api key>" --private-api-key="<my private api key>"

2

Obtenga la última versión de su aplicación

Obtén una copia local de los archivos de configuración de tu aplicación. Para obtener la última versión, ejecuta el siguiente comando:

appservices pull --remote="<Your App ID>"

También puedes exportar una copia de los archivos de configuración de tu aplicación desde la interfaz de usuario o con la API de administración. Para saber cómo, consulta Exportar una aplicación.

3

Agregar una configuración de sincronización

Puedes habilitar la sincronización para un solo clúster vinculado en tu aplicación.

La aplicación Servicios de aplicaciones tiene un sync directorio donde se encuentra el archivo de configuración de sincronización. Si aún no ha habilitado la sincronización, este directorio está vacío.

Añade un config.json similar a:

{
  "type": "partition",
  "state": <"enabled" | "disabled">,
  "development_mode_enabled": <Boolean>,
  "service_name": "<Data Source Name>",
  "database_name": "<Database Name>",
  "partition": {
    "key": "<Partition Key Field Name>",
    "type": "<Partition Key Type>",
    "permissions": {
      "read": { <Expression> },
      "write": { <Expression> }
    }
  },
  "client_max_offline_days": <Number>,
  "is_recovery_mode_disabled": <Boolean>
}

4

Elija una clave de partición

La clave de partición de sincronización es un campo en cada documento sincronizado que asigna cada documento a un dominio del lado del cliente. Las reglas de sincronización se aplican a nivel de partición, por lo que es especialmente importante considerar el modelo de datos y los patrones de acceso. Para obtener más información sobre las claves de partición y cómo elegir una, consulte Particiones.

Nota

La clave de partición puede ser obligatoria u opcional. Si el campo de clave de partición es opcional, todos los documentos de MongoDB que excluyan la clave de partición o tengan un valor nulo para esta se enviarán a la partición nula. Si el campo de clave de partición es obligatorio, Device Sync ignora cualquier documento de MongoDB que no tenga un valor válido para la clave de partición. Recomendamos una clave de partición obligatoria a menos que desee sincronizar datos preexistentes con valores de partición no válidos o faltantes de una colección de MongoDB.

Una vez que haya decidido qué campo utilizar, actualice sync.partition con el nombre del campo de clave de partición en el campo key y el tipo de clave de partición en el campo type, de manera similar a:

{
  ...
  "partition": {
    "key": "owner_id",
    "type": "string",
    "permissions": {
      "read": {},
      "write": {}
    }
  }
  ...
}

5

Definir permisos de lectura y escritura

App Services le permite definir expresiones JSON que evalúa dinámicamente cada vez que un usuario abre un reino para determinar si el usuario tiene permisos de lectura o escritura para los datos en la partición.

Las expresiones de regla de sincronización tienen acceso a%%user, que se resuelve al usuario que abrió el dominio, y a%%partition, que se resuelve al valor de la clave de partición del dominio. También puede usar operadores, como%function, para gestionar casos más complejos. Para ver ejemplos, consulte Permisos de sincronización.

Una vez que haya determinado cómo decidir los permisos de lectura y escritura de un usuario para una partición determinada, defina las expresiones JSON correspondientes en los campos read y write de partition.permissions, de manera similar a:

{
  ...
  "partition": {
    "key": "owner_id",
    "type": "string",
    "permissions": {
      "read": {
        "$or": [
          { "%%user.id": "%%partition" },
          { "%%user.custom_data.shared": "%%partition" }
        ]
      },
      "write": {
        "%%user.id": "%%partition"
      }
    }
  }
  ...
}

6

Especificar valores para la optimización de la sincronización

Sync ofrece funciones que permiten optimizar el rendimiento de la sincronización y mejorar el proceso de recuperación de datos en el cliente. Estas funciones se representan mediante configuraciones adicionales:

• client_max_offline_days

• is_recovery_mode_disabled

Puedes establecer un valor numérico para client_max_offline_days. Al habilitar la sincronización mediante la interfaz de usuario de App Services, el valor predeterminado es 30, que representa 30 días.

Para obtener más información, consulte: Tiempo máximo sin conexión del cliente.

El modo de recuperación permite que Sincronización intente recuperar datos que aún no se han sincronizado al restablecer un cliente. Al habilitar Sincronización mediante la interfaz de usuario de App Services, el modo de recuperación se activa de forma predeterminada. Recomendamos activarlo para que el cliente se restablezca automáticamente. Si ha desactivado el modo de recuperación y desea volver a activarlo, configure is_recovery_mode_disabled en false.

Para obtener más información, consulta: Recuperar cambios no sincronizados.

{
  "type": "partition",
  "state": "enabled",
  "development_mode_enabled": true,
  "service_name": "mongodb-atlas",
  "database_name": "my-test-database",
  "partition": {
    ...
  },
  "client_max_offline_days": 30,
  "is_recovery_mode_disabled": false
}

7

Implementar la configuración de sincronización

Ahora que ha definido la configuración de sincronización, incluidos los permisos de lectura y escritura, puede implementar los cambios para comenzar a sincronizar datos y aplicar reglas de sincronización.

Para implementar los cambios, importa la configuración de la aplicación en tu App Services Aplicación:

appservices push --remote="<Your App ID>"

1

Seleccione un clúster para sincronizar

Puede habilitar la sincronización para un solo clúster vinculado en su aplicación.

Necesitará el archivo de configuración del servicio del clúster para configurar la sincronización. Puede encontrarlo enumerando todos los servicios a través de la API de administración:

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{GROUP_ID}/apps/{APP_ID}/services \
  -X GET \
  -h 'Authorization: Bearer <Valid Access Token>'

Identifica el servicio cuya configuración necesitas actualizar para habilitar sincronizar. Si aceptaste los nombres por defecto al configurar tu aplicación, este debería ser un servicio cuyo name es mongodb-atlas y type es mongodb-atlas. Necesitas el/la _id de este servicio.

Ahora puedes obtener el archivo de configuración para este servicio:

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{GROUP_ID}/apps/{APP_ID}/services/{MongoDB_Service_ID}/config \
  -X GET \
  -h 'Authorization: Bearer <Valid Access Token>'

Una vez que tenga la configuración, agregue el objeto sync con la siguiente configuración de plantilla:

{
  ...
  "sync": {
    "type": "partition",
    "state": "enabled",
    "development_mode_enabled": <Boolean>,
    "database_name": "<Database Name>",
    "partition": {
      "key": "<Partition Key Field Name>",
      "type": "<Partition Key Type>",
      "permissions": {
        "read": { <Expression> },
        "write": { <Expression> }
      }
    },
    "client_max_offline_days": <Number>,
    "is_recovery_mode_disabled": <Boolean>
  }
  ...
}

2

Elija una clave de partición

La clave de partición de sincronización es un campo en cada documento sincronizado que asigna cada documento a un dominio del lado del cliente. Las reglas de sincronización se aplican a nivel de partición, por lo que es especialmente importante considerar el modelo de datos y los patrones de acceso. Para obtener más información sobre las claves de partición y cómo elegir una, consulte Particiones.

Puede obtener una lista de todas las claves de partición válidas y sus tipos correspondientes a través de la API de administración:

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{GROUP_ID}/apps/{APP_ID}/sync/data?service_id=<MongoDB Service ID> \
  -X GET \
  -h 'Authorization: Bearer <Valid Access Token>'

Nota

La clave de partición puede ser obligatoria u opcional. Si el campo de clave de partición es opcional, todos los documentos de MongoDB que excluyan la clave de partición o tengan un valor nulo para esta se enviarán a la partición nula. Si el campo de clave de partición es obligatorio, Device Sync ignora cualquier documento de MongoDB que no tenga un valor válido para la clave de partición. Recomendamos una clave de partición obligatoria a menos que desee sincronizar datos preexistentes con valores de partición no válidos o faltantes de una colección de MongoDB.

Una vez que haya decidido qué campo utilizar, actualice sync.partition con el nombre del campo de clave de partición en el campo key y el tipo de clave de partición en el campo type.

{
  ...
  "sync": {
    "type": "partition",
    "state": "enabled",
    "development_mode_enabled": <Boolean>,
    "database_name": "<Database Name>",
    "partition": {
      "key": "owner_id",
      "type": "string",
      "permissions": {
        "read": { <Expression> },
        "write": { <Expression> }
      }
    },
    "client_max_offline_days": <Number>,
    "is_recovery_mode_disabled": <Boolean>
  }
  ...
}

3

Definir permisos de lectura y escritura

App Services le permite definir expresiones JSON que evalúa dinámicamente cada vez que un usuario abre un reino para determinar si el usuario tiene permisos de lectura o escritura para los datos en la partición.

Las expresiones de regla de sincronización tienen acceso a%%user, que se resuelve al usuario que abrió el dominio, y a%%partition, que se resuelve al valor de la clave de partición del dominio. También puede usar operadores, como%function, para gestionar casos más complejos. Para ver ejemplos, consulte Permisos de sincronización.

Una vez que haya determinado cómo decidir los permisos de lectura y escritura de un usuario para una partición determinada, defina las expresiones JSON correspondientes en los campos read y write de sync.partition.permissions.

{
  ...
  "sync": {
    "type": "partition",
    "state": "enabled",
    "development_mode_enabled": <Boolean>,
    "database_name": "<Database Name>",
    "partition": {
      "key": "owner_id",
      "type": "string",
      "permissions": {
        "read": {
          "$or": [
            { "%%user.id": "%%partition" },
            { "%%user.custom_data.shared": "%%partition" }
          ]
        },
        "write": {
          "%%user.id": "%%partition"
        }
      }
    },
    "client_max_offline_days": <Number>,
    "is_recovery_mode_disabled": <Boolean>
  }
  ...
}

4

Especificar valores para la optimización de la sincronización

Sync ofrece funciones que permiten optimizar el rendimiento de la sincronización y mejorar el proceso de recuperación de datos del cliente. Estas funciones se representan mediante configuraciones adicionales:

• client_max_offline_days

• is_recovery_mode_disabled

Puedes establecer un valor numérico para client_max_offline_days. Al habilitar la sincronización mediante la interfaz de usuario de App Services, el valor predeterminado es 30, que representa 30 días.

Para obtener más información, consulte: Tiempo máximo sin conexión del cliente.

El modo de recuperación permite que Sincronización intente recuperar datos no sincronizados al restablecer un cliente. Al habilitar Sincronización mediante la interfaz de usuario de App Services, el modo de recuperación se activa de forma predeterminada. Recomendamos activarlo para gestionar automáticamente el restablecimiento del cliente. Para activarlo, configure is_recovery_mode_disabled en false.

Para obtener más información, consulta: Recuperar cambios no sincronizados.

{
  ...
  "sync": {
    "type": "partition",
    "state": "enabled",
    "development_mode_enabled": true,
    "database_name": "my-test-database",
    "partition": {
      ...
    },
    "client_max_offline_days": 30,
    "is_recovery_mode_disabled": false
  }
  ...
}

5

Implementar la configuración de sincronización

Ahora que ha definido la configuración de sincronización, incluidos los permisos de lectura y escritura, puede implementar los cambios para comenzar a sincronizar datos y aplicar reglas de sincronización.

Para implementar sus cambios, envíe una solicitud de API de administración que actualice la configuración del clúster con su configuración de sincronización:

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{GROUP_ID}/apps/{APP_ID}/services/{MongoDB_Service_ID}/config \
  -X PATCH \
  -h 'Authorization: Bearer <Valid Access Token>' \
  -d @/sync/config.json

Comportamiento de las reglas de sincronización basadas en particiones

Las reglas de sincronización se aplican a particiones específicas y se vinculan al modelo de datos de la aplicación mediante la clave de partición. Tenga en cuenta el siguiente comportamiento al diseñar sus esquemas para garantizar la granularidad adecuada en el acceso a los datos y evitar la filtración accidental de información confidencial.

• Las reglas de sincronización se aplican dinámicamente según el usuario. Un usuario puede tener acceso completo de lectura y escritura a una partición, mientras que otro solo tiene permisos de lectura o no puede acceder a ella por completo. Estos permisos se controlan mediante la definición de expresiones JSON.

• Las reglas de sincronización se aplican por igual a todos los objetos de una partición. Si un usuario tiene permiso de lectura o escritura para una partición determinada, puede leer o modificar todos los campos sincronizados de cualquier objeto de la partición.

• Los permisos de escritura requieren permisos de lectura, por lo que un usuario con acceso de escritura a una partición también tiene acceso de lectura independientemente de las reglas de permiso de lectura definidas.

Permisos de sincronización basados ​​en particiones

Los Servicios de aplicación aplican permisos dinámicos de lectura y guardar específicos del usuario para proteger los datos en cada partición. Defines los permisos con expresiones de Expresión de regla JSON que controlan si un usuario determinado tiene acceso de lectura o escritura a los datos en una partición determinada. aplicación Services evalúa los permisos de un usuario cada vez que abre un realm sincronizado.

Conceptos clave

Estrategias de permisos

Puedes estructurar tus expresiones de permisos de lectura y escritura como un conjunto de estrategias de permisos que se aplican a tu estrategia de partición. Las siguientes estrategias describen enfoques comunes que puedes utilizar para definir permisos de lectura y escritura sincronizados para tu aplicación.

true

false

{ "%%true": true }

{ "%%partition": "PUBLIC" }

{
  "%%partition": {
    "$in": [
      "PUBLIC (NA)",
      "PUBLIC (EMEA)",
      "PUBLIC (APAC)"
    ]
  }
}

{ "%%user.id": "5f4863e4d49bd2191ff1e623" }

{
  "%%user.id": {
    "$in": [
      "5f4863e4d49bd2191ff1e623",
      "5f48640dd49bd2191ff1e624",
      "5f486417d49bd2191ff1e625"
    ]
  }
}

{ "%%user.custom_data.readPartitions" : "%%partition" }

{ "%%user.data.writePartitions" : "%%partition" }

{
  "%%true": {
    "%function": {
      "name": "canReadPartition",
      "arguments": ["%%partition"]
    }
  }
}

// canReadPartition
exports = async (partition) => {
  const cluster = context.services.get("mongodb-atlas");
  const permissions = cluster
    .db("myApp")
    .collection("permissions");
  const { canRead } = await permissions.findOne({ partition });
  return canRead.includes(context.user.id);
}

Migrar reglas de sincronización basadas en particiones a reglas de App Services

Si migra su aplicación de sincronización basada en particiones a sincronización flexible, sus reglas de acceso a datos también deben migrarse.

Algunas estrategias de reglas de sincronización basadas en particiones no se pueden traducir directamente a reglas de App Services. Es posible que deba migrar manualmente los permisos que incluyen:

• %function operador.

  Las reglas de función no son compatibles con Flexible Sync y no se pueden migrar.

• %%partition expansión.

  Las reglas de servicios de aplicaciones no tienen una expansión equivalente %%partition para, por lo que no se pueden migrar.

• %or, %not, %nor, %and expansiones.

  Estos permisos pueden funcionar, pero presentan suficientes matices como para que deba probarlos para garantizar el comportamiento esperado. Probar nuevos permisos no funcionará en la aplicación que está migrando. Necesitará una aplicación nueva para probar los permisos migrados manualmente.

Consulte la lista de expansiones compatibles con Flexible Sync para ver todas las expansiones admitidas.

También debe consultar la Guía de permisos de sincronización de dispositivos para obtener más información sobre cómo trabajar con permisos.

Estrategia de manguera contra incendios

Una estrategia de partición Firehose agrupa todos los documentos en una sola partición. Con esta estructura, cada usuario sincroniza todos los datos de la aplicación con su dispositivo. Este enfoque, en la práctica, implica no particionar los datos. Funciona para aplicaciones básicas o pequeños conjuntos de datos públicos.

• Seguridad de datos. Todos los datos son públicos para los clientes con un dominio que usa la partición. Si un usuario tiene acceso de lectura o escritura a la partición, puede leer o escribir cualquier documento.

• Capacidad de almacenamiento. Cada usuario sincroniza todos los documentos de la partición. Todos los datos deben caber dentro de su límite de almacenamiento máximo. Utilice esta estrategia solo cuando los conjuntos de datos sean pequeños y no crezcan rápidamente.

Una forma de crear una manguera contra incendios es establecer la clave de partición como campo opcional. No incluya un valor para este campo en ningún documento. App Services asigna cualquier documento que no incluya un valor de partición a la partición nula.

También puede establecer un valor de partición estático. En este caso, el valor de partición no cambia según el usuario ni los datos. Por ejemplo, los dominios de todos los clientes podrían usar el valor de "MyPartitionValue" partición.

collection games: [
  { teams: ["Brook Ridge Miners", "Southside Rockets"], score: { ... }, date: ... }
  { teams: ["Brook Ridge Miners", "Uptown Bombers"], score: { ... }, date: ... }
  { teams: ["Brook Ridge Miners", "Southside Rockets"], score: { ... }, date: ... }
  { teams: ["Southside Rockets", "Uptown Bombers"], score: { ... }, date: ... }
  { teams: ["Brook Ridge Miners", "Uptown Bombers"], score: { ... }, date: ... }
  { teams: ["Southside Rockets", "Uptown Bombers"], score: { ... }, date: ... }
]
collection teams: [
  { name: "Brook Ridge Miners" }
  { name: "Southside Rockets" }
  { name: "Uptown Bombers" }
]

realm null: [
  Game { teams: ["Brook Ridge Miners", "Southside Rockets"], score: { ... }, date: ... }
  Game { teams: ["Brook Ridge Miners", "Uptown Bombers"], score: { ... }, date: ... }
  Game { teams: ["Brook Ridge Miners", "Southside Rockets"], score: { ... }, date: ... }
  Game { teams: ["Southside Rockets", "Uptown Bombers"], score: { ... }, date: ... }
  Game { teams: ["Brook Ridge Miners", "Uptown Bombers"], score: { ... }, date: ... }
  Game { teams: ["Southside Rockets", "Uptown Bombers"], score: { ... }, date: ... }
  Team { name: "Brook Ridge Miners" }
  Team { name: "Southside Rockets" }
  Team { name: "Uptown Bombers" }
]

Estrategia de usuario

Una estrategia de partición de usuarios agrupa los documentos privados de cada usuario. Estos documentos se guardan en una partición específica para ese usuario. Esto funciona cuando cada documento tiene un propietario y nadie más necesita los datos. Un nombre de usuario o ID que identifica al propietario constituye una clave de partición natural.

• Seguridad de datos. Los datos de una partición de usuario son específicos de cada usuario. Pueden contener información privada. Cada usuario sincroniza únicamente su propia partición. Los demás usuarios no pueden acceder a los documentos de la partición.

• Capacidad de almacenamiento. Cada usuario solo sincroniza datos de su propia partición. Sus datos deben ajustarse a las limitaciones de almacenamiento de su dispositivo. Utilice esta estrategia solo cuando cada usuario tenga una cantidad de datos manejable.

collection playlists: [
  { name: "Work", owner_id: "dog_enthusiast_95", song_ids: [ ... ] }
  { name: "Party", owner_id: "cat_enthusiast_92", song_ids: [ ... ] }
  { name: "Soup Tunes", owner_id: "dog_enthusiast_95", song_ids: [ ... ] }
  { name: "Disco Anthems", owner_id: "PUBLIC", song_ids: [ ... ] }
  { name: "Deep Focus", owner_id: "PUBLIC", song_ids: [ ... ] }
]
collection ratings: [
  { owner_id: "dog_enthusiast_95", song_id: 3, rating: -1 }
  { owner_id: "cat_enthusiast_92", song_id: 1, rating: 1 }
  { owner_id: "dog_enthusiast_95", song_id: 1, rating: 1 }
]

realm dog_enthusiast_95: [
  Playlist { name: "Work", owner_id: "dog_enthusiast_95", song_ids: [ ... ] }
  Playlist { name: "Soup Tunes", owner_id: "dog_enthusiast_95", song_ids: [ ... ] }
  Rating { owner_id: "dog_enthusiast_95", song_id: 3, rating: -1 }
  Rating { owner_id: "dog_enthusiast_95", song_id: 1, rating: 1 }
]
realm cat_enthusiast_92: [
  Playlist { name: "Party", owner_id: "cat_enthusiast_92", song_ids: [ ... ] }
  Rating { owner_id: "cat_enthusiast_92", song_id: 1, rating: 1 }
]
realm PUBLIC: [
  Playlist { name: "Disco Anthems", owner_id: "PUBLIC", song_ids: [ ... ] }
  Playlist { name: "Deep Focus", owner_id: "PUBLIC", song_ids: [ ... ] }
]

Estrategia de equipo

Una estrategia de partición de equipo agrupa documentos privados compartidos por un equipo de usuarios. Un equipo puede incluir a los empleados de una tienda o a los miembros de una banda. Cada equipo tiene una partición específica. Todos los usuarios del equipo comparten el acceso y la propiedad de los documentos.

• Seguridad de datos. Los datos de una partición de equipo son específicos de cada equipo. Pueden contener datos privados del equipo, pero no de sus miembros. Cada usuario sincroniza las particiones de los equipos a los que pertenece. Los usuarios que no pertenecen a un equipo no pueden acceder a los documentos de la partición.

• Capacidad de almacenamiento: Cada usuario solo sincroniza los datos de sus propios equipos. Los datos de los equipos de un usuario deben ajustarse a las limitaciones de almacenamiento de su dispositivo. Utilice esta estrategia cuando los usuarios pertenezcan a un número razonable de equipos. Si los usuarios pertenecen a varios equipos, los dominios combinados podrían contener una gran cantidad de datos. Es posible que deba limitar el número de particiones de equipo que se sincronizan simultáneamente.

collection projects: [
  { name: "CLI", owner_id: "cli-team", task_ids: [ ... ] }
  { name: "API", owner_id: "api-team", task_ids: [ ... ] }
]
collection tasks: [
  { status: "complete", owner_id: "api-team", text: "Import dependencies" }
  { status: "inProgress", owner_id: "api-team", text: "Create app MVP" }
  { status: "inProgress", owner_id: "api-team", text: "Investigate off-by-one issue" }
  { status: "todo", owner_id: "api-team", text: "Write tests" }
  { status: "inProgress", owner_id: "cli-team", text: "Create command specifications" }
  { status: "todo", owner_id: "cli-team", text: "Choose a CLI framework" }
]

realm cli-team: [
  Project { name: "CLI", owner_id: "cli-team", task_ids: [ ... ] }
  Task { status: "inProgress", owner_id: "cli-team", text: "Create command specifications" }
  Task { status: "todo", owner_id: "cli-team", text: "Choose a CLI framework" }
]
realm api-team: [
  Project { name: "API", owner_id: "api-team", task_ids: [ ... ] }
  Task { status: "complete", owner_id: "api-team", text: "Import dependencies" }
  Task { status: "inProgress", owner_id: "api-team", text: "Create app MVP" }
  Task { status: "inProgress", owner_id: "api-team", text: "Investigate off-by-one issue" }
  Task { status: "todo", owner_id: "api-team", text: "Write tests" }
]

Estrategia de canal

Una estrategia de partición de canales agrupa documentos para un tema o dominio común. Cada tema o dominio tiene su propia partición. Los usuarios pueden acceder o suscribirse a canales específicos. Un nombre o ID puede identificar estos canales en una lista pública.

• Seguridad de datos. Los datos de una partición de canal son específicos de un tema o área. Los usuarios pueden elegir acceder a estos canales. Puede limitar el acceso de un usuario a un subconjunto de canales. También puede impedir que los usuarios accedan a los canales por completo. Si un usuario tiene permiso de lectura o escritura en un canal, puede acceder a cualquier documento de la partición.

• Capacidad de almacenamiento. Los usuarios pueden sincronizar datos desde cualquier canal permitido. Todos los datos de los canales de un usuario deben ajustarse a las limitaciones de almacenamiento de su dispositivo. Utilice esta estrategia para particionar conjuntos de datos públicos o semiprivados. Esta estrategia divide los conjuntos de datos que no se ajustan a las limitaciones de almacenamiento.

collection chatrooms: [
  { topic: "cats", description: "A place to talk about cats" }
  { topic: "sports", description: "We like sports and we don't care who knows" }
]
collection messages: [
  { topic: "cats", text: "Check out this cute pic of my cat!", timestamp: 1625772933383 }
  { topic: "cats", text: "Can anybody recommend a good cat food brand?", timestamp: 1625772953383 }
  { topic: "sports", text: "Did you catch the game last night?", timestamp: 1625772965383 }
  { topic: "sports", text: "Yeah what a comeback! Incredible!", timestamp: 1625772970383 }
  { topic: "sports", text: "I can't believe how they scored that goal.", timestamp: 1625773000383 }
]

realm cats: [
  Chatroom { topic: "cats", description: "A place to talk about cats" }
  Message { topic: "cats", text: "Check out this cute pic of my cat!", timestamp: 1625772933383 }
  Message { topic: "cats", text: "Can anybody recommend a good cat food brand?", timestamp: 1625772953383 }
]
realm sports: [
  Chatroom { topic: "sports", description: "We like sports and we don't care who knows" }
  Message { topic: "sports", text: "Did you catch the game last night?", timestamp: 1625772965383 }
  Message { topic: "sports", text: "Yeah what a comeback! Incredible!", timestamp: 1625772970383 }
  Message { topic: "sports", text: "I can't believe how they scored that goal.", timestamp: 1625773000383 }
]

Estrategia de región

Una estrategia de partición regional agrupa documentos relacionados con una ubicación o región. Cada partición contiene documentos específicos de esas áreas.

• Seguridad de los datos. Los datos son específicos de una determinada área geográfica. Puede limitar el acceso de un usuario a su región actual. Alternativamente, conceda acceso a los datos por región.

• Capacidad de almacenamiento. Las necesidades de almacenamiento varían según el tamaño y los patrones de uso de la región. Es posible que los usuarios solo sincronicen datos en su propia región. Los datos de cualquier región deben ajustarse a las limitaciones de almacenamiento del dispositivo. Si los usuarios sincronizan varias regiones, divídanlas en subregiones más pequeñas. Esto ayuda a evitar sincronizar datos innecesarios.

collection restaurants: [
  { city: "New York, NY", name: "Joe's Pizza", menu: [ ... ] }
  { city: "New York, NY", name: "Han Dynasty", menu: [ ... ] }
  { city: "New York, NY", name: "Harlem Taste", menu: [ ... ] }
  { city: "Chicago, IL", name: "Lou Malnati's", menu: [ ... ] }
  { city: "Chicago, IL", name: "Al's Beef", menu: [ ... ] }
  { city: "Chicago, IL", name: "Nando's", menu: [ ... ] }
]

realm New York, NY: [
 { city: "New York, NY", name: "Joe's Pizza", menu: [ ... ] }
 { city: "New York, NY", name: "Han Dynasty", menu: [ ... ] }
 { city: "New York, NY", name: "Harlem Taste", menu: [ ... ] }
]
realm Chicago, IL: [
 { city: "Chicago, IL", name: "Lou Malnati's", menu: [ ... ] }
 { city: "Chicago, IL", name: "Al's Beef", menu: [ ... ]  }
 { city: "Chicago, IL", name: "Nando's", menu: [ ... ]  }
]

Estrategia de cubo

Una estrategia de partición de buckets agrupa los documentos por rango. Cuando los documentos se extienden a lo largo de una dimensión, una partición contiene un subrango. Considere rangos de buckets basados ​​en el tiempo. Los desencadenadores mueven los documentos a nuevas particiones cuando caen fuera de su rango de bucket.

• Seguridad de datos. Limite la lectura o escritura de los usuarios a solo buckets específicos. Los datos pueden fluir entre buckets. Considere los permisos de acceso para un documento en todos los buckets posibles.

• Capacidad de almacenamiento. Las necesidades de almacenamiento varían según el tamaño y los patrones de uso de cada bucket. Considere a qué buckets necesitan acceder los usuarios. Limite el tamaño de los buckets para que se ajuste a las limitaciones de almacenamiento del dispositivo. Si los usuarios sincronizan muchos buckets, divídalos en buckets más pequeños. Esto ayuda a evitar la sincronización de datos innecesarios.

collection readings: [
  { bucket: "0s<t<=60s", timestamp: 1625773000383 , data: { ... } }
  { bucket: "0s<t<=60s", timestamp: 1625772970383 , data: { ... } }
  { bucket: "0s<t<=60s", timestamp: 1625772965383 , data: { ... } }
  { bucket: "60s<t<=300s", timestamp: 1625772953383 , data: { ... } }
  { bucket: "60s<t<=300s", timestamp: 1625772933383 , data: { ... } }
]

realm 0s<t<=60s: [
  Reading { bucket: "0s<t<=60s", timestamp: 1625773000383 , data: { ... } }
  Reading { bucket: "0s<t<=60s", timestamp: 1625772970383 , data: { ... } }
  Reading { bucket: "0s<t<=60s", timestamp: 1625772965383 , data: { ... } }
]
realm 60s<t<=300s: [
  Reading { bucket: "60s<t<=300s", timestamp: 1625772953383 , data: { ... } }
  Reading { bucket: "60s<t<=300s", timestamp: 1625772933383 , data: { ... } }
]