Opciones de cadena de conexión

En esta página, se enumeran todas las opciones de conexión a su base de datos mediante cadenas de conexión SRV y cadenas de conexión estándar.

Las opciones de conexión son pares en la siguiente forma: name=value.

La opción name no distingue entre mayúsculas y minúsculas cuando se utiliza un driver.
La opción name no distingue entre mayúsculas y minúsculas cuando se utiliza mongosh.
El value siempre distingue entre mayúsculas y minúsculas.

Separe las opciones con el carácter ampersand (&) name1=value1&name2=value2. En el siguiente ejemplo, una conexión incluye las opciones replicaSet y connectTimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db1.example.net:27017,db2.example.net:2500/?replicaSet=test&connectTimeoutMS=300000

Nota

Separador de punto y coma para los argumentos de la cadena de conexión

Para proporcionar compatibilidad con versiones anteriores, los controladores actualmente aceptan punto y coma (;) como separadores de opciones.

Opción de set de réplicas

La siguiente cadena de conexión se conecta a un set de réplicas llamado myRepl con nodos que se ejecutan en los hosts especificados. Se autentica como el usuario myDatabaseUser con la contraseña D1fficultP%40ssw0rd:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com:27017,db1.example.com:27017,db2.example.com:27017/?replicaSet=myRepl

Opción de conexión

Descripción

replicaSet

Especifica el nombre de la Conjunto de réplicas, si es miembro de un conjunto de réplicas. Configure mongod la replicaSet opción de conexión para garantizar un comportamiento consistente entre los controladores.

Al conectarse a un set de réplicas, proporcione una lista de nodos iniciales de los nodos del set de réplicas al componente host[:port] del URI. Para obtener detalles específicos, consulte la documentación de su driver.

directConnection

Especifica si el cliente se conecta directamente al host[:port] en el URI de conexión:

true: el cliente envía operaciones únicamente al host especificado. No intenta descubrir ningún otro nodo del set de réplicas.
false: el cliente intenta descubrir todos los servidores en el set de réplicas y envía operaciones al nodo primario. Este es el valor por defecto.

IMPORTANTE: Cuando un set de réplicas se ejecuta en Docker, podría exponer solo un punto de conexión de MongoDB. En este caso, el set de réplicas no es detectable, y especificar directConnection=false puede impedir que su aplicación se conecte a él.

En un entorno de prueba o desarrollo, se puede realizar la conexión al set de réplicas especificando directConnection=true en la URI de conexión. En un entorno de producción, recomendamos configurar el clúster para que cada instancia de MongoDB sea accesible fuera de la red virtual de Docker.

Opciones de conexión

Opciones de TLS

La siguiente cadena de conexión a un set de réplicas incluye la opción tls=true. Se autentica como el usuario myDatabaseUser con la contraseña D1fficultP%40ssw0rd.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&tls=true

Alternativamente, también puede usar la opción ssl=trueequivalente:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&ssl=true

