Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Configurar los ajustes CRUD a nivel de cliente

En esta guía, puede aprender a utilizar el driver de Java para configurar operaciones CRUD para instancias de MongoClient.

Las preferencias de lectura, los niveles de consistencia de lectura y los niveles de confirmación de escritura (write concern) controlan cómo el driver enruta las operaciones de lectura y espera el reconocimiento para las operaciones de lectura y escritura cuando está conectado a un conjunto de réplicas de MongoDB. Las preferencias de lectura y los niveles de consistencia de lectura se aplican a todas las operaciones de lectura; los niveles de confirmación de escritura (write concern) se aplican a todas las operaciones de escritura.

Para obtener más información, consulte la documentación del servidor sobre preferencias de lectura, niveles de consistencia de lectura y niveles de confirmación de escritura (write concern).

MongoDatabase y las instancias MongoCollection heredan sus preferencias y preocupaciones de la MongoClient que accede a ellas. Sin embargo, puede aplicar configuraciones personalizadas a sus bases de datos y colecciones. Para obtener más información, consulte la página Configurar ajustes CRUD personalizados.

Puedes especificar los ajustes de CRUD a nivel de cliente utilizando un cadena de conexión o pasando un objeto MongoClientSettings al constructor MongoClients. Selecciona la pestaña Connection String o MongoClientSettings para ver las opciones disponibles:

Incluya los siguientes parámetros en su cadena de conexión para modificar el comportamiento de lectura o guardado del driver:

Nombre de la opción
Tipo
Descripción

journal

booleano

Especifica que el driver debe esperar a que la instancia conectada de MongoDB agrupe los commit en el archivo de registro en disco para todos los guardados.

Por defecto: false

w

string o número entero

Especifica el nivel de confirmación de escritura (write concern). Para obtener más información sobre los valores, consulta la documentación de MongoDB Server para la opción w.

Por defecto: 1

wtimeoutMS

entero

Especifica un límite de tiempo, en milisegundos, para el nivel de confirmación de escritura (write concern). Para obtener más información, consulta la documentación de MongoDB Server para la opción wtimeoutMS. Un valor de 0 instruye al driver para que nunca agote el tiempo de espera de las operaciones de guardado.

Por defecto: 0

readPreference

string

Especifica la preferencia de lectura. Para obtener más información sobre los valores, consulta la documentación de MongoDB Server para la opción readPreference.

Por defecto: primary

readPreferenceTags

string

Especifica las etiquetas de preferencia de lectura. Para más información sobre los valores, consulta la documentación del Servidor MongoDB para la opción readPreferenceTags.

Por defecto: null

maxStalenessSeconds

entero

Especifica, en segundos, cuán desactualizado puede estar un secundario antes de que el driver deje de comunicarse con ese secundario. El valor mínimo es 90 segundos o la frecuencia del latido más 10 segundos, el que sea mayor. Para más información, consulta la documentación de MongoDB Server para la opción maxStalenessSeconds. No proporcionar un parámetro o especificar explícitamente -1 indica que no debe haber ninguna verificación de obsolescencia para los secundario.

Por defecto: -1

uuidRepresentation

string

Especifica la representación de UUID que se usará para las operaciones de lectura y escritura. Para más información, consulta la documentación del driver para el método MongoClientSettings.getUuidRepresentation().

Por defecto: unspecified

retryWrites

booleano

Especifica que el driver debe reintentar las operaciones de guardado compatibles si no puede completarlas debido a un error de red.

Por defecto: true

retryReads

booleano

Especifica que el controlador debe reintentar las operaciones de lectura admitidas si no pueden completarse debido a un error de red.

Por defecto: true

maxAdaptiveRetries

entero

Establece el número máximo de veces que el driver reintenta un comando que falla con un error de sobrecarga reintentable (es decir, un error que lleva las etiquetas SystemOverloadedError y RetryableError).

Esta opción se aplica a los comandos de guardar solo cuando retryWrites está configurado en true y a los comandos de lectura solo cuando retryReads está configurado en true. Establecer el valor en 0 deshabilita los intentos de reintento para errores de sobrecarga reintentables.

Por defecto: null. Cuando esta opción no está configurada, el driver normalmente aplica el valor 2.

enableOverloadRetargeting

booleano

Establece si el driver puede despriorizar los servidores durante la selección de servidores para intentos de reintento posteriores si anteriormente devolvieron errores de sobrecarga.

Esta opción se aplica a las lecturas cuando retryReads está configurado en true y a guardar cuando retryWrites está configurado en true. Esta opción no se aplica a los clúster particionado.

Por defecto: false

El siguiente ejemplo configura la preferencia de lectura para leer desde el miembro de conjunto de réplicas más cercano:

ConnectionString connectionString = "mongodb://<host>:<port>/?readPreference=nearest"MongoClient mongoClient = MongoClients.create(connectionString)

Para obtener más información sobre estos parámetros, consulta la Cadena de conexión documentación de la API.

Nota

Deslastre de carga en la gestión inteligente de cargas de trabajo (IWM)

Si los errores con las etiquetas SystemOverloadedError o RetryableError están causando fallos en su aplicación o aparecen en el registro de su aplicación, Load Shedding puede estar activo en su clúster y su driver puede no estar actualizado a una versión que lo admita. Recomendamos actualizar su driver de Java de MongoDB a la versión 5.8 o posterior. Si sigue viendo estos errores después de la actualización, puede solucionarlos mediante cambios en el lado del servidor, como la revisión de la configuración de Load Shedding, o mediante cambios en el lado de la aplicación, como implementar un manejo de errores personalizado o la limitación de solicitudes en el lado del cliente. Dependiendo de su situación, los cambios en la aplicación pueden ser preferibles o necesarios.

Reducción de carga es una funcionalidad de IWM, y ayuda a gestionar la carga del servidor al rechazar operaciones excesivas durante una sobrecarga sostenida. Esta funcionalidad está disponible en MongoDB 9.0 y versiones posteriores.

Para obtener más información sobre IWM o la gestión de errores de sobrecarga, consulte la página Gestión inteligente de la carga de trabajo o la página Errores de sobrecarga en la documentación de Atlas.

Califique esta página

En esta página