/ /

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 mongosh se utiliza.
El value siempre distingue entre mayúsculas y minúsculas.

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

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 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 del set de réplicas, si el `mongod` es un nodo de un set de réplicas. Configure la opción de conexión `replicaSet` para asegurar un comportamiento coherente entre los controladores. Al conectarse a un set de réplicas, proporcione una lista de nodos iniciales de los miembros del set de réplicas en el componente `host[:port]`. Consulta la documentación del driver para obtener más detalles.
`directConnection`	Especifica si el cliente se conecta directamente al `host[:port]` en el URI de conexión: `true`: El cliente envía operaciones solo al host especificado y no intenta descubrir otros miembros 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.

Opción de conexión

Descripción

replicaSet

Especifica el nombre del set de réplicas, si el mongod es un nodo de un set de réplicas. Configure la opción de conexión replicaSet para asegurar un comportamiento coherente entre los controladores.

Al conectarse a un set de réplicas, proporcione una lista de nodos iniciales de los miembros del set de réplicas en el componente host[:port]. Consulta la documentación del driver para obtener más detalles.

directConnection

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

true: El cliente envía operaciones solo al host especificado y no intenta descubrir otros miembros 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 conjunto de réplicas incluye la opción. Se autentica tls=true como myDatabaseUser el usuario con la D1fficultP%40ssw0rd contraseña.

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

También puede utilizar la opción ssl=true equivalente:

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 Formato de cadena de conexión estándar. La opción es `tls` equivalente `ssl` a. Si el `mongosh` intérprete de comandos especifica opciones tls/ssl adicionales desde la línea de comandos, utilice la `--tls` opción de línea de comandos en su lugar.
`ssl`	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 Formato de cadena de conexión estándar. La opción es `ssl` `tls` equivalente a la opción. Si el `mongosh` intérprete de comandos especifica opciones tls/ssl adicionales desde la línea de comandos, utilice la `--ssl` opción de línea de comandos 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 `tlsCertificateKeyFile` el. 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`	Especifica la ruta hacia un archivo `.pem` local que contiene la cadena de certificados raíz de la Autoridad Certificadora. El cliente utiliza este archivo 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
`timeoutMS`	Tiempo en milisegundos para intentar una operación antes de que se agote el tiempo de espera. Este tiempo se aplica a todos los pasos de la operación, incluyendo la selección del servidor, la verificación de la conexión y la ejecución en el servidor. `timeoutMS` No tiene un valor predeterminado. Si no especifica un valor, el controlador aplica opciones de tiempo de espera individuales,`socketTimeoutMS` como. Si se establece `timeoutMS` en la cadena de conexión, el controlador ignora las demás opciones de tiempo de espera y este se aplica a todas las operaciones del cliente. Se puede modificar `timeoutMS` a un nivel más específico, pero no se puede eliminar su valor. Para obtener más información sobre la herencia de tiempos de espera, consulte Limitar el tiempo de ejecución del servidor. IMPORTANTE: `timeoutMS` Aún no es compatible con todos los controladores oficiales. Para conocer su disponibilidad, consulte la documentación del controlador.
`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 se agote el tiempo del intento. El valor por defecto es sin tiempo de espera, aunque los drivers pueden variar. Consulta 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 solo cuando ambas partes activan la compresión de red y comparten un compresor común. De lo contrario, los mensajes entre las partes no están comprimidos.

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

zlibCompressionLevel

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

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.

Con el apoyo mongosh de.

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 no es compatible con todos los `minPoolSize` controladores. Para obtener información sobre su controlador, consulte la documentación de controladores.
`maxConnecting`	Número máximo de conexiones que un grupo puede establecer simultáneamente. 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 por el que el controlador multiplica el `maxPoolSize` valor para determinar el número máximo de subprocesos que pueden esperar a que una conexión esté disponible en el grupo. Para conocer los valores predeterminados, consulte la documentación del controlador. 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

Nivel de confirmación de escritura (write concern) describe el nivel de confirmación solicitado a MongoDB. Estas opciones son compatibles con:

Controladores de MongoDB
mongosh
mongofiles
mongoimport
mongorestore

