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.
Docs Menu

Opciones de conexión

En esta guía, puedes aprender sobre las opciones de conexión y autenticación de MongoDB. Puedes establecer opciones de conexión como parámetros de tu cadena de conexión para especificar el comportamiento de tu instancia de Client mientras está conectada al servidor.

Nombre de la opción
Valores permitidos
Valor por defecto
Descripción

appName

String

Ninguno

Especifica el nombre de la aplicación que la Client instancia envía al servidor como parte del protocolo de enlace.
Especificar un appName puede ayudarle a utilizar los registros del servidor para determinar qué Client instancia está conectada al servidor.

mecanismo de autenticación

String

Ninguno

Especifica qué mecanismo de autenticación utilizar. Si no especifica esta opción, el driver utilizará el mecanismo de autenticación por defecto. Para obtener más información sobre la autenticación en el driver Rust, consulta la guía sobre mecanismos de autenticación.

authMechanismProperties

String

Ninguno

Especifica más propiedades para el mecanismo de autenticación establecido en la opción authMechanism.

authSource

String

Ver descripción

Especifica la base de datos utilizada para la autenticación.
Esta opción tiene como valor predeterminado admin para los mecanismos de autenticación basados ​​en SCRAM, $external para MONGODB-X509 el mecanismo y el nombre de la base de datos o $external para el PLAIN mecanismo.

compresores

Una lista de cadenas separadas por comas

Ninguno

Especifica los compresores que la instancia Client utiliza en el orden especificado. Para obtener más información sobre la compresión de red, consulta la guía Compresión de red.

connectTimeoutMS

Non-negative integer

10000 (10 segundos)

Especifica el tiempo de espera de conexión, en milisegundos, que se pasa a cada flujo TCP subyacente al intentar conectarse al servidor.

directConnection

Booleano

false

Especifica si la instancia Client se conecta directamente a un solo host en vez de descubrir y conectarse a todos los servidores del clúster.

heartbeatFrequencyMS

entero mayor o igual a 500

10000 (10 segundos)

Especifica la cantidad de tiempo en milisegundos que cada hilo de supervisión espera entre ejecuciones de pruebas al servidor.

journal

Booleano

false

Solicita confirmación de que la operación se propagó al registro en disco.

localThresholdMS

Non-negative integer

15

Especifica la cantidad de tiempo en milisegundos que puede durar el tiempo promedio de ida y vuelta entre el conductor y el servidor, en comparación con el tiempo de ida y vuelta más corto de todos los servidores adecuados.
Un valor de 0 indica que no hay ventana de latencia, por lo que solo el servidor con el menor tiempo promedio de ida y vuelta es elegible.

maxIdleTimeMS

Non-negative integer

0 (no limit)

Especifica el tiempo en milisegundos que una conexión puede permanecer inactiva en un grupo de conexiones antes de que el servidor la cierre.
Un valor de 0 indica que el cliente no cierra las conexiones inactivas. Establezca este valor por encima del período de inactividad previsto para su aplicación, pero por debajo de los tiempos de espera de conexión del firewall o del proxy para evitar desconexiones inesperadas.

maxStalenessSeconds

-1o cualquier número entero mayor o igual a 90

-1

Especifica el retardo máximo, en segundos, que un nodo secundario puede tener con respecto al nodo principal para ser considerado para la operación dada.
El valor de esta opción debe ser al 90 menos, de lo contrario, la operación generará un error. Un valor de -1 significa que no hay retardo máximo.

maxPoolSize

Non-negative integer

10

Especifica el número máximo de conexiones que la Client instancia puede crear en un grupo de conexiones para un servidor determinado.
Si intenta realizar una operación mientras el valor de maxPoolSize conexiones está en uso, la operación espera hasta que finalice una operación en curso y la conexión vuelva al grupo.

minPoolSize

Non-negative integer

0

Especifica el número mínimo de conexiones disponibles en el grupo de conexiones de un servidor en un momento dado.
Si hay menos de minPoolSize conexiones en el grupo, el servidor añade conexiones en segundo plano hasta alcanzar el valor minPoolSize de.

readConcernLevel

String

Ninguno

Especifica el nivel de consistencia de lectura por defecto para las operaciones realizadas en la instancia Client. Para obtener más información, consulta nivel de consistencia de lectura en el manual del servidor.

readPreference

String

primary

Especifica cómo el driver enruta una operación de lectura a los nodos de un conjunto de réplicas. Para aprender más, consulta Preferencia de lectura en el manual del servidor.

readPreferenceTags

Una lista de pares de clave-valor separados por comas

Ninguno

Especifica cuáles miembros del conjunto de réplicas se consideran para las operaciones. Cada instancia de esta clave es un conjunto de etiquetas independiente. El controlador revisa cada conjunto de etiquetas hasta que encuentra uno o más servidores con cada etiqueta en el conjunto.

replicaSet

String

Ninguno

Especifica el nombre del set de réplicas al que se conecta la instancia Client.

retryReads

Booleano

true

Especifica si el cliente reintenta una operación de lectura si la operación falla.

serverSelectionTimeoutMS

Non-negative integer

30000 (30 segundos)

Especifica la cantidad de tiempo en milisegundos que la instancia Client espera al intentar seleccionar un servidor para una operación antes de que se agote el tiempo.

tls

Booleano

false

Especifica la configuración de TLS que la instancia Client debe usar en sus conexiones con el servidor. Por defecto, TLS está desactivado.

tlsPermitirCertificadosInválidos

Booleano

false

Especifica si la Client instancia devuelve un error si el servidor presenta un certificado no válido.
Recomendamos configurar esta opción en true únicamente en entornos de prueba para evitar crear vulnerabilidades en la aplicación.

tlsCAFile

String

Ver descripción

Especifica la ruta al archivo de la autoridad de certificación (CA) que la Client instancia utiliza para TLS.
Si no especifica esta opción, el controlador utiliza los certificados raíz de Mozilla del webpki-roots paquete.

tlsCertificateKeyFile

String

Ninguno

Especifica la ruta al archivo de certificado que la Client instancia presenta al servidor para verificar su identidad.
Si no se configura esta opción, la Client instancia no intentará verificar su identidad ante el servidor.

tlsInsecure

Booleano

false

Especifica si la Client instancia devuelve un error si el servidor presenta un certificado no válido.
Recomendamos configurar esta opción en true únicamente en entornos de prueba para evitar crear vulnerabilidades en la aplicación.

w

Entero no negativo o string

Ninguno

Solicita confirmación de que la operación se ha propagado a un número o variedad específicos de servidores.
Para obtener más información, consulte la sección «Redacción de consultas» en el manual del servidor.

wTimeoutMS

Non-negative integer

Sin límite de tiempo

Especifica un límite de tiempo, en milisegundos, para el nivel de confirmación de escritura (write concern). Si una operación no se ha propagado al nivel solicitado dentro del límite de tiempo, el driver genera un error.

zlibCompressionLevel

Entero entre -1 y 9 (inclusive)

-1

Especifica el nivel de zlib compresión si se utiliza ese compresor.
Si se establece un valor de, se selecciona -1 el nivel de compresión6 predeterminado ().
Si se establece un valor de,0 no se aplica compresión, y si se establece un valor de, se 9 aplica la máxima compresión.
Para obtener más información sobre la compresión de red, consulte la guía de compresión de red.

Para ver una lista completa de opciones de conexión, visita la sección de Opciones de cadena de conexión de la entrada del manual del servidor sobre cadenas de conexión.