setDefaultRWConcern (comando de base de datos)

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.

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.

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

Puede:

• Desactivar el nivel de consistencia de lectura global por defecto.

• Solo anule la configuración de escritura predeterminada global si aún no la ha configurado.

Por ejemplo, supón que el nivel de consistencia de lectura global por defecto está configurado en level: "majority". Para desactivar el nivel de consistencia de lectura global por defecto, utiliza un documento vacío {}:

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

La operación devuelve un documento que indica que la operación fue exitosa:

{
   defaultReadConcern: { level: 'local' },
   defaultWriteConcern: { w: 2, wtimeout: 0 },
   updateOpTime: Timestamp({ t: 1656696934, i: 1 }),
   updateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   defaultWriteConcernSource: 'global',
   defaultReadConcernSource: 'implicit',
   localUpdateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   ok: 1,
   '$clusterTime': {
      ...
   },
   operationTime: Timestamp({ t: 1656632593, i: 1 })
}

Solo puedes desmarcar el nivel de confirmación de escritura (write concern) por defecto global si no lo has configurado previamente.

Para desactivar la nivel de confirmación de escritura (write concern) por defecto global, debes usar un documento vacío {}:

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

Si el nivel de confirmación de escritura (write concern) predeterminado global es:

• Sin establecer, la operación es exitosa.

• Ya definido, la operación devuelve el siguiente error.

MongoServerError: The global default write concern cannot be unset
once it is set.