Acerca de esta tarea
Las creaciones de índices continuos son una alternativa a creaciones de índices por defecto.
Advertencia
Evita realizar procesos de creación de índices en modo continuo y replicado al mismo tiempo, ya que podría generar problemas inesperados, como compilaciones fallidas y bucles de fallos.
Considerations
Advertencia
Asegúrate de no realizar operaciones DDL mientras llevas a cabo la creación de índices incremental.
Unique Indexes
Para crear índices únicos utilizando el siguiente procedimiento, debes detener todas las escrituras en la colección durante este procedimiento.
Si no puedes detener todos los guardados en la colección durante este procedimiento, no utilices el procedimiento en esta página. En su lugar, compile su índice único en la colección emitiendo db.collection.createIndex()en el para un clúster mongos fragmentado.
Tamaño del Oplog
Asegúrate de que tu oplog sea lo suficientemente grande para permitir que la operación de indexación o reindexación se complete sin retrasarse demasiado para ponerse al día. Consulta la documentación de dimensionamiento del oplog para obtener información adicional.
Las compilaciones de índice continuo reducen la resiliencia de su clúster y aumentan la duración de la compilación.
Antes de comenzar
- Para construir índices únicos
Para crear índices únicos usando el siguiente procedimiento, debe detener todas las escrituras en la colección durante la creación de índices. De lo contrario, se podría terminar con datos incoherentes entre los miembros del conjunto de réplicas. Si no puedes detener todas las escrituras en la colección, no uses el siguiente procedimiento para crear índices únicos.
Advertencia
Si no puede detener todas las escrituras en la colección, no utilice el siguiente procedimiento para crear índices únicos.
Antes de crear el índice, valide que ningún documento de la colección infrinja las restricciones del índice. Si una colección está distribuida entre particiones y una partición contiene un fragmento con documentos duplicados, la operación de creación de índices puede tener éxito en las particiones sin duplicados pero no en la partición con duplicados. Para evitar dejar índices inconsistentes en las particiones, puedes emitir el comando
db.collection.dropIndex()desde unmongospara descartar el índice de la colección.
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.
Procedimiento
Importante
El siguiente procedimiento para crear índices de forma gradual se aplica a las implementaciones de clústeres, y no a las implementaciones de sets de réplicas. Para el procedimiento para conjuntos de réplicas, consulta Crear una creación de índices con cambios continuos en conjuntos de réplicas en su lugar.
A. Detener migraciones
Conectar mongosh a una mongos instancia en el clúster fragmentado y desactivar las migraciones para la colección donde se desea realizar el índice de creación progresiva:
db.adminCommand( { setAllowMigrations: "<db>.<collection>", allowMigrations: false } )
El comando anterior garantiza que se seleccione el conjunto correcto de fragmentos para las compilaciones de índices continuos porque no se permitirá que se confirme ninguna migración para la colección.
Si el comando devuelve el siguiente error, significa que la colección no está particionada. Puedes ignorar el error de forma segura y continuar con el siguiente paso.
MongoServerError[NamespaceNotSharded]: Collection must be sharded so migrations can be blocked
B. Determinar la distribución de la colección
Para determinar qué fragmentos deben participar en la creación del índice continuo, ejecute la siguiente agregación en la colección en la que desea crear el índice:
db.getSiblingDB(<db>).getCollection(<collection>).aggregate([{$collStats:{}},{$group: {_id: "$ns", shard_list: {$addToSet: "$shard"}}}])
Por ejemplo, si deseas crear un índice en la colección records de la base de datos test:
db.getSiblingDB("test").getCollection("records").aggregate([{$collStats:{}},{$group: {_id: "$ns", shard_list: {$addToSet: "$shard"}}}])
[ { _id: 'test.records', shard_list: [ 'shardA', 'shardC' ] } ]
A partir de la salida, solo compilas los índices para test.records en shardA y shardC.
C. Crear índices en los fragmentos que contienen fragmentos de colección
Para cada fragmento que contenga fragmentos para la colección, siga el procedimiento para crear el índice en el fragmento.
C1. Detener un sistema secundario y reiniciarlo como independiente
Para una partición afectada, detén el proceso de mongod asociado con uno de sus secundarios. Reinicie después de realizar las siguientes actualizaciones de configuración:
Si está utilizando un archivo de configuración, realice las siguientes actualizaciones de configuración:
Cambie el a
net.portun puerto diferente. [1] Anote la configuración del puerto original como comentario.Comenta la opción
replication.replSetName.Comenta la opción
sharding.clusterRole.Establece el parámetro
skipShardingConfigurationChecksentrueen la secciónsetParameter.Establece el parámetro
disableLogicalSessionCacheRefreshentrueen la secciónsetParameter.
Por ejemplo, para un miembro del conjunto de réplicas de fragmentos, el archivo de configuración actualizado incluirá contenido como el siguiente ejemplo:
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27218 # port: 27018 #replication: # replSetName: shardA #sharding: # clusterRole: shardsvr setParameter: skipShardingConfigurationChecks: true disableLogicalSessionCacheRefresh: true
Y reinicia:
mongod --config <path/To/ConfigFile>
Otras configuraciones (por ejemplo, storage.dbPath, etc.) permanecen iguales.
Si usas opciones de línea de comando, realiza las siguientes actualizaciones de configuración:
Remover
--replSet.Elimine
--shardsvrsi es un nodo de la partición y--configsvrsi es un nodo del servidor de configuración.Configura el parámetro
skipShardingConfigurationChecksentrueen la opción--setParameter.Configura el parámetro
disableLogicalSessionCacheRefreshatrueen la opción--setParameter.
Por ejemplo, reinicie el miembro del conjunto de réplicas de fragmentos sin las --replSet --shardsvr opciones y. Especifique un nuevo número de puerto y configure skipShardingConfigurationChecks los disableLogicalSessionCacheRefresh parámetros y como verdaderos:
mongod --port 27218 --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true
Otras configuraciones (por ejemplo, --dbpath, etc.) permanecen iguales.
| [1] | (1, 2) Al ejecutar en un puerto diferente, se asegura de que los demás miembros del conjunto de réplicas y todos los clientes no se comuniquen con el miembro mientras usted crea el mongod índice. |
C2. Construir el índice
Conéctese directamente a la mongod instancia que se ejecuta como independiente en el nuevo puerto y cree el nuevo índice para esta instancia.
Por ejemplo, conectemongosha la instancia y utilice el métododb.collection.createIndex()para crear un índice ascendente en el campo username de la colección records:
db.records.createIndex( { username: 1 } )
C3. Reiniciar el Programa mongod como un set de réplicas
Al finalizar la compilación del índice, apague la instancia. Deshaga los cambios de configuración realizados al iniciarla como independiente para volver a su configuración original y mongod reiniciar.
Importante
Asegúrate de remover el parámetro skipShardingConfigurationChecks y el parámetro disableLogicalSessionCacheRefresh.
Por ejemplo, para reiniciar el miembro del fragmento del conjunto de réplicas:
Si estás usando un archivo de configuración:
Restaurar al número de puerto original.
Descomente
replication.replSetNameel.Descomente
sharding.clusterRoleel.Remover el parámetro
skipShardingConfigurationChecksen la secciónsetParameter.Eliminar
disableLogicalSessionCacheRefreshel parámetro en lasetParametersección.
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27018 replication: replSetName: shardA sharding: clusterRole: shardsvr
Otras configuraciones (por ejemplo, storage.dbPath, etc.) permanecen iguales.
Y reinicia:
mongod --config <path/To/ConfigFile>
Si está utilizando opciones de línea de comandos:
Restaurar al número de puerto original.
Incluir
--replSet.Incluya si es
--shardsvr--configsvrun miembro del fragmento o si es un miembro del servidor de configuración.Remove parameter
skipShardingConfigurationChecks.Remove parameter
disableLogicalSessionCacheRefresh.
Por ejemplo:
mongod --port 27018 --replSet shardA --shardsvr
Otras configuraciones (por ejemplo, --dbpath, etc.) permanecen iguales.
Permitir que la replicación se ponga al día en este nodo.
C4. Repita el procedimiento para los secundarios restantes de la partición
Una vez que el miembro alcanza a los otros miembros del conjunto, repita el procedimiento un miembro a la vez para los miembros secundarios restantes del fragmento:
C5. Construir el índice en el primario
Cuando todos los secundarios del shard tengan el nuevo índice, degrada el primario del shard, reinícialo como uno autónomo usando el procedimiento descrito anteriormente y crea el índice en el ex-primario:
Utilice el
rs.stepDown()método en para reducir el principal. Tras una reducción exitosa, el principal actual se convierte en secundario y los miembros del conjunto de réplicas eligen un nuevomongoshprincipal.C1. Detener un sistema secundario y reiniciarlo como independiente
C3. Reiniciar el programa
mongodcomo miembro del set de réplicas
D. Repetir para las otras particiones afectadas
Una vez que termines de crear un índice para una partición, repite C. Crear índices en las particiones que contienen fragmentos de la colección para las otras particiones afectadas.
E. Habilitar Migraciones
Conecta mongosh a una mongos instancia en el clúster particionado y vuelve a habilitar la migración con setAllowMigrations:
db.adminCommand( { setAllowMigrations: "<db>.<collection>", allowMigrations: true } )
Si el comando devuelve el siguiente error, significa que la colección no está fragmentada. Puede ignorar el error de forma segura.
MongoServerError[NamespaceNotSharded]: Collection must be sharded so migrations can be blocked
Información Adicional
Una colección particionada tiene un índice inconsistente si la colección no tiene exactamente los mismos índices (incluidas las opciones de índice) en cada partición que contiene fragmentos de la colección. Aunque no deberían ocurrir índices inconsistentes durante las operaciones normales, pueden ocurrir índices inconsistentes, como por ejemplo:
Cuando un usuario está creando un índice con una restricción de clave
uniquey una partición contiene un fragmento con documentos duplicados. En tales casos, la operación de creación de índice puede tener éxito en las particiones sin duplicados, pero no en la partición con duplicados.Cuando un usuario está creando un índice en las particiones de manera continua, pero no logra compilar el índice para una partición asociada o lo compila incorrectamente con una especificación diferente.
El servidor de configuración primario comprueba periódicamente las inconsistencias de índice en los particiones de las colecciones particionadas. Para configurar estas comprobaciones periódicas, consulta enableShardedIndexConsistencyCheck y shardedIndexConsistencyCheckIntervalMS.
El comando serverStatus devuelve el campo shardedIndexConsistency para informar sobre inconsistencias en los índices cuando se ejecuta en el servidor de configuración primario.
Para verificar si una colección fragmentada tiene índices inconsistentes, consulta Buscar índices inconsistentes entre particiones.