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.

Migrar clústeres de Atlas Core a servidores de configuración dedicados

Importante

La funcionalidad descrita en esta página no se admite actualmente en los clúster Atlas Infinite durante la vista previa pública. Para ver la funcionalidad compatible con la versión preliminar pública, consulte Disponibilidad de la versión preliminar pública.

Nota

Si estás ejecutando un despliegue autogestionado, consulta Transición del servidor de configuración embebido al dedicado para aprender cómo pasar tu tipo de servidor de configuración usando el comando de base de datos transitionToDedicatedConfigServer.

Cuando un clúster fragmentado utiliza un servidor de configuración integrado, llamado fragmento de configuración, Atlas o usuario puede realizar la transición del clúster para utilizar un servidor de configuración dedicado. Con un servidor de configuración integrado, la partición de configuración almacena tanto los metadatos del clúster como los datos de usuario. Con un servidor de configuración dedicado, el nodo de configuración almacena solo metadatos. Atlas cambia los clústeres de servidores de configuración integrados a dedicados automáticamente bajo ciertas condiciones. También puedes iniciar la transición manualmente.

La transición de un servidor de configuración incrustado a uno dedicado es una operación en línea que requiere mover todos los datos de los usuarios fuera de la partición de configuración. Para clústeres con grandes cantidades de datos en la partición de configuración, el proceso puede durar horas o incluso días. Antes de iniciar la transición, confirma lo siguiente:

  • El balanceador debe estar activado para el drenaje de fragmentos. Cuando Atlas drena fragmentos, el balanceador mueve datos de usuario fuera del fragmento de configuración a los otros fragmentos mediante migraciones de fragmentos. El balanceador es un proceso en segundo plano que está habilitado por defecto. Si mueves los datos tú mismo, como con el resharding, no necesitas el balanceador activado.

  • Las particiones de destino tienen margen de crecimiento. Durante la migración, las particiones que reciben datos de la partición de configuración tienen un aumento en el uso de CPU, memoria e I/O. Mientras se ejecuta la transición, Atlas no puede escalar el nivel de clúster ni modificar el almacenamiento porque solo se puede ejecutar un plan de larga duración a la vez. Si las particiones receptoras están cerca de su capacidad, escálalas antes de iniciar la transición.

  • Su clúster utiliza solo funcionalidades compatibles. MongoDB Search, MongoDB Vector Search, colecciones de series de tiempo sin particiones y colecciones de Queryable Encryption sin particiones en el bloque de particiones de configuración, transiciones automáticas. Para obtener una lista completa de las funcionalidades de bloqueo, consulta Limitaciones y excepciones.

  • Descartar system.profile antes de la transición en versiones anteriores de MongoDB. La colección system.profile en la partición de configuración puede bloquear la transición. Si la elaboración de perfiles está habilitada, descarta system.profile antes de iniciar la transición, o actualiza a MongoDB 8.2.7 o una versión posterior.

  • El bloqueo de escritura no debe estar activo en el servidor de configuración. Si el bloqueo de escritura está activo en el servidor de configuración, Atlas no permite la transición a un servidor de configuración dedicado. Atlas muestra un banner en la página del clúster indicando que la transición está bloqueada mientras el bloqueo de guardar está activo. Para continuar, aumente el almacenamiento del clúster o habilite el escalado automático del almacenamiento para eliminar la condición de bloqueo de guardar y, a continuación, vuelva a intentar la transición.

Atlas gestiona automáticamente las transiciones entre los servidores de configuración integrados y dedicados cuando se activan los Servidores de configuración gestionados por Atlas. El siguiente diagrama muestra cuándo Atlas Triggers cada transición:

Atlas habilita por defecto los servidores de configuración gestionados por Atlas para todos los clústeres 8.0. Cuando está habilitado, Atlas realiza automáticamente la transición de tu clúster entre los tipos de servidores de configuración según la cantidad de particiones:

  • Cuando el número de particiones aumenta más allá de 10, Atlas pasa de un servidor de configuración embebido a un servidor de configuración dedicado.

  • Cuando la cantidad de particiones disminuye a 10 o menos, Atlas pasa de un servidor de configuración dedicado a un servidor de configuración incorporado.

Si desactivas los servidores de configuración gestionados por Atlas en un clúster que utiliza un servidor de configuración integrado, Atlas traslada el clúster a un servidor de configuración dedicado.

Nota

Cuando actualiza un clúster particionado de MongoDB 7.0 a 8.0, Atlas activa los servidor de configuración gestionado/gestionada por Atlas, pero no cambia el tipo de servidor de configuración existente del clúster. A partir de MongoDB 8.0, Los servidor de configuración gestionado/gestionada por Atlas están activados por defecto, y estos criterios se aplican solo a los cambios en el número de particiones. Para mover un clúster a un servidor de configuración integrado, póngase en contacto con MongoDB Support.

También puedes cambiar tú mismo el tipo de servidor de configuración. Una razón para hacerlo es usar el resharding para redistribuir o mover tus datos. Cuando Atlas realiza el drenaje, el balanceador mueve los datos del usuario del fragmento de configuración a los otros fragmentos, así que mantén activado el balanceador.

Si mueves los datos tú mismo, como con el resharding, puedes hacerlo independientemente del estado del balanceador.

Para activar manualmente la transición a un servidor de configuración dedicado, completa los siguientes pasos:

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2