Opción de conexión	Descripción
`tls`	Habilita o deshabilita TLS/SSL para la conexión: `true`: inicia la conexión con TLS/SSL. Por defecto para el formato de conexión SRV. `false`: inicia la conexión sin TLS/SSL. Por defecto para el formato estándar de cadena de conexión. La opción `tls` es equivalente a la opción `ssl`. Si el shell de `mongosh` especifica opciones adicionales de tls/ssl desde la línea de comandos, utilice la opción de línea de comandos `--tls` en su lugar.
`ssl`	Un valor booleano para activar o desactivar TLS/SSL para la conexión: `true`: inicia la conexión con TLS/SSL. Por defecto para el formato de conexión SRV. `false`: inicia la conexión sin TLS/SSL. Por defecto para el formato estándar de cadena de conexión. La opción `ssl` es equivalente a la opción `tls`. Si el shell de `mongosh` especifica opciones adicionales de tls/ssl desde la línea de comandos, utilice la opción de línea de comandos `--ssl` en su lugar.
`tlsCertificateKeyFile`	Especifica la ubicación de un archivo `.pem` local que contiene el certificado X.509 TLS/SSL del cliente o el certificado y la clave TLS/SSL del cliente. El cliente presenta este archivo a la instancia `mongod` / `mongos`. `mongod` / `mongos` genera un registro de advertencia en la conexión si el certificado X.509 presentado caduca dentro de `30` días a partir de la hora del sistema host `mongod/mongos`. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar.
`tlsCertificateKeyFilePassword`	Especifica la contraseña para descifrar el `tlsCertificateKeyFile`. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar.
`tlsCAFile`	Especifique la ubicación de un archivo `.pem` local que contenga la cadena de certificados raíz de la Autoridad certificadora. Este archivo se utiliza para validar el certificado presentado por la instancia `mongod` / `mongos`. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar.
`tlsAllowInvalidCertificates`	Omite la validación de los certificados presentados por la instancia de `mongod` / `mongos`. Establecido en `true` para conectarse a instancias de MongoDB incluso si los certificados actuales del servidor no son válidos. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar. ADVERTENCIA: Deshabilitar la validación de certificados crea una vulnerabilidad.
`tlsAllowInvalidHostnames`	Desactiva la validación del nombre de host del certificado presentado por la instancia de `mongod` / `mongos`. Establezca en `true` para conectarse a instancias de MongoDB incluso si el nombre de host en los certificados del servidor no coincide con el host del servidor. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar. ADVERTENCIA: Deshabilitar la validación de certificados crea una vulnerabilidad.
`tlsInsecure`	Desactiva varias validaciones de certificados. Establezca en `true` para desactivar las validaciones de certificados. Las validaciones exactas desactivadas varían según los drivers. Consulte la documentación de los drivers. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Utiliza la opción de línea de comandos en su lugar. ADVERTENCIA: Deshabilitar la validación de certificados crea una vulnerabilidad.

Opciones de tiempo de espera

Opción de conexión	Descripción
`connectTimeoutMS`	El tiempo en milisegundos en que se intenta una conexión antes de que se agote el tiempo de espera. El valor por defecto es 10 000 milisegundos, pero algunos controladores podrían tener un valor diferente. Para obtener más detalles, consulte la documentación del driver.
`socketTimeoutMS`	El tiempo en milisegundos para intentar enviar o recibir en un socket antes de que el tiempo del intento se agote. La configuración por defecto nunca es agotar el tiempo de espera, aunque los diferentes drivers pueden variar. Consulte la documentación del driver.

Opciones de compresión

Opción de conexión

Descripción

compressors

String delimitada por comas de compresores para habilitar la compresión de red para la comunicación entre este cliente y una instancia de mongod / mongos.

Puede especificar los siguientes compresores:

Si especifica varios compresores, el orden en el que enumera los compresores es importante, así como el iniciador de la comunicación. Por ejemplo, si el cliente especifica los siguientes compresores de red "zlib,snappy" y el mongod especifica "snappy,zlib", los mensajes entre el cliente y el mongod usan zlib.

Los mensajes se comprimen cuando ambas partes permiten la compresión de red. De lo contrario, los mensajes entre las partes no se comprimen.

Si las partes no comparten al menos un compresor común, los mensajes entre las partes no se comprimen.

mongosh admite la opción de cadena de conexión URI compressors.

zlibCompressionLevel

Un número entero que especifica el nivel de compresión si se utiliza zlib para network compression.

Puede especificar un valor entero con un rango de -1 a 9:

Valor	notas
`-1`	Nivel de compresión por defecto, generalmente compresión de nivel `6`.
`0`	Sin compresión
`1` - `9`	Aumento del nivel de compresión, pero a expensas del costo de la velocidad, con: `1` proporcionando la mejor velocidad pero la menor compresión, y `9` y ofrece la mejor compresión, pero a la velocidad más lenta.

