/ /

Comandos de base de datos

Administración

Docs Home

Manual de MongoDB

Referencia

Comandos de base de datos

Administración

setDefaultRWConcern

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB.6.0

Definición

setDefaultRWConcern

El setDefaultRWConcern comando administrativo establece la configuración por defecto global de preocupación de lectura o nivel de confirmación de escritura (write concern) para un set de réplicas o un clúster fragmentado. Es necesario ejecutar setDefaultRWConcern en la base de datos admin.

Para sets de réplicas, ejecuta el comando setDefaultRWConcern en el primario mongod.
Para clústeres fragmentados, emita en setDefaultRWConcern mongosun.

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.adminCommand(
  {
    setDefaultRWConcern : 1,
    defaultReadConcern: { <read concern> },
    defaultWriteConcern: { <write concern> },
    writeConcern: { <write concern> },
    comment: <any>
  }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
setDefaultRWConcern	`int`	Se debe establecer en `1`.
defaultReadConcern	`object`	Documento que contiene la configuración global del nivel de consistencia de lectura. Especifica un objeto de nivel de consistencia de lecturaválido. `setDefaultRWConcern` soporta el siguiente subconjunto de nivel: `"local"` `"available"` `"majority"` Para anular la configuración de lectura predeterminada actualmente, especifique un documento vacío `{}`. `setDefaultRWConcern` admite únicamente la configuración de nivel de consistencia de lectura `levels`. No se puede especificar ninguna otra configuración de nivel de consistencia de lectura en el nivel de consistencia de lectura por defecto. Omitir este documento para dejar sin modificar el nivel de consistencia de lectura global actual. Si se omite, `setDefaultRWConcern` debe especificar defaultWriteConcern.
Nivel de confirmación de escritura (write concern) por defecto	`object`	Documento que contiene la configuración global de escritura predeterminada. Para la configuración de nivel de confirmación de escritura (write concern) w, `setDefaultRWConcern` soporta todos los valores de nivel de confirmación de escritura (write concern) excepto `w : 0`. Para la configuración "wtimeout" de nivel de confirmación de escritura (write concern), `setDefaultRWConcern` tiene por defecto el valor `0` si se omite la configuración. Las operaciones se bloquean hasta que se cumpla el nivel de confirmación de escritura (write concern) solicitado. Si se especifica un `wtimeout` predeterminado global, asegúrese de que el valor sea lo suficientemente grande como para permitir que las operaciones de escritura alcancen el nivel de confirmación de escritura (write concern) solicitado. Para anular la configuración de escritura actualmente, especifique un documento vacío `{}`. Omita este documento para no modificar la preocupación de escritura global actual. Si se omite, debe`setDefaultRWConcern` especificar defaultReadConcern.
writeConcern	Objeto	Opcional. Un documento que especifica la preocupación de escritura que utilizará el `setDefaultRWConcern` comando. Si se omite, `setDefaultRWConcern` utiliza el nivel de confirmación de escritura (write concern) global previamente establecido si se configuró uno.
`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.).

setDefaultRWConcern devuelve un objeto que contiene la configuración global predeterminada de lectura y escritura. Consulte para obtener documentación más completa sobre los campos getDefaultRWConcern devueltos.

Comportamiento

Nota

Requiere featureCompatibilityVersion 4.4+

Cada mongod en el set de réplicas o clúster debe tener featureCompatibilityVersion configurado al menos en 4.4 para usar setDefaultRWConcern.

A partir de MongoDB 5.0, una vez que el nivel de confirmación de escritura (write concern) de todo el clúster (CWWC) se configura mediante el comando setDefaultRWConcern, no se puede desactivar el nivel de confirmación de escritura (write concern).

MongoDB sólo aplica el nivel de confirmación de escritura (write concern) o lectura global por defecto a operaciones que no especifican explícitamente un nivel de confirmación de escritura (write concern) o lectura.

Si MongoDB aplica la configuración predeterminada global de lectura o nivel de confirmación de escritura (write concern) a una operación, esta se comporta como si dicha configuración de lectura o nivel de confirmación de escritura (write concern) hubiera sido especificada explícitamente por el cliente que emite la solicitud.

Sets de réplicas

Emite setDefaultRWConcern contra el set de réplicas primario. El primario replica la nueva configuración global por defecto a los miembros restantes del set de réplicas. Los secundarios que aún no hayan replicado la configuración global por defecto actualizada continuarán utilizando su copia local "obsoleta" de la configuración por defecto.

Emita el comando setDefaultRWConcern con un writeConcern de w : "majority" para asegurar que el comando sólo regrese después de que los cambios se hayan propagado a la mayoría de los miembros del conjunto de réplicas.

Clústeres fragmentados

Ejecute setDefaultRWConcern contra un mongos en el clúster. El mongos persiste la configuración actualizada en el conjunto de réplicas de servidores de configuración (CSRS). Cada mongos emite periódicamente un getDefaultRWConcern contra el CSRS para actualizar su copia local de la configuración global. Un mongos utiliza su copia local "anticuada" de los valores predeterminados globales durante el período entre actualizaciones.

Ejecute el comando setDefaultRWConcern con un writeConcern de w : "majority" para garantizar que el comando solo se retorne después de que los cambios se hayan propagado a la mayoría de los nodos del CSRS.

Cuando una aplicación ejecuta una operación contra la mongos sin especificar de manera explícita un ajuste de lectura o nivel de confirmación de escritura (write concern), la mongos aplica la configuración predeterminada global correspondiente.

La configuración global por defecto no se propaga a las particiones individuales. No puedes ejecutar setDefaultRWConcern contra una partición.

Importante

setDefaultRWConcern requiere featureCompatibilityVersion. 4.4+ Si reduce la featureCompatibilityVersion de su implementación 4.4 de 4.2 a, se perderán todos mongos los 30 valores predeterminados de lectura y escritura del clúster, pero las instancias podrán seguir aplicándolos durante un máximo de segundos.

Los comandos administrativos de fragmentación anulan la configuración de escritura

Los comandos administrativos de sharding que realizan operaciones de escritura en el servidor de configuración, como los comandos enableSharding o addShard, tienen un comportamiento específico con la configuración global predeterminada de nivel de confirmación de escritura (write concern):

Los comandos utilizan independientemente del problema de escritura predeterminado global "majority" configurado.
Los comandos utilizan un tiempo de espera mínimo 60000 de. Solo utilizan el valor predeterminado de escritura global wtimeout si es mayor 60000 que.

Control de acceso

Para los conjuntos de réplicas o clústeres fragmentados que aplican la autenticación en implementaciones autoadministradas, setDefaultRWConcern requiere que el usuario autenticado tenga el privilegio de setDefaultRWConcern acción.

El rol incorporado clusterManager proporciona los privilegios necesarios para ejecutar setDefaultRWConcern.

Ejemplo

Establezca el nivel de confirmación de escritura (write concern) global por defecto

La siguiente operación establece la preocupación de escritura global en lo siguiente:

w: 2

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  }
})

La operación retorna un documento similar al siguiente:

{
  "defaultWriteConcern" : {
   "w" : 2
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

Configurar el nivel de consistencia de lectura global por defecto

La siguiente operación establece la preocupación de lectura global "majority" en:

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : { "level" : "majority" }
})

La operación retorna un documento similar al siguiente:

{
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

Configura el nivel de confirmación de lectura y nivel de confirmación de escritura (write concern) global por defecto

La siguiente operación establece la preocupación global de lectura y escritura predeterminada como sigue:

w: 2 nivel de confirmación de escritura (write concern)
level: "majority" nivel de consistencia de lectura.

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  },
  "defaultReadConcern" : { "level" : "majority" }
})

La operación retorna un documento similar al siguiente:

"defaultWriteConcern" : {
  "w" : 2
},
"defaultReadConcern" : {
  "level" : "majority"
}

Preocupación por lectura y escritura predeterminada global no establecida

Considere una implementación con el siguiente nivel de confirmación de escritura (write concern) y lectura por defecto:

{
  "defaultWriteConcern" : {
    "w" : "majority"
  },
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

La siguiente operación desactiva la configuración global por defecto de los niveles de confirmación de escritura (write concern) y lectura:

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : {},
  "defaultWriteConcern" : {}
})

La operación retorna un documento similar al siguiente:

{
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

Volver

setParameter

shutdown