Puedes especificar el nivel de confirmación de escritura (write concern) tanto en la cadena de conexión como en un parámetro para métodos como insert o update. Si se especifica en ambos lugares, el parámetro del método sobrescribe 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 conjunto de réplicas especifica preocupación de escritura y "majority" un 5 tiempo de espera de segundos utilizando el wtimeoutMS parámetro de preocupación de escritura:

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 está obsoleta.`wtimeoutMS` En `timeoutMS` su lugar, utilice. `timeoutMS` `wtimeoutMS`anula. Corresponde a la preocupación de `wtimeout` escritura. especifica un límite de tiempo, en milisegundos, para la preocupación de`wtimeoutMS` 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 opción `j` de confirmación de escritura. La opción solicita a MongoDB que confirme que `journal` la operación de escritura se ha registrado en el diario. Para más detalles, consulte `j` la opción. Si establece `journal` en `true` y especifica un `w` valor menor que,1 `journal` prevalecerá.

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 conjunto de réplicas readConcernLevel=majority especifica:

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. Acepta uno de los siguientes valores: `local` `majority` `linearizable` `available` Esta opción de cadena de conexión no está disponible para. Especifique la preocupación de lectura como `mongosh` 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 conjunto de réplicas especifica el modo de preferencia de lecturasecondaryy un valormaxStalenessSecondsde 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 fragmentado especifica el modo de preferencia de lecturasecondaryy un valormaxStalenessSecondsde 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 fragmentado especifica el modo de preferencia de lectura secondary y readPreferenceTags tres:
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` Transacciones que contienen operaciones de lectura deben utilizar la preferencia de lectura `primary`. Todas las operaciones en una transacción dada deben dirigirse al mismo nodo. 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 `maxStalenessSeconds` valor mínimo es 90 segundos. Especificar un valor entre 0 y 90 segundos produce un error. Los controladores de MongoDB tratan un `maxStalenessSeconds` valor de como "sin límite máximo de `-1` antigüedad", igual que si `maxStalenessSeconds` se omite.
`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 conjunto de réplicas especifica la a authSource la admin base de datos. Es decir, las credenciales del usuario se autentican contra la admin base de datos.

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 incluye los siguientes caracteres, deben convertirse mediante la codificación porcentual:

$ : / ? # [ ] @

Opción de conexión	Descripción
`authSource`	Nombre de la base de datos asociado con las credenciales del usuario. Por defecto es `defaultauthdb` si se especifica, de lo contrario, por defecto es `admin`. Los `PLAIN` `GSSAPI` `MONGODB-AWS` mecanismos, y requieren que se `authSource` establezca `$external` en, ya que delegan el almacenamiento de credenciales a servicios externos. MongoDB ignora si no se proporciona un nombre de usuario en la cadena de conexión o a `authSource` través `--username` de.
`authMechanism` Por defecto: SCRAM-SHA-256	Mecanismo de autenticación para la conexión. Sin un `authMechanism` explícito, MongoDB intenta SCRAM-SHA-256 y recurre a SCRAM-SHA-1 si falla lo anterior. 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: Establece la `authMechanismProperties` `ENVIRONMENT` variable. 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 usar,`MONGODB-AWS` debe conectarse a un clúster de MongoDB Atlas 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 `MONGODB-AWS` mecanismo de autenticación requiere que esté `authSource` configurado `$external` como. Si la 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 es necesario especificarlos en la cadena de conexión. Existen otros métodos para proporcionar credenciales de AWS, según su entorno de implementación y requisitos de seguridad. Para ver un ejemplo de uso del mecanismo de autenticación `MONGODB-AWS`, 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`	Especifique las propiedades para el especificado como una lista de pares clave-valor separados por dos puntos y separados por `authMechanism` comas. 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>` Establezca 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 debes establecer `authMechanism` a.`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` El valor predeterminado de `mongodb` es para todos los clientes e instancias de MongoDB. Si modifica `saslServiceName` la configuración de en una instancia de MongoDB, debe establecer `gssapiServiceName` para que coincida con dicha configuración. `gssapiServiceName` es un alias obsoleto de. Para obtener más información sobre las opciones que admite su controlador y su prioridad relativa, consulte la documentación de la versión de controlador que `authMechanismProperties=SERVICE_NAME:mongodb` 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 controladores usan. Use `localThresholdMS` el `localThreshold` alias cuando especifique el tamaño de la ventana de latencia `mongos` a.
`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`	Controladores de un solo hilo únicamente.`true` Cuando, el controlador escanea la implementación de MongoDB exactamente una vez después de que falla la selección del servidor y luego selecciona un servidor o genera un error.`false` Cuando, el controlador se bloquea y busca un servidor hasta el `serverSelectionTimeoutMS` valor. Valor `true`predeterminado:. Los controladores multihilo y `mongos` no `serverSelectionTryOnce` admiten.
`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 `appName` opción de conexión está disponible para: Controladores de MongoDB `mongosh` comenzando `mongosh` 1 en..19 MongoDB Compass comenzando en Compass..1284
`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 la confirmación de la transacción y abortan las operaciones independientemente del valor `retryWrites`de. Para obtener más información sobre la posibilidad de reintentar las transacciones, consulte el apartado de Gestión de errores de transacción.
`uuidRepresentation`	Los valores posibles son: `standard` La representación binaria estándar. `csharpLegacy` La representación por defecto para el driver de .NET/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 admiten la opción. Para obtener información `uuidRepresentation` sobre su controlador, consulte la documentación del mismo.
`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 no está definida o tiene un `srvMaxHosts` valor `0` de. La opción no está definida o tiene un `directConnection` valor `false` de.
`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