Respaldado por mongosh.

Opciones del pool de conexiones

La mayoría de los drivers implementan algún tipo de manejo de pool de conexiones. Algunos controladores no son compatibles con los pools de conexiones. Consulte la documentación de su driver para obtener más información sobre la implementación del agrupamiento de conexiones. Estas opciones permiten a las aplicaciones configurar el pool de conexiones al conectarse a la implementación de MongoDB.

Opción de conexión	Descripción
`maxPoolSize`	La cantidad máxima de conexiones en el pool de conexiones. El valor por defecto es `100`.
`minPoolSize`	La cantidad mínima de conexiones en el pool de conexiones. El valor por defecto es `0`. La opción `minPoolSize` no es compatible con todos los controladores. Para obtener información sobre su controlador, consulte la documentación de drivers.
`maxConnecting`	Número máximo de conexiones que un pool puede estar estableciendo concurrentemente. El valor por defecto es `2`. `maxConnecting` es compatible con todos los drivers excepto el driver de Rust. Incrementar el valor de `maxConnecting` permite al cliente establecer la conexión con el servidor más rápidamente, pero aumenta la posibilidad de que se produzcan tormentas de conexión. Si el valor de `maxConnecting` es demasiado bajo, su pool de conexiones puede experimentar una fuerte limitación y un aumento de la latencia de cola para los clientes que verifican las conexiones.
`maxIdleTimeMS`	El número máximo de milisegundos que una conexión puede permanecer inactiva en el pool antes de ser eliminada y cerrada. Esta opción no es compatible con todos los controladores.
`waitQueueMultiple`	Un número que el controlador multiplica por el valor de `maxPoolSize` para proporcionar el número máximo de subprocesos permitidos para esperar a que una conexión esté disponible desde el pool. Para los valores por defecto, consulte la documentación del driver. Esta opción no es compatible con todos los controladores.
`waitQueueTimeoutMS`	El tiempo máximo en milisegundos que un hilo puede esperar para que una conexión esté disponible. Para conocer los valores por defecto, consulte la documentación del driver. Esta opción no es compatible con todos los controladores.

Opciones de nivel de confirmación de escritura

El nivel de confirmación de escritura describe el nivel de reconocimiento solicitado a MongoDB. La opción de nivel de confirmación de escritura es compatible con:

Puedes especificar el nivel de confirmación de escritura tanto en la cadena de conexión como como parámetro para métodos como insert o update. Si se especifica el nivel de confirmación de escritura en ambos lugares, el parámetro del método anula la configuración de la cadena de conexión.

Las cadenas de conexión de implementación de MongoDB Atlas utilizan "majority" de forma predeterminada. Si no especificas el nivel de confirmación de escritura para una implementación de MongoDB Atlas, este aplica"majority".

La siguiente cadena de conexión a un set de réplicas especifica un nivel de confirmación de escritura "majority" y un tiempo de espera de 5 segundos utilizando el parámetro de nivel de confirmación de escritura wtimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&w=majority&wtimeoutMS=5000

Opción de conexión	Descripción
`w`	Corresponde a la opción`w` del nivel de confirmación de escritura. La opción `w` solicita confirmación de que la operación de escritura se ha propagado a un número especificado de instancias `mongod` o a instancias `mongod` con etiquetas especificadas. Puede especificar un `number`, el string `majority` o un `tag set`. Para más detalles, consulte `w` Option.
`wtimeoutMS`	IMPORTANTE: La opción `wtimeoutMS` está en desuso. Configure `timeoutMS` en su lugar. `timeoutMS` anula `wtimeoutMS`. Corresponde al nivel de confirmación de escritura `wtimeout`. `wtimeoutMS` especifica un límite de tiempo, en milisegundos, para el nivel de confirmación de escritura. Cuando `wtimeoutMS` es `0`, las operaciones de guardado nunca agotan el tiempo de espera. Para obtener más información, consulta `wtimeout`.
`journal`	Corresponde a la `j` opción de nivel de confirmación de escritura. La opción `journal` solicita a MongoDB que confirme que la operación de escritura se guardó en el registro en la bitácora. Para obtener más detalles, consulta `j` Opción. Si establece `journal` en `true` y especifica un valor de `w` menor que 1, prevalece `journal`.

