Opciones de conexión

Overview

En esta guía, aprenderá sobre las opciones de conexión y autenticación de MongoDB. Puede configurar las opciones de conexión como parámetros de su cadena de conexión para especificar cómo... Client La instancia se comporta mientras está conectada al servidor.

Nombre de la opción	Valores permitidos	Valor por defecto	Descripción
appName	String	Ninguno	Specifies the application name that the `Client` instance sends to the server as part of the handshake. Specifying an `appName` can help you use the server logs to determine which `Client` instance is connected to the server.
mecanismo de autenticación	String	Ninguno	Especifica el mecanismo de autenticación que se utilizará. Si no se especifica esta opción, el controlador utiliza el mecanismo de autenticación predeterminado. Para obtener más información sobre la autenticación en el controlador de Rust, consulte la guía sobre Mecanismos de autenticación.
Propiedades del mecanismo de autenticación	String	Ninguno	Especifica más propiedades para el mecanismo de autenticación establecido en la opción `authMechanism`.
authSource	String	Ver descripción	Specifies the database used to authenticate. This option defaults to `admin` for SCRAM-based authentication mechanisms, `$external` for the `MONGODB-X509` mechanism, and the database name or `$external` for the `PLAIN` mechanism.
compresores	Una lista de cadenas separadas por comas	Ninguno	Especifica los compresores que la `Client` instancia utiliza en el orden especificado. Para obtener más información sobre la compresión de red, consulte la guía de 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 cuando intenta conectarse al servidor.
directConnection	Booleano	`false`	Especifica si la instancia `Client` se conecta directamente a un solo host en lugar 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 monitoreo espera entre la realización de comprobaciones del servidor.
journal	Booleano	`false`	Solicita reconocimiento de que la operación se propagó al diario en disco.
localThresholdMS	Non-negative integer	15	Specifies the amount of time in milliseconds that the average round-trip time between the driver and server can last compared to the shortest round-trip time of all the suitable servers. A value of `0` indicates that there is no latency window, so only the server with the lowest average round-trip time is eligible.
maxIdleTimeMS	Non-negative integer	0	Specifies the amount of time in milliseconds that a connection can remain idle in a connection pool the server closes it. A value of `0` indicates that the client does not close idle connections.
maxStalenessSeconds	`-1`, o cualquier número entero mayor o igual a `90`	`-1`	Specifies the maximum lag, in seconds, behind the primary node that a secondary node can be to be considered for the given operation. The value of this option must be at least `90`, or the operation raises an error. A value of `-1` means there is no maximum lag.
maxPoolSize	Non-negative integer	`10`	Specifies the maximum number of connections that the `Client` instance can create in a connection pool for a given server. If you attempt an operation while the value of `maxPoolSize` connections are checked out, the operation waits until an in-progress operation finishes and the connection returns to the pool.
minPoolSize	Non-negative integer	`0`	Specifies the minimum number of connections that are available in a server's connection pool at a given time. If fewer than `minPoolSize` connections are in the pool, the server adds connections in the background up to the value of `minPoolSize`.
readConcernLevel	String	Ninguno	Especifica la preocupación de lectura predeterminada para las operaciones realizadas en la instancia `Client`. Para obtener más información, consulte Lea la preocupación en el manual del servidor.
readPreference	String	`primary`	Especifica cómo el controlador enruta una operación de lectura a los miembros de un conjunto de réplicas. Para obtener más información, consulte Preferencia de lectura en el manual del servidor.
readPreferenceTags	Una lista de pares clave-valor separados por comas	Ninguno	Especifica qué miembros del conjunto de réplicas se consideran para las operaciones. Cada instancia de esta clave constituye un conjunto de etiquetas independiente. El controlador comprueba cada conjunto de etiquetas hasta encontrar uno o más servidores con cada etiqueta en el conjunto.
replicaSet	String	Ninguno	Especifica el nombre del conjunto de réplicas al que se conecta la instancia `Client`.
retryReads	Booleano	`true`	Especifica si el cliente vuelve a intentar una operación de lectura si la operación falla.
Tiempo de espera de selección del servidor MS	Non-negative integer	`30000` (30 segundos)	Especifica la cantidad de tiempo en milisegundos que la instancia `Client` espera cuando intenta seleccionar un servidor para una operación antes de expirar.
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`	Specifies whether the `Client` instance returns an error if the server presents an invalid certificate. We recommend that you set this option to `true` only in testing environments to avoid creating vulnerabilities in your application.
tlsCAFile	String	Ver descripción	Specifies the path to the certificate authority (CA) file that the `Client` instance uses for TLS. If you do not specify this option, the driver uses the Mozilla root certificates from the `webpki-roots` crate.
tlsCertificateKeyFile	String	Ninguno	Specifies the path to the certificate file that the `Client` instance presents to the server to verify its identify. If you do not set this option, the `Client` instance does not attempt to verify its identity to the server.
tlsCertificateKeyFilePassword	String	Ninguno	Especifica la contraseña para descifrar la clave privada en su archivo de certificado, si la clave está cifrada.
tlsInsecure	Booleano	`false`	Specifies whether the `Client` instance returns an error if the server presents an invalid certificate. We recommend that you set this option to `true` only in testing environments to avoid creating vulnerabilities in your application.
w	Entero o cadena no negativo	Ninguno	Requests acknowledgment that the operation has propagated to a specific number or variety of servers. To learn more, see Write Concern in the Server manual.
wTimeoutMS	Non-negative integer	Sin tiempo de espera	Especifica un límite de tiempo, en milisegundos, para la operación de escritura. Si una operación no se propaga al nivel solicitado dentro del límite de tiempo, el controlador genera un error.
zlibCompressionLevel	Entero entre -1 y 9 (inclusive)	`-1`	Specifies the level field of the `zlib` compression if you use that compressor. Setting a value of `-1` selects the default compression level (`6`). Setting a value of `0` specifies no compression, and setting a value of `9` specifies maximum compression. To learn more about network compression, see the Network Compression guide.

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

Volver

Guía de Conexión

Compresión de la red