Overview
Puedes configurar el Preferencia de lectura para un clúster de MongoDB Atlas vinculado para controlar el tipo de miembro del conjunto de réplicas al que Atlas App Services dirige las solicitudes de lectura de la base de datos. También puede especificar un conjunto de etiquetas para miembros específicos del conjunto de réplicas.
No puedes establecer la preferencia de lectura en una fuente de datos federado.
De forma predeterminada, App Services utiliza una preferencia de lectura de primary, que enruta todas las solicitudes de lectura a través del nodo principal de un conjunto de réplicas.
Cuándo especificar la preferencia de lectura
La preferencia de lectura predeterminada (primary) debería ser suficiente para la mayoría de los casos de uso. Considere especificar una preferencia de lectura de clúster cuando necesite hacer lo siguiente:
Read from a specific secondary that has a custom configuration, such as an analytics node with special indexes optimized for reporting workloads.
Lee desde un nodo en una región específica de un set de réplicas distribuido a nivel global.
Mantener la disponibilidad de lectura durante una conmutación por error de un conjunto de réplicas, es decir, continuar leyendo datos potencialmente obsoletos cuando no hay ningún nodo
primary.
Procedimiento
Navegue a la pantalla de configuración del clúster
Puede configurar la preferencia de lectura para un clúster vinculado desde la pantalla de configuración del clúster en la interfaz de usuario de App Services. Para acceder a la pantalla de configuración, haga clic en Linked Data Sources Debajo de Manage en el panel de navegación izquierdo. En la lista de fuentes de datos, seleccione el clúster en el que desea configurar la preferencia de lectura.
Especificar una preferencia de lectura de clúster
En la pantalla de configuración del clúster, seleccione un modo del menú desplegable Read Preference.
Los siguientes modos de preferencia de lectura están disponibles:
Modo | Descripción |
|---|---|
App Services dirige todas las operaciones de lectura al nodo principal del conjunto de réplicas actual. Este es el modo de preferencia de lectura predeterminado. | |
App Services dirige todas las operaciones de lectura al nodo principal del conjunto de réplicas actual, si está disponible. Si el nodo principal no está disponible, como durante una conmutación por error automática, las solicitudes de lectura se dirigen a un nodo secundario. | |
App Services asigna todas las operaciones de lectura a uno de los nodos secundariosactuales del set de réplicas. | |
App Services dirige todas las operaciones de lectura a uno de los nodos secundarios disponibles en el set de réplicas. Si no hay nodos secundarios disponibles, las solicitudes de lectura se dirigen al primario del set de réplicas. | |
App Services routes read operations to the replica set member that has the lowest network latency relative to the client. |
Especificar etiquetas de preferencia de lectura
If you specify a read preference other than primary, you can also specify one or more read preference tags. To serve a read request, a replica set member must include all of the specified read preference tags in its node configuration.
Nota
Conjuntos de etiquetas de clúster Atlas
Para especificar una etiqueta de preferencia de lectura, haz clic en Add Tag y luego ingresa el Key y Value de la etiqueta en la nueva fila de la tabla Read Preference Tags.
Obtenga la última versión de su aplicación
Para definir la preferencia de lectura de un clúster vinculado con la CLI de App Services, necesita una copia local de los archivos de configuración de su aplicación.
Para extraer una copia local de la última versión de su aplicación, ejecute lo siguiente:
appservices pull --remote="<Your App ID>"
Tip
También puedes descargar una copia de los archivos de configuración de tu aplicación desde la pantalla Deploy > Export App en la Interfaz de usuario Realm.
Especificar una preferencia de lectura de clúster
To configure the read preference for a linked cluster, open the cluster's config.json file and set the value of config.readPreference:
{ "name": "<MongoDB Service Name>", "type": "mongodb-atlas", "config": { "readPreference": "<Read Preference Mode>" } }
Los siguientes modos de preferencia de lectura están disponibles:
Modo | Descripción |
|---|---|
App Services dirige todas las operaciones de lectura al nodo principal del conjunto de réplicas actual. Este es el modo de preferencia de lectura predeterminado. | |
App Services dirige todas las operaciones de lectura al nodo principal del conjunto de réplicas actual, si está disponible. Si el nodo principal no está disponible, como durante una conmutación por error automática, las solicitudes de lectura se dirigen a un nodo secundario. | |
App Services asigna todas las operaciones de lectura a uno de los nodos secundariosactuales del set de réplicas. | |
App Services dirige todas las operaciones de lectura a uno de los nodos secundarios disponibles en el set de réplicas. Si no hay nodos secundarios disponibles, las solicitudes de lectura se dirigen al primario del set de réplicas. | |
App Services routes read operations to the replica set member that has the lowest network latency relative to the client. |
Especificar etiquetas de preferencia de lectura
If you specify a read preference other than primary, you can also specify one or more read preference tags. To serve a read request, a replica set member must include all of the specified read preference tags in its node configuration. To specify a read preference tag set for a cluster, ensure that you have specified a readPreference other than primary, and then add one or more tag definition objects to config.readPreferenceTagSets:
{ "name": "<MongoDB Service Name>", "type": "mongodb-atlas", "config": { "readPreference": "<Read Preference Mode (other than primary)>", "readPreferenceTagSets": [ { <Tag Key>: <Tag Value> }, ... ], } }
Nota
Conjuntos de etiquetas de clúster Atlas
Los clústeres Atlas se configuran con conjuntos de etiquetas predefinidos para cada nodo miembro, según su tipo. Para obtener información detallada sobre qué etiquetas son nodos definidos en un clúster Atlas, consulte Etiquetas del conjunto de réplicas de Atlas.