Nota
Esta funcionalidad no está disponible para clústeres gratuitos ni flexibles. Para obtener más información sobre qué funcionalidades no están disponibles, consulta Límites del clúster gratuito de Atlas.
Los clústeres de Atlas están configurados con etiquetas de set de réplicas predefinidas para diferentes tipos de nodos en el clúster. Puedes utilizar estas etiquetas predefinidas de set de réplicas para orientar las queries de aplicaciones específicas a tipos de nodos específicos, regiones y zonas de disponibilidad. Estas etiquetas predefinidas de set de réplicas te permiten personalizar preferencias de lectura para un set de réplicas, mejorando así el rendimiento y la fiabilidad del clúster.
Nota
Estas etiquetas de set de réplicas predefinidas difieren de las etiquetas de recursos que usted proporciona y administra. No puedes cambiar estas etiquetas de sets de réplicas que Atlas proporciona.
Para utilizar etiquetas predefinidas de set de réplicas en tu cadena de conexión y dirigir las queries a nodos específicos, utiliza las siguientes opciones de la cadena de conexión:
readPreferencereadPreferenceTagsreadConcernLevel
Para ver ejemplos, consulte Casos de uso y ejemplos.
Descripciones de etiquetas predeterminadas de conjuntos de réplicas
La siguiente tabla describe las etiquetas de set de réplicas predeterminadas que Atlas proporciona.
Nombre de etiqueta predefinido | Descripción | Ejemplo |
|---|---|---|
Zona de disponibilidad | ID de AWS para la zona de disponibilidad, nombre completamente calificado de Google Cloud para una zona, o número de Azure para la zona. Azure solo admite zonas de disponibilidad en un subconjunto de regiones. Atlas proporciona etiquetas predefinidas de zona de disponibilidad para Azure solo en las regiones que admiten zonas de disponibilidad. Para aprender más, consulta Microsoft Azure. Para obtener más información sobre los posibles valores |
|
Tipo de nodo | Tipo de nodo. Los valores posibles son:
Para obtener más información, consulte Tipos de nodos. |
|
Proveedor | Proveedor de nube en el cual se aprovisiona el nodo. Los valores posibles son:
|
|
Región |
| |
Tipo de carga de trabajo | Etiqueta de set de réplicas predefinida para distribuir su carga de trabajo entre sus nodos no de análisis (elegibles o de solo lectura) de manera uniforme. Los valores posibles son:
|
|
Estado del disco |
|
Estados del disco
La siguiente tabla describe los posibles valores diskState en las etiquetas de conjunto de réplicas predefinidas.
Estado del disco | Descripción |
|---|---|
| Apunta únicamente a nodos cálidos. Puede ejecutar consultas sin experimentar una latencia mayor o impredecible. |
Para un ejemplo de esta etiqueta de set de réplicas, consulte Reducir el impacto del calentamiento del disco secundario.
Tipos de nodos
La siguiente tabla describe los posibles valores nodeType en las etiquetas de conjunto de réplicas predefinidas.
Tipo de nodo | Descripción |
|---|---|
| |
| Leer desde nodos de solo lectura. |
| Leer desde nodos de análisis de solo lectura. |
Para aprender a configurar los nodos electables, de solo lectura y de análisis para tu clúster, consulta Configurar alta disponibilidad y aislamiento de carga de trabajo.
Tip
Para obtener detalles sobre cómo estas etiquetas pre-definidas de set de réplicas corresponden a las preferencias de lectura del conector BI de Atlas, consulta la sección de opciones de clúster del BI Connector en la página Crear un clúster.
Casos de uso y ejemplos
Considera los siguientes escenarios en los que sería beneficioso utilizar etiquetas predefinidas de sets de réplicas y consulta las cadenas de conexión de muestra correspondientes.
Importante
Alta disponibilidad para queries de nodos de análisis
Para las lecturas dirigidas a nodos analíticos con etiquetas como readPreferenceTags=nodeType:ANALYTICS, la resiliencia es crucial cuando la disponibilidad de los nodos fluctúa. Sin etiquetas de respaldo, las consultas pueden fallar durante:
Sincronización inicial durante la compactación de datos
Eventos de reducción de escala del disco
Cualquier cambio en los niveles de clúster NVMe
Para mitigar estos riesgos, asegúrate de que tu cadena de conexión incluya múltiples etiquetas de preferencia de lectura para proporcionar opciones alternativas, de modo que Atlas pueda redirigir las lecturas analíticas a los nodos disponibles durante eventos como estos. Por ejemplo:
db+srv://<db_username>:<db_password>@foo-q8x1v.mycluster.com/test?readPreference=secondary&readPreferenceTags=nodeType:ANALYTICS,priority:1&readPreferenceTags=&readConcernLevel=local
En este ejemplo:
La aplicación primero intenta conectarse a un nodo etiquetado
nodeType:ANALYTICS.Si no hay nodos de ese tipo disponible, el último vacío
readPreferenceTags=permite a la aplicación conectarse a cualquier nodo secundario disponible.
Nota
Cada una de las siguientes cadenas de conexión de ejemplo emplea la readConcernLevel=local opción. Especificar una preocupación de lectura local garantiza que las lecturas secundarias en clústeres fragmentados no devuelvan documentos huérfanos. No es necesario especificar esta opción al conectarse a conjuntos de réplicas no fragmentados.
Utiliza nodos de análisis para aislar las cargas de trabajo
Si una aplicación realiza operaciones complejas o de larga duración, como ETL o reportes, puede que desee aislar las queries de la aplicación del resto de su carga de trabajo operativa conectándose exclusivamente a nodos de análisis.
Considere la siguiente cadena de conexión:
mongodb+srv://<db_username>:<db_password>@foo-q8x1v.mycluster.com/test?readPreference=secondary&readPreferenceTags=nodeType:ANALYTICS&readConcernLevel=local
Las opciones de la cadena de conexión aparecen en el siguiente orden:
readPreference=secondaryreadPreferenceTags=nodeType:ANALYTICSreadConcernLevel=local
La opción readPreference de secondary y la opción readPreferenceTag de { nodeType : ANALYTICS } limitan las conexiones de la aplicación a los nodos analíticos.
Aisla las lecturas secundarias de aplicaciones normales de los nodos de análisis
Es posible que desee aislar las lecturas regulares de la aplicación de la carga de trabajo en los nodos de análisis.
Considere la siguiente cadena de conexión:
mongodb+srv://<db_username>:<db_password>@foo-q8x1v.mycluster.com/test?readPreference=secondary&readPreferenceTags=workloadType:OPERATIONAL&readConcernLevel=local
Las opciones de la cadena de conexión aparecen en el siguiente orden:
readPreference=secondaryreadPreferenceTags=workloadType:OPERATIONALreadConcernLevel=local
Las opciones especificadas impiden que su aplicación lea de los nodos de análisis. La aplicación debe leer desde los nodos operational, o nodos que no son de análisis.
Dirigir lecturas locales para aplicaciones distribuidas geográficamente
Utiliza etiquetas de set de réplicas predefinidas para dirigir lecturas locales a regiones específicas en aplicaciones distribuidas globalmente. Previo a la introducción de estas etiquetas de set de réplicas predefinidas, las lecturas locales para aplicaciones distribuidas globalmente dependían de calcular correctamente la preferencia de lectura más cercana. Con las etiquetas predefinidas del set de réplicas, especificar etiquetas geográficas adecuadas en combinación con una moda de preferencia de lectura de nearest proporciona un comportamiento más coherente.
La siguiente cadena de conexión prioriza las conexiones a la US_EAST_1 región AWS, seguida de la US_EAST_2 región:
mongodb+srv://<db_username>:<db_password>@foo-q8x1v.mycluster.com/test?readPreference=nearest&readPreferenceTags=provider:AWS,region:US_EAST_1&readPreferenceTags=provider:AWS,region:US_EAST_2&readPreferenceTags=&readConcernLevel=local
Las opciones de la cadena de conexión aparecen en el siguiente orden:
readPreference=nearestreadPreferenceTags=provider:AWS,region:US_EAST_1readPreferenceTags=provider:AWS,region:US_EAST_2readPreferenceTags=readConcernLevel=local
Atlas considera cada etiqueta de preferencia de lectura en el orden especificado. Después de asociar un nodo con una etiqueta, encuentra todos los nodos elegibles que coincidan con esa etiqueta. Atlas ignora cualquier readPreferenceTags posterior.
En este ejemplo, la aplicación primero intenta conectarse a un nodo en la región de US_EAST_1 AWS. Si no hay ningún nodo disponible en esa región, la aplicación intenta conectarse a un nodo en la región de US_EAST_2 AWS.
El (vacío) readPreferenceTags= final proporciona una opción de emergencia. Con una opción readPreferenceTags= vacía, la aplicación puede conectarse a cualquier nodo disponible independientemente del proveedor o región.
Estas opciones ayudan a garantizar que la aplicación se conecte a la región geográfica más cercana para reducir la latencia y mejorar el rendimiento.
Nota
Puedes realizar una segmentación adicional de lecturas según las zonas de disponibilidad.
Tip
Para información adicional y casos de uso para varias preferencias de lectura, consulta la página de Preferencias de Lectura en el Manual de MongoDB.
Reduce el impacto de recalentamiento en discos secundarios
Cuando Atlas añade o reemplaza un nodo en tu clúster, realiza un preacondicionamiento de disco por defecto. Durante el proceso de pre-calentamiento del disco, el volumen de almacenamiento recién creado experimenta un periodo de intenso uso de IOPS. Esto ralentiza las operaciones de lectura realizadas en este nodo. Por lo tanto, durante el proceso de pre-calentamiento del disco, Atlas mantiene oculto el nodo de pre-calentamiento por defecto, evitando que participe en cualquier operación de lectura.
Si prefiere que un nodo recién añadido o reemplazado se active y sea visible de inmediato, puede optar por desactivar el precalentamiento rápido del disco y evitar operaciones de lectura en un nodo en calentamiento utilizando una cadena de conexión como en el siguiente ejemplo:
mongodb+srv://<db_username>:<db_password>@foo-q8x1v.mycluster.com/test?readPreference=secondary&readPreferenceTags=diskState:READY&readConcernLevel=local
Las opciones de la cadena de conexión aparecen en el siguiente orden:
readPreference=secondaryreadPreferenceTags=diskState:READYreadConcernLevel=local
La opción readPreference de secondary y la opción readPreferenceTag de { diskState : READY } le indican a Atlas que solo apunte a nodos activos.
Recuperar zonas de disponibilidad
Atlas proporciona etiquetas de conjuntos de réplicas predefinidas para las zonas de disponibilidad de forma predeterminada. Estas etiquetas incluyen el ID de la zona de disponibilidad de AWS, el nombre completo de Google Cloud para una zona o el número de zona de Azure. Puede comprobar la zona de disponibilidad de un nodo mediante el rs.conf() método de shell o consultando el último ping del nodo del clúster.
Ejemplo
... "tags": { "availabilityZone": "use2-az2", ...
Nivel de confirmación de escritura (write concern) personalizado incorporado
Atlas proporciona niveles de confirmación de escritura (write concern) personalizados de funcionalidad incorporada para clústeres multiregionales. El nivel de confirmación de escritura (write concern) describe el nivel de reconocimiento solicitado a MongoDB para operaciones de escritura en un clúster.
Las preocupaciones de escritura personalizadas integradas de Atlas pueden ayudar a mejorar la consistencia de los datos al garantizar que sus operaciones se propaguen a una cantidad determinada de regiones para tener éxito.
Para usar un nivel de confirmación de escritura (write concern) personalizado, especifica el nivel de confirmación de escritura (write concern) en el documento de nivel de confirmación de escritura (write concern) de tu operación.
Atlas proporciona los siguientes niveles de confirmación de escritura (write concern) personalizados para clústeres multiregionales:
Nivel de confirmación de escritura | etiqueta | Descripción |
|---|---|---|
|
| Las operaciones de escritura deben ser reconocidas por al menos dos regiones en el clúster. |
|
| Las operaciones de escritura deben ser reconocidas por al menos tres regiones en tu clúster. |
|
| Las operaciones de escritura deben ser reconocidas por al menos dos regiones en tu clúster con diferentes proveedores de nube. |
Ejemplo
Considera un clúster multiregional en tres regiones: us-east-1, us-east-2 y us-west-1. Deben propagarse las operaciones de guardar a las tres regiones de tu clúster antes de que Atlas las acepte.
La siguiente operación inserta un documento y requiere que la operación se propague a las tres regiones debido al objeto de preocupación de escritura { w: "threeRegions" }:
db.employees.insertOne( { name: "Bob Smith", company: "MongoDB" }, { writeConcern: { w: "threeRegions", j: true } } )