getDefaultRWConcern (comando de base de datos)

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

Definición

getDefaultRWConcern

El comando administrativo getDefaultRWConcern recupera la configuración predeterminada global de lectura o nivel de confirmación de escritura (write concern).

Para clústeres sharded, emita el getDefaultRWConcern en un mongos.

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 forma:

db.adminCommand(
   {
     getDefaultRWConcern: 1 ,
     inMemory: <boolean>,
     comment: <any>
   }
)

Campos de comandos

El comando tiene los siguientes campos:

Campo	Tipo	Descripción
getDefaultRWConcern	Int	Se debe establecer en `1`.
En memoria	booleano	Opcional. Configúralo en `true` para devolver la copia en caché en memoria de la configuración global por defecto de lectura o nivel de confirmación de escritura (write concern). La instancia utiliza la copia en memoria al aplicar los valores por defecto globales a una operación. Configúrelo en `false` para devolver la copia en disco de la configuración global predeterminada de lectura o nivel de confirmación de escritura (write concern) de la implementación. Por defecto es `false`.
`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.).

Salida

La salida puede incluir los siguientes campos:

Campo	Tipo	Descripción
Nivel de confirmación de escritura (write concern) por defecto	`object`	La configuración global predeterminada de nivel de confirmación de escritura (write concern). Si la implementación no tiene configuraciones por defecto globales de nivel de confirmación de escritura (write concern), este campo está ausente en la salida de `getDefaultRWConcern`.
defaultReadConcern	`object`	La configuración global nivel de consistencia de lectura por defecto. Si la implementación no tiene configuraciones globales por defecto de nivel de consistencia de lectura, este campo está ausente en la salida de `getDefaultRWConcern`.
defaultWriteConcernSource	String	El origen del nivel de confirmación de escritura (write concern) por defecto. Por defecto, el valor es `"implicit"`. Una vez que establezca el nivel de confirmación de escritura (write concern) por defecto con `setDefaultRWConcern`, el valor se convierte en `"global"`.
defaultReadConcernSource	String	El origen del nivel de consistencia de lectura por defecto. Por defecto, el valor es `"implicit"`. Una vez que establezca el nivel de consistencia de lectura por defecto con `setDefaultRWConcern`, el valor se convierte en `"global"`.
updateOpTime	Marca de tiempo	El timestamp de la operación de cuándo se modificó por última vez la configuración global por defecto de concern de lectura o escritura. Se presenta si alguna vez se ha establecido una configuración por defecto para el clúster.
updateWallClockTime	fecha	La fecha del reloj del sistema en la que un administrador configuró por última vez el nivel de confirmación de escritura (write concern) global predeterminado de lectura o escritura. Este valor es informativo y no debe utilizarse para ninguna comparación de recencia.
localUpdateWallClockTime	fecha	La fecha del reloj de pared en la que el `mongod` o el `mongos` actualizaron por última vez su copia local de la configuración global predeterminada de lectura y nivel de confirmación de escritura (write concern). Este valor es informativo y no debe usarse para comparar la actualidad.

Tip

setDefaultRWConcern

Comportamiento

Nota

Requiere featureCompatibilityVersion 4.4+

Cada mongod en el set de réplicas o clúster debe tener la featureCompatibilityVersion establecida en al menos 4.4 para usar getDefaultRWConcern. Si se reduce la versión featureCompatibilityVersion de la implementación de 4.4 a 4.2, se pierden todos los valores predeterminados de nivel de confirmación de escritura (write concern) a nivel de clúster, pero las instancias de mongos pueden seguir aplicando los valores predeterminados durante hasta 30 segundos.

Sets de réplicas

Puede emitir getDefaultRWConcern contra cualquier miembro portador de datos del set de réplicas (es decir, no contra un árbitro).

Un secundario puede devolver una versión "desactualizada" de la configuración global por defecto si aún no ha replicado los últimos cambios del primario.

Clústeres fragmentados

Emite el setDefaultRWConcern contra un mongos en el clúster.

Cada mongos actualiza periódicamente su copia local de las configuraciones por defecto globales. Un mongos puede devolver una versión 'obsoleta' de la configuración global predeterminada si aún no ha actualizado su copia local después de una actualización reciente de la configuración global predeterminada o si obtuvo su configuración de un servidor de configuración secundariorezagado.

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

Control de acceso

Para los sets de réplicas o clústeres que apliquen la autenticación en implementaciones autogestionadas, getDefaultRWConcern requiere que el usuario autenticado tenga la acción privilegio getDefaultRWConcern.

Los roles incorporados clusterManager o clusterMonitor proporcionan los privilegios necesarios para ejecutar getDefaultRWConcern.

Ejemplo

La siguiente operación recupera la configuración global actual de los niveles de confirmación de lectura y escritura (read and write concern) por defecto para el mongod.

db.adminCommand({
  "getDefaultRWConcern": 1
})

La operación devuelve una salida similar a la siguiente:

{
  "defaultWriteConcern" : {
    "w" : "majority"
  },
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "defaultWriteConcernSource" : "global",
  "defaultReadConcernSource" : "global",
  "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

getClusterParameter

getParameter