/ /

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

getDefaultRWConcern (comando de base de datos)

Definición

getDefaultRWConcern

La getDefaultRWConcern mandato administrativo recupera la configuración global por defecto de lectura o nivel de confirmación de escritura.

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 de lectura predeterminada global. 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"`.
Fuente de preocupación de lectura predeterminada	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+

mongod Cada 4.4 getDefaultRWConcerndel conjunto de 4.4 4.2réplicas o clúster fragmentado debe tener featureCompatibilityVersion establecido al menos mongos en para usar. Si reduce featureCompatibilityVersion de su implementación de a, se perderán todos los 30 valores predeterminados de lectura y escritura de todo el clúster, pero las instancias podrán seguir aplicándolos durante un máximo de 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 en el mongos 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 conjuntos de réplicas o clústeres fragmentados que aplican la autenticación en implementaciones autoadministradas, getDefaultRWConcern requiere que el usuario autenticado tenga el privilegio de getDefaultRWConcern acción.

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