Definición
cursor.readPref(mode, tagSet)Importante
Método mongosh
Esta página documenta un método.
mongoshEsta no es la documentación de un controlador específico de un lenguaje, como Node.js.Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.
Agregue a un cursor para controlar cómo el cliente enruta la consulta a los miembros del conjunto de
readPref()réplicas.Nota
Debe aplicar al cursor antes de recuperar cualquier documento de la base de datos.
readPref()
Parámetros
Parameter | Tipo | Descripción |
|---|---|---|
string | Uno de los siguientes modos de preferencia de lectura: | |
arreglo de documentos | opcional. Un conjunto de etiquetas utilizado para dirigir lecturas a los nodos con la(s) etiqueta(s) especificada(s). Para obtener más detalles, consulte Listas de conjuntos de etiquetas de preferencias de lectura. |
readPref() no admite la opción Preferencia maxStalenessSeconds de lectura para la preferencia de lectura.
Compatibilidad
Este método 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 la compatibilidad de Atlas con 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.
Ejemplos
Especificar el modo de preferencia de lectura
La siguiente operación utiliza la preferencia de lectura moda para dirigir la lectura hacia un secundario.
db.collection.find({ }).readPref( "secondary")
Especificar conjunto de etiquetas de preferencia de lectura
Para dirigir los secundarios con etiquetas específicas, incluye tanto el modo como el arreglo tagSet:
db.collection.find({ }).readPref( "secondary", [ { "datacenter": "B" }, // First, try matching by the datacenter tag { "region": "West"}, // If not found, then try matching by the region tag { } // If not found, then use the empty document to match all eligible members ] )
Durante el proceso de selección de secundaria, MongoDB intenta encontrar primero los miembros secundarios con la etiqueta datacenter: "B".
Si se encuentra, MongoDB limita los secundarios elegibles a aquellos con la etiqueta
datacenter: "B"y omite las etiquetas restantes.Si no se encuentra ninguno, MongoDB intenta encontrar nodos secundarios con la etiqueta
"region": "West".Si se encuentra, MongoDB limita los secundarios elegibles a aquellos con la etiqueta
"region": "West".Si no se encuentra ninguno, MongoDB utiliza cualquier secundario elegible.
Ver Orden de coincidencia de etiquetas para más detalles.