Para obtener más información, consulte el nivel de confirmación de escritura.

Opciones de readConcern

Para el motor de almacenamiento WiredTiger, MongoDB introduce la opción readConcern para sets de réplicas y particiones de sets de réplicas.

El nivel de consistencia de lectura permite a los clientes elegir un nivel de aislamiento para sus lecturas de sets de réplicas.

La siguiente cadena de conexión a un set de réplicas especifica readConcernLevel=majority:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readConcernLevel=majority

Opción de conexión	Descripción
`readConcernLevel`	El nivel de aislamiento. Puede aceptar uno de los siguientes valores: `local` `majority` `linearizable` `available` Esta opción de cadena de conexión no está disponible para `mongosh`. Especifique el nivel de consistencia de lectura como una opción para la Operación específica.

Para obtener más información, consulta el nivel de consistencia de lectura.

Opciones de preferencia de lectura

Las preferencias de lectura describen el comportamiento de las operaciones de lectura con respecto a los sets de réplicas. Estos parámetros le permiten especificar preferencias de lectura por conexión en la cadena de conexión.

Por ejemplo:

La siguiente cadena de conexión a un set de réplicas especifica el modo de preferencia de lectura secondary y un valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readPreference=secondary&maxStalenessSeconds=120
```
La siguiente cadena de conexión a un clúster particionado especifica el modo de secondary preferencia de lectura y un valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&maxStalenessSeconds=120
```
La siguiente cadena de conexión a un clúster particionado especifica el modo de preferencia de lectura secondary, así como tres readPreferenceTags:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=dc:ny&readPreferenceTags=
```

El orden importa al usar múltiples readPreferenceTags. Las readPreferenceTags se prueban en orden hasta que se encuentra una coincidencia. Una vez encontrada, esa especificación se utiliza para encontrar todos los nodos elegibles coincidentes y se ignoran los readPreferenceTags restantes. Para obtener más detalles, consulte el Orden de coincidencia de etiquetas.

Opción de conexión	Descripción
`readPreference`	Especifica las preferencias de lectura para esta conexión. Los valores posibles son: `primary` (por defecto) `primaryPreferred` `secondary` `secondaryPreferred` `nearest` Las transacciones que contienen operaciones de lectura deben usar la preferencia de `primary` lectura. Todas las operaciones de una transacción deben dirigirse al mismo miembro. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Consulte `cursor.readPref()` y `Mongo.setReadPref()` en su lugar.
`maxStalenessSeconds`	Especifica, en segundos, cuán obsoleto puede estar un secundario antes de que el cliente deje de usarlo para operaciones de lectura. Para obtener más información, consulte Preferencia de Lectura `maxStalenessSeconds`. Por defecto, no hay un límite máximo de antigüedad y los clientes no consideran la demora de un secundario al elegir dónde dirigir una operación de lectura. El valor mínimo de `maxStalenessSeconds` es 90 segundos. Especificar un valor entre 0 y 90 segundos genera un error. Los controladores de MongoDB tratan un valor `maxStalenessSeconds` de `-1` como "sin obsolescencia máxima", igual que si se omite `maxStalenessSeconds`.
`readPreferenceTags`	Especifica el documento de etiquetas como una lista de pares clave-valor separados por comas y separados por dos puntos. Por ejemplo, Para especificar el documento de etiquetas `{ "dc": "ny", "rack": "r1" }`, utilice `readPreferenceTags=dc:ny,rack:r1` en la cadena de conexión. Para especificar un documento de etiquetas vacío `{ }`, utilice `readPreferenceTags=` sin asignar un valor. Para especificar una lista de documentos de etiquetas, utiliza múltiples `readPreferenceTags`. Por ejemplo, `readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=`. El orden importa al usar múltiples `readPreferenceTags`. Las `readPreferenceTags` se prueban en orden hasta que se encuentre una coincidencia. Para obtener más detalles, consulte el Orden de coincidencia de etiquetas. Esta opción de cadena de conexión no está disponible para el shell `mongo`. Consulte `cursor.readPref()` y `Mongo.setReadPref()` en su lugar.

Para obtener más información, consulte las Preferencias de lectura.

Opciones de autenticación

La siguiente cadena de conexión a un set de réplicas especifica el authSource a la base de datos admin. Es decir, las credenciales del usuario se autentican en la base de datos admin.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?replicaSet=myRepl&authSource=admin

Si el nombre de usuario o la contraseña incluyen los siguientes caracteres, dichos caracteres deben convertirse utilizando codificación de porcentaje:

$ : / ? # [ ] @

Opción de conexión	Descripción
`authSource`	Especifica el nombre de la base de datos asociado a las credenciales del usuario. Si `authSource` no está especificado, `authSource` se asigna por defecto a la cadena de conexión `defaultauthdb` especificada. Si `defaultauthdb` no está especificado, entonces `authSource` se establece por defecto en `admin`. Los mecanismos de autenticación `PLAIN` (LDAP), `GSSAPI` (Kerberos) y `MONGODB-AWS` (IAM) requieren que `authSource` se establezca en `$external`, ya que estos mecanismos delegan el almacenamiento de credenciales a servicios externos. MongoDB ignora los valores de `authSource` si no se proporciona un nombre de usuario, ya sea en la cadena de conexión o mediante el parámetro `--username`.
`authMechanism` Por defecto: SCRAM-SHA-256	Especifique el mecanismo de autenticación que utiliza MongoDB para autenticar la conexión. Si no especifica un `authMechanism` pero proporciona las credenciales de usuario, MongoDB intenta utilizar SCRAM-SHA-256. Si esto falla, se recurre a SCRAM-SHA-1. SCRAM-SHA-1 SCRAM-SHA-256 MONGODB-X509 `MONGODB-AWS` GSSAPI (Kerberos) PLAIN (SASL LDAP) `MONGODB-OIDC` (OpenID Connect OIDC). Para utilizar `MONGODB-OIDC`, debe: Configure la variable `authMechanismProperties` `ENVIRONMENT`. Proporcione una función de retorno de OIDC al constructor del cliente. Solo las instancias de MongoDB Enterprise`mongod` y `mongos` proporcionan los mecanismos `GSSAPI` (Kerberos) y `PLAIN` (LDAP). Para usar `MONGODB-X509`, debe tener el TLS/SSL activado. Para utilizar `MONGODB-AWS`, debe estar conectado a un clúster de MongoDB Atlas que haya sido configurado para admitir la autenticación mediante credenciales de AWS IAM (un ID de clave de acceso de AWS y una clave de acceso secreta, y opcionalmente un token de sesión de AWS). El mecanismo de autenticación `MONGODB-AWS` requiere que el `authSource` esté configurado en `$external`. Si el ID de clave de acceso de AWS, la clave de acceso secreta o el token de sesión están definidos en su plataforma mediante sus respectivas variables de entorno de AWS IAM, `mongosh` utiliza estos valores de variables de entorno para autenticarse automáticamente. No necesita especificarlos en la cadena de conexión. Existen otros métodos para proporcionar las credenciales de AWS dependiendo de su entorno de implementación y los requisitos de seguridad. Para ver un ejemplo del uso del `MONGODB-AWS` mecanismo de autenticación, consulte Cadenas de conexión. Consulte Autenticación en implementaciones autogestionadas para obtener más información sobre el sistema de autenticación en MongoDB. Considere también usar X.509 para autenticar clientes en MongoDB autogestionado para obtener más información sobre la autenticación x509.
`authMechanismProperties`	Especifica las propiedades para el `authMechanism` como una lista separada por comas de pares clave-valor separados por dos puntos. Los posibles pares clave-valor son: `SERVICE_NAME:<string>` Se debe establecer el nombre del servicio Kerberos al realizar la conexión a instancias de MongoDB con Kerberos. Este valor debe coincidir con el nombre del servicio establecido en las instancias de MongoDB a las que se está realizando la conexión. Válido solo cuando se utiliza el mecanismo de autenticación GSSAPI. `SERVICE_NAME` se establece por defecto en `mongodb` para todos los clientes y las instancias de MongoDB. Si cambia la configuración `saslServiceName` en una instancia de MongoDB, debe configurar `SERVICE_NAME` para que coincida con esa configuración. Solo es válido cuando se utiliza el mecanismo de autenticación GSSAPI. `CANONICALIZE_HOST_NAME:true\|false` Canonice el nombre de host de la máquina host del cliente al conectarse al servidor Kerberos. Esto puede ser necesario cuando los hosts informen de nombres de host diferentes a los que figuran en la base de datos de Kerberos. Se establece por defecto en `false`. Solo es válido cuando se utiliza el mecanismo de autenticación GSSAPI. `SERVICE_REALM:<string>` Establezca el realm de Kerberos para el servicio de MongoDB. Esto puede ser necesario para dar soporte a la autenticación entre realms donde el usuario existe en un realm y el servicio en otro. Solo válido cuando se utiliza el mecanismo de autenticación GSSAPI. `AWS_SESSION_TOKEN:<security_token>` Configure el token de sesión de AWS para la autenticación con credenciales temporales al usar una solicitud AssumeRole o al trabajar con recursos de AWS que especifiquen este valor, como Lambda. Solo es válido al usar el `MONGODB-AWS` mecanismo de autenticación. Debe tener un ID de clave de acceso de AWS y una clave de acceso secreta. Para ver ejemplos de uso, consulte Cadenas de conexión. `ENVIRONMENT:<string>` Configure el entorno de OpenID Connect (OIDC). Para: Microsoft Azure, establece `ENVIRONMENT:azure` Google Cloud Platform, establecer `ENVIRONMENT:gcp` También debe establecer `authMechanism` en `MONGODB-OIDC`.
`gssapiServiceName`	Establezca el nombre del servicio Kerberos al conectarse a instancias de MongoDB con Kerberos. Este valor debe coincidir con el nombre del servicio establecido en las instancias de MongoDB a las que se está conectando. `gssapiServiceName` tiene por defecto `mongodb` para todos los clientes e instancias de MongoDB. Si cambia la configuración `saslServiceName` en una instancia de MongoDB, debe establecer `gssapiServiceName` para que coincida con esa configuración. `gssapiServiceName` es un alias obsoleto para `authMechanismProperties=SERVICE_NAME:mongodb`. Para obtener más información sobre qué opciones soporta su controlador y su prioridad relativa entre ellas, consulte la documentación de la versión de controlador que prefiera.

Opciones de selección y descubrimiento de servidores

MongoDB ofrece las siguientes opciones para configurar cómo los controladores de MongoDB y las instancias de mongos seleccionan un servidor al que dirigir las operaciones de lectura o guardado.

Opción de conexión	Descripción
`localThresholdMS`	El tamaño (en milisegundos) de la ventana de latencia para seleccionar entre múltiples instancias adecuadas de MongoDB. Por defecto: 15 milisegundos. Todos los conductores usan `localThresholdMS`. Utilice el alias `localThreshold` al especificar el tamaño de la ventana de latencia para `mongos`.
`serverSelectionTimeoutMS`	Especifica cuánto tiempo (en milisegundos) se debe bloquear para la selección del servidor antes de lanzar una excepción. Por defecto: 30.000 milisegundos.
`serverSelectionTryOnce`	Solo controladores de un solo subproceso. Cuando sea `true`, instruya al driver para que escanee la implementación de MongoDB exactamente una vez después de que falle la selección del servidor y luego seleccione un servidor o genere un error. Cuando sea `false`, el driver bloquea y busca un servidor hasta el valor de `serverSelectionTimeoutMS`. Por defecto: `true`. Los controladores multiprocesos y `mongos` no ofrecen soporte para `serverSelectionTryOnce`.
`heartbeatFrequencyMS`	`heartbeatFrequencyMS` controla cuándo el controlador verifica el estado de la implementación de MongoDB. Especifique el intervalo (en milisegundos) entre las comprobaciones, contado desde el final de la comprobación anterior hasta el comienzo de la siguiente. Por defecto: Drivers de un solo subproceso: 60 segundos. Controladores multiproceso: 10 segundos. `mongos` no tiene soporte para cambiar la frecuencia de las comprobaciones de señales de latido.
`socketCheckIntervalMS`	Solo clientes de un solo subproceso. Controla con qué frecuencia el cliente verifica el estado de la conexión TCP a la implementación de MongoDB. Si se especifica un valor más bajo, el cliente detecta los problemas de red más rápidamente, pero utiliza más CPU. Por defecto: 5 segundos. Esta opción no es compatible con todos los drivers. Consulte la documentación de los drivers.

Varias configuraciones

Opción de conexión	Descripción
`appName`	Especifique un nombre personalizado de la aplicación. El nombre de la aplicación aparece en: Registros `mongod` y `mongos` el campo `currentOp.appName` en el comando `currentOp` y la salida del método `db.currentOp()` el campo `system.profile.appName` en la salida del perfilador de la base de datos La opción de conexión `appName` está disponible para: Controladores de MongoDB `mongosh` comenzando en `mongosh` 1.1.9 MongoDB Compass a partir de Compass 1.28.4
`retryReads`	Permite lecturas reintentables. Los valores posibles son: `true`Habilita las lecturas reintentables para la conexión. Los controladores oficiales de MongoDB tienen por defecto `true`. `false`Deshabilita las lecturas reintentables para la conexión. `mongosh` no admite lecturas reintentables.
`retryWrites`	Active escrituras reintentables. Los valores posibles son: `true`Permite las escrituras reintentables para la conexión. Los controladores oficiales de MongoDB tienen por defecto `true`. `false`Deshabilita las escrituras reintentables para la conexión. Los controladores de MongoDB reintentan las operaciones de confirmación y aborto de las transacciones independientemente del valor de `retryWrites`. Para obtener más información sobre la reintentabilidad de transacciones, consulte el Manejo de errores de las transacciones.
`uuidRepresentation`	Los valores posibles son: `standard` La representación binaria estándar. `csharpLegacy` La representación por defecto para el controlador de C#. `javaLegacy` La representación por defecto para el controlador de Java. `pythonLegacy` La representación por defecto para el controlador de Python. Para conocer la configuración por defecto, consulte la documentación de su driver. No todos los controladores ofrecen soporte para la opción `uuidRepresentation`. Para obtener información sobre su driver, consulte la documentación de los drivers.
`loadBalanced`	Especifica si el cliente se está conectando a un balanceador de carga. Esta opción es `false` por defecto. Puede establecer esta opción en `true` solo si cumple con los siguientes requisitos: Especifica solo un nombre de host. No se está conectando a un set de réplicas. La opción `srvMaxHosts` no está establecida o tiene un valor de `0`. La opción `directConnection` no está establecida o tiene un valor de `false`.
`srvMaxHosts`	Especifica el número de conexiones de `mongos` que pueden crearse para topologías particionadas. Establezca esta opción en un número entero no negativo. `0` es el valor por defecto y significa que no hay límite para la cantidad de conexiones de `mongos`.

Volver

Cadenas de conexión

Formats