Convertir el clúster autogestionado a un set de réplicas

Este tutorial describe cómo convertir un clúster a un set de réplicas no particionado. Para convertir un set de réplicas en un clúster, consulta Convertir un set de réplicas autogestionado en un clúster. Consulta la documentación de particionado para obtener más información sobre los clústeres.

Este tutorial te guía a través de las siguientes tareas:

Desactivar el balanceador y bloquear el clúster.
Convertir un clúster único o fragmentado en un set de réplicas
Desbloquee el clúster después de convertirlo en un set de réplicas.

Antes de comenzar

Compatibilidad de versiones

Los pasos de este tutorial requieren MongoDB 6.0 o posterior.

Autorización

La Los comandos fsync y fsyncUnlock requieren la acción de autorización fsync, la cual puede ser asignada a través del rol hostManager o un rol personalizado.

Programar la conversión del clúster

Convierta el clúster cuando las migraciones de fragmentos, el resharding y las transformaciones de esquemas no se realicen normalmente.

Pasos

Desactive el balanceador y bloquee el clúster

Para deshabilitar el equilibrador y bloquear el clúster:

Conectar mongosh a una mongos instancia en el clúster particionado.
Para detener el balanceador, ejecute:
```
sh.stopBalancer()
```
Para verificar que el balanceador está desactivado, ejecute el siguiente comando y asegúrese de que la salida sea false:
```
sh.getBalancerState()
```
Para bloquear el clúster fragmentado, lo que impide la escritura en la base de datos, ejecuta:
```
db.getSiblingDB( "admin" ).fsyncLock()
```

Para confirmar el bloqueo, ejecute:

db.getSiblingDB( "admin" ).aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } }
      ],
      "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

Asegúrate de que la salida muestre que fsyncLocked es true, lo que significa que el clúster está bloqueado:
```
[ { fsyncLocked: true }, { fsyncUnlocked: false } ]
```

Convertir un clúster único o fragmentado en un set de réplicas

En el caso de un cluster fragmentado con solo una partición, esa partición contiene el conjunto completo de datos. Para convertir ese clúster en un set de réplicas no fragmentado:

Reconfigurar la aplicación para conectarse con el miembro primario del set de réplicas que aloja la única partición; ese sistema será el nuevo set de réplicas.
Remueve la opción --shardsvr de tu mongod.
Tip
Cambiar la opción --shardsvr cambiará el puerto en el que mongod escucha las conexiones entrantes.

El clúster de réplica única ahora es un conjunto de réplicas no particionado que aceptará operaciones de lectura y escritura en el conjunto de datos.

Siga el siguiente procedimiento para pasar de un clúster con más de una partición a un set de réplicascompletamente nuevo.

Con el clúster bloqueado y el balanceador deshabilitado, implementa un nuevo set de réplicas además de tu clúster. El set de réplicas debe tener la capacidad suficiente para alojar todos los archivos de datos de todas las particiones actuales combinadas. No configures la aplicación para conectarse al nuevo set de réplicas hasta que se complete la transferencia de datos.
Reconfigure su aplicación o detenga todas las instancias de mongos. Si detiene todas las instancias de mongos, las aplicaciones no podrán leer desde la base de datos. Si detiene todas las instancias mongos, inicie una instancia temporal mongos a la que las aplicaciones no pueden acceder para el procedimiento de migración de datos.
Utiliza mongodump y mongorestore para migrar los datos de la mongos instancia al nuevo conjunto de réplicas.
Excluya la base de datos config cuando ejecute mongorestore. Usa la opción --nsExclude como se muestra en este ejemplo:
```
mongorestore --nsExclude="config.*" <connection-string> /data/backup
```
Nota
No todas las colecciones en todas las bases de datos están necesariamente particionadas. No migres únicamente las colecciones particionadas. Asegúrese de que todas las bases de datos y todas las colecciones se migren correctamente.
Reconfigura la aplicación para usar el set de réplicas no particionado en lugar de la instancia mongos.
Después de convertir el clúster en un set de réplicas, actualice la cadena de conexión utilizada por sus aplicaciones a la cadena de conexión del set de réplicas. Luego, reinicia tus aplicaciones.

La aplicación ahora utiliza el set de réplicas sin particiones para lecturas y escrituras. Ahora puedes retirar la infraestructura de clúster sharded no utilizada restante.

Desbloquear el clúster después de convertirlo en un set de réplicas

Después de convertir el clúster en un set de réplicas, realiza los siguientes pasos para desbloquear el clúster:

Para desbloquear el clúster y permitir que las escrituras en la base de datos se reanuden, ejecuta:
```
db.getSiblingDB( "admin" ).fsyncLock()
```

Para confirmar el desbloqueo, ejecuta:

db.getSiblingDB("admin").aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } } ],
         "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

Asegúrese de que la salida muestre que fsyncLocked es false, lo que significa que el clúster está desbloqueado:
```
[ { fsyncLocked: false }, { fsyncUnlocked: true } ]
```

Obtén más información

Gestionar balanceador de clúster fragmentado

Volver

Respaldar metadatos del clúster

Convertir un set de réplicas en un clúster particionado