Agrupar un archivo de reino - Node SDK

Overview

Para crear y agrupar un archivo de reino con su aplicación:

1. Crea un archivo de reino que contenga los datos que deseas agrupar.

2. Agregue el archivo de reino incluido a su aplicación de producción.

3. En su aplicación de producción, abra el dominio desde el archivo de recursos incluido. Para dominios sincronizados, debe incluir la clave de partición.

Crear un archivo de reino para agrupar

1. Cree una aplicación de reino temporal que comparta el modelo de datos de su aplicación.

2. Abra un dominio y agregue los datos que desea agrupar. Si usa un dominio sincronizado, espere a que se sincronice por completo.

3. Utiliza el método writeCopyTo() para copiar el realm a un nuevo archivo:

   const originalPath = path.join(__dirname, "original.realm");
   const originalConfig = {
     schema: [Car],
     path: originalPath,
   };
   const originalRealm = await Realm.open(originalConfig);
   const copyPath = path.join(__dirname, "copy.realm");
   originalRealm.writeCopyTo(copyPath);

   writeCopyTo() Compacta automáticamente tu reino al tamaño más pequeño posible antes de copiarlo.

   Nota

   Diferencias entre reinos sincronizados y reinos solo locales

   El ejemplo anterior utiliza una SyncConfiguration para configurar un dominio sincronizado para el sync campo de la configuración. Para crear una copia de un dominio local, no incluya el sync campo en su objeto de configuración.

4. Anote la ruta del archivo del dominio incluido, que se encuentra en la ubicación especificada en el argumento pasado a writeCopyTo() en el paso anterior. Necesitará este archivo para usar el dominio incluido en su aplicación de producción, como se describe en la siguiente sección.

   temp_realm_app

   .
   ├── copyOfDefault.realm
   ... rest of files in _temp_ application

Agrupar un archivo de reino en su aplicación de producción

Ahora que tiene una copia del reino que contiene los datos iniciales, inclúyalo en su aplicación de producción.

Agregue el archivo de reino incluido creado en la sección anterior a su aplicación de producción.

.
├── copyOfDefault.realm
... rest of files in _prod_ application

Abrir un reino desde un archivo de reino incluido

Ahora que tiene una copia del reino incluida con su aplicación de producción, necesita agregar código para usarlo.

Cree una configuración con la ruta al dominio incluido como valor para el path campo. Pase esa configuración al método Realm.open(). Ahora puede trabajar con los datos de su dominio incluido en el dominio que acaba de abrir.

const copyConfig = {
  schema: [Car],
  path: "path/to/bundled/file.realm"
};
const copyRealm = await Realm.open(copyConfig);

Agrupa un reino sincronizado

Generalmente, agrupar un dominio sincronizado funciona igual que agrupar un dominio local. Sin embargo, solo se pueden agrupar dominios completamente sincronizados. Asegúrese de que el dominio esté completamente sincronizado con el servidor antes de agruparlo:

const config = {
  sync: {
    user: app.currentUser,
    partitionValue: app.currentUser.id,
  },
  schema: [Car],
};
const realm = await Realm.open(config);
// create many changes
realm.write(() => {
  for (let i = 0; i < 25; i++) {
    realm.create("Car", {
      make: "Toyota",
      model: "Prius",
      miles: i,
      owner: app.currentUser.id,
    });
  }
});
// ensure synchronize all changes before copy
await realm.syncSession.uploadAllLocalChanges();
await realm.syncSession.downloadAllServerChanges();
// changes are synchronized -- we can copy the realm
realm.writeCopyTo(__dirname + "syncedCopy.realm");

Existen limitaciones adicionales al abrir un dominio sincronizado incluido que utiliza la sincronización basada en particiones, una versión anterior. Para obtener más información sobre el uso de dominios configurados con la sincronización basada en particiones, consulte Sincronización basada en particiones - SDK de Node.js.