setIndexCommitQuorum (comando de base de datos)

setIndexCommitQuorum: El comando setIndexCommitQuorum establece el número mínimo de nodos portadores de datos que deben estar preparados para confirmar sus creaciones de índices locales antes de que el nodo primario confirme el índice.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     setIndexCommitQuorum: <string>,
     indexNames: [ <document> ],
     commitQuorum: <int> | <string>,
     comment: <any>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
setIndexCommitQuorum	`string`	El nombre de la colección para la que se están construyendo los índices.
Nombres de índices	`array`	Un arreglo de creaciones de índices en progreso para modificar. Cada elemento del arreglo debe ser el nombre del índice. Los índices especificados para `indexNames` deben corresponder al conjunto completo de compilaciones en proceso asociadas a un constructor de índices en particular, es decir, los índices compilados por una única `createIndexes` o `db.collection.createIndexes()` operación.
commitQuorum	`int` or `string`	El número mínimo de miembros con datos en un set de réplicas (es decir, quórum de confirmación), incluido el principal, que debe informar una creación de índices exitosa antes de que el primario marque el `indexes` como listo. Puede reanudar algunas creaciones de índices interrumpidas cuando el quórum de confirmación está configurado en el valor por defecto `"votingMembers"`. Para actualizar el commitQuorum, los nodos de set de réplicas miembros deben tener `members[n].buildIndexes` configurado en `true`. Si alguno de los nodos de votación tiene `members[n].buildIndexes` configurado en `false`, no puede usar el `"votingMembers"` cuórum de confirmación por defecto. Configure todos los nodos con `members[n].buildIndexes` estableciendo en `true`, o se debe seleccionar un quórum de confirmación diferente. Admite los siguientes valores: `"votingMembers"` - todos los nodos votantes con datos del set de réplicas (por defecto). Nodo "votante" es cualquier nodo del set de réplicas donde `members[n].votes` es mayor que `0`. `"majority"` - una mayoría simple de los miembros del set de réplicas que contienen datos. `<int>` - un número específico de miembros del set de réplicas que contienen datos. Especifica un número entero mayor que `0`. Un nombre de etiqueta de un set de réplicas.
`comment`	any	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

Comportamiento

Nota

Requiere featureCompatibilityVersion 4.4+

Cada mongod en el set de réplicas o clúster debe tener featureCompatibilityVersion configurada al menos en 4.4 para iniciar la creación de índices simultáneamente en los miembros del set de réplicas.

La creación de índices es un proceso multietapa. El proceso de creación de índices utiliza el commit quorum para minimizar el atraso de la replicación en los nodos secundarios.

Cuando un nodo secundario recibe un registro oplog de commitIndexBuild, el nodo detiene otras aplicaciones de oplog hasta que la creación de índices local pueda ser confirmada. La creación de índices puede tardar desde momentos hasta días en completarse, por lo que el atraso de la replicación puede ser significativo si el nodo secundario se crea más lentamente que el primario.

Para gestionar el atraso de la replicación, el quórum de confirmación retrasa la confirmación de la creación del índice en el nodo principal hasta que un número mínimo de secundarios también estén listos para confirmar la creación del índice.

El quórum de confirmación no garantiza que los índices en los secundarios estén listos para su uso cuando el comando se complete. Para asegurar que un número específico de secundarios estén listos para su uso, establece un nivel de confirmación de escritura (write concern)adecuado.

Si un nodo secundario que no está incluido en el quórum de confirmación recibe una entrada de oplog commitIndexBuild, el nodo puede bloquear la replicación hasta que su creación de índices esté completa.

Emitir setIndexCommitQuorum no tiene efecto en la creación de índices iniciada con un commitQuorum de 0.

Importante

Los nodos del set de réplicas con buildIndexes configurados en false no pueden incluirse en un quórum de confirmación.

Quórum de confirmación en contraste con el nivel de confirmación de escritura

Existen diferencias importantes entre quórums de confirmación y niveles de confirmación de escritura:

Las compilaciones de índices utilizan quórums de confirmación.
Las operaciones de escritura usan nivel de confirmación de escritura (write concern).

Cada nodo que lleva datos en un clúster es un miembro votante.

El quórum de confirmación especifica cuántos miembros votantes portadores de datos, o cuáles miembros votantes, incluido el primario, deben estar preparados para confirmar una creación de índices simultánea antes de que el primario ejecute la confirmación.

El nivel de confirmación de escritura (write concern) es el nivel de confirmación que la operación de escritura ha alcanzado en el número especificado de instancias.

El quórum de confirmación especifica cuántos nodos deben estar listos para finalizar la creación de índices antes de que el primario confirme la creación de índices. Por el contrario, cuando el primario ha realizado la creación de índices, el nivel de confirmación de escritura (write concern) especifica cuántos nodos deben finalizar la creación de índices antes de que el comando devuelva una respuesta.

Ejemplos

La creación de índices en un set de réplicas o en un clúster se realiza simultáneamente en todos los miembros del set de réplicas que contienen datos. Para clústeres fragmentados, la creación de índices solo ocurre en fragmentos que contienen datos para la colección que se está indexando. El primario requiere un número mínimo de nodos portadores de datos voting (es decir, quórum de confirmación), incluido él mismo, que deben completar la compilación antes de marcar el índice como listo para usar. Consulta creación de índices en entornos replicados para obtener más información.

La siguiente operación inicia una creación de índices de dos índices:

db.getSiblingDB("examples").invoices.createIndexes(
  [
    { "invoices" : 1 },
    { "fulfillmentStatus" : 1 }
  ]
)

Por defecto, las creación de índices utilizan "votingMembers" quórum de confirmación, o todos los miembros portadores de datos con derecho a voto del conjunto de réplicas. La siguiente operación modifica el quórum de confirmación de creación de índices a "majority", o una mayoría simple de nodos votantes con datos:.

db.getSiblingDB("examples").runCommand(
  {
    "setIndexCommitQuorum" : "invoices",
    "indexNames" : ["invoices_1", "fullfillmentStatus_1"],
    "commitQuorum" : "majority"
  }
)

Los índices especificados en indexNames deben ser todo el conjunto de las compilaciones en progreso asociadas a un determinado creador de índices, es decir, la operación createIndexes().
El campo indexNames especifica los nombres de los índices. Dado que los índices fueron creados sin un nombre explícito, MongoDB generó un nombre de índice concatenando los nombres de los campos indexados y el orden de clasificación.

Volver

setFeatureCompatibilityVersion

setParameter