Haz clic en el al lado del nombre de tu clúster y selecciona Edit Configuration. Despliega el panel Additional Settings para configurar ajustes adicionales de tu clúster.

3

Apaga el interruptor Atlas-Managed Configuration Servers.

En Additional Settings > More Configuration Options, desactive el interruptor Atlas-Managed Configuration Servers.

4

Haga clic en Review Changes y luego en Apply Changes. Atlas inicia inmediatamente la conversión a un servidor de configuración dedicado.

MongoDB no puede mover los metadatos de configuración, por lo que Atlas primero debe drenar todos los datos de usuario de la partición de configuración, config-0, antes de poder realizar la transición a un servidor de configuración dedicado. Como parte de la transición, Atlas agrega una partición de reemplazo para mantener tu recuento de particiones objetivo porque config-0 ya no sirve datos de usuario.

La siguiente tabla muestra los pasos que realiza Atlas cuando se agrega un fragmento 11 a un clúster de fragmentos 10 con los servidores de configuración administrados por Atlas habilitados, lo que inicia la transición.

Paso
Acción
Conteo eficaz de particiones

Inicio

Clúster 10-shard con servidor de configuración integrado (config-0 y shard-0 a shard-8)

10

1

Atlas agrega shard-9, lo que lleva al clúster a su número objetivo de fragmentos. El clúster ahora tiene 11 fragmentos orientados al usuario: shard-0 a shard-9 y config-0, que aún almacena datos de usuario.

11

2

Atlas ejecuta transitionToDedicatedConfigServer, que internamente ejecuta removeShard en config-0. Las colecciones particionadas se vacían hacia otros shards a través del balanceador mediante migraciones de fragmentos. Las colecciones sin partición se mueven a través de moveCollection.

11 (drenaje en curso)

3

Atlas espera a que orphanCleanupDelaySecs transcurra antes de confirmar que config-0 está despejado. En clústeres que ejecutan MongoDB en versiones anteriores a la 8.2.7, Atlas espera a que se completen todas las eliminaciones de rangos, lo que puede tardar mucho más.

11 (limpieza en progreso)

4

config-0 Se convierte en un servidor de configuración dedicado. Atlas agrega shard-10 para restaurar el recuento de fragmentos objetivo. Los fragmentos 11 orientados al usuario ahora son shard-0 a shard-10.

11

5

Atlas escala config-0 por defecto para los servidores de configuración dedicados, M30.

11

La duración de la transición depende de la cantidad de datos de usuario en la partición de configuración. Drenar la partición de configuración implica migraciones de fragmentos para colecciones particionadas y moveCollection operaciones para colecciones no particionadas, ambos procesos mueven datos a través de la red. La duración varía en función del tamaño del datasets:

  • Small datasets (a few GB): minutos a un número bajo de horas

  • datasets grandes (cientos de GB a varios TB): horas a días

Nota

Si tu clúster tiene un gran volumen de datos en la partición de configuración, realiza la transición durante un periodo de poco tráfico.

La transición de un servidor de configuración integrado a uno dedicado tiene los siguientes impactos operativos en tu clúster:

  • Sin tiempo de inactividad. La transición es en linea. Tu aplicación sigue leyendo y escribiendo todo el tiempo.

  • Uso elevado de recursos en las particiones receptoras. Las particiones que absorben datos de la partición de configuración pueden experimentar un mayor consumo de CPU, memoria e I/O durante la migración. La latencia de la aplicación en las particiones afectadas puede aumentar modestamente.

  • Bloqueo del plan Atlas. Mientras se ejecuta la transición, Atlas no puede ejecutar otros planes de larga duración en el clúster, como escalar el nivel del clúster, cambiar el almacenamiento o añadir o eliminar otras particiones. Solo un plan de larga duración puede ejecutarse a la vez.

Advertencia

No canceles la transición después de que haya comenzado.

No canceles a través de la interfaz de usuario de Atlas ni reduciendo el recuento de fragmentos mientras la transición está en curso. Si es necesaria la cancelación, contacta con el soporte de MongoDB.

El siguiente diagrama muestra los métodos disponibles para supervisar el progreso de la transición:

Mientras la transición está en curso, Atlas muestra el siguiente banner en la página del clúster:

We are deploying your changes (current action: transitioning config server type).

Atlas no realiza la transición automática de los servidores de configuración para los clústeres que utilizan las siguientes funcionalidades. Si tu clúster utiliza una de estas funcionalidades y necesitas cambiar el tipo de servidor de configuración, contacta Soporte de MongoDB:

funcionalidad
Transición automática
Resolución

MongoDB Search / búsqueda vectorial

Atlas fija el tipo de servidor de configuración a lo que era cuando la búsqueda fue habilitada. La restricción se aplica tanto a las colecciones fragmentadas como a las no fragmentadas.

Bloqueado (anclado)

Contacta con MongoDB Support o para una migración en vivo

Unsharded Queryable Encryption

moveCollection no admite colecciones de Queryable Encryption.

Bloqueado

Contacta con Soporte de MongoDB

Clústeres globales

No admitir servidores de configuración integrados.

N/A

Siempre dedicados

Conversión de set de réplicas a un clúster.

Cuando conviertes un set de réplicas en un clúster fragmentado en Atlas, el clúster resultante siempre usa un servidor de configuración dedicado sin importar la configuración de Atlas-Managed Configuration Servers.

N/A

Contacta con Soporte de MongoDB

Ninguna de las anteriores

Permitido

Proceeds online