Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

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

Este tutorial describe cómo convertir un clúster particionado en un set de réplicas no particionado. Para convertir un set de réplicas en un clúster particionado, consulte Convertir un set de réplicas autogestionado en un clúster particionado. Consulte la documentación de Introducción y arquitectura del particionado para obtener más información sobre los clústeres particionados.

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

  1. Desactivar el balanceador.

  2. Convierta el clúster en un set de réplicas.

  3. Desbloquee el clúster (solo clúster de varias particiones).

A partir de MongoDB 8.0, se puede utilizar el rol directShardOperations para realizar operaciones de mantenimiento que requieren ejecutar comandos directamente contra un fragmento.

Advertencia

Ejecutar comandos usando el rol directShardOperations puede hacer que su clúster deje de funcionar correctamente y puede causar corrupción de datos. Utiliza el rol directShardOperations únicamente con fines de mantenimiento o bajo la orientación del soporte de MongoDB. Deja de usar el rol directShardOperations cuando termines de realizar operaciones de mantenimiento.

Los pasos de este tutorial requieren MongoDB 6.0 o posterior.

Los comandos fsync y fsyncUnlock requieren la acción de autorización fsync, la cual puede asignarse mediante el hostManager rol o un rol personalizado.

En un clúster particionado, MongoDB almacena las definiciones de usuario y rol en la base de datos admin de los servidores de configuración. Estas definiciones no se transfieren al set de réplicas cuando convierte el clúster.

Antes de que sus aplicaciones se conecten al set de réplicas, cree los usuarios y roles que su implementación requiere en el set de réplicas. Para obtener más información, consulte Crear un usuario en implementaciones autogestionadas y Gestionar usuarios y roles en implementaciones autogestionadas.

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

A partir de MongoDB 8.3, los sets de réplicas que anteriormente eran clústeres particionados no se pueden volver a convertir en clústeres particionados.

La conversión de un clúster fragmentado en un conjunto de réplicas preserva los metadatos de particionado de su implementación anterior, incluido un document de identidad de partición, lo que impide que vuelva a convertirse en un clúster fragmentado. Si intentas una reconversión autogestionada a un clúster particionado, MongoDB devolverá un error.

Para convertir estos sets de réplicas en clústeres fragmentados, contacta con el soporte técnico.

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:

1

Para desactivar el balanceador:

  1. Conecte mongosh a una instancia mongos en el clúster particionado.

  2. Para detener el balanceador, ejecute:

    sh.stopBalancer()
  3. Para verificar que el balanceador está desactivado, ejecute el siguiente comando y asegúrese de que la salida sea false:

    sh.getBalancerState()
2
  1. Detenga todas las instancias de mongos.

  2. Reconfigure la aplicación para conectarse directamente a los nodos del set de réplicas de la partición que se convertirá en el nuevo set de réplicas.

  3. Realice un reinicio en secuencia del set de réplicas para remover la opción --shardsvr de mongod.

    Tip

    Cambiar la opción --shardsvr cambia el puerto en el que mongod escucha las conexiones entrantes.

El clúster de partición única ahora es un set de réplicas no particionado que acepta operaciones de lectura y escritura en el conjunto de datos. Puede desmantelar los servidores de configuración según sea necesario.

Gestionar balanceador de clúster fragmentado