Docs Menu
Docs Home
/ /
/ / /

Opciones de conexión

Esta sección explica las opciones de conexión y autenticación de MongoDB compatibles con el controlador. Puede pasar las opciones de conexión como parámetros de la URI de conexión para especificar el comportamiento del cliente.

Nombre de la opción
Tipo
Descripción

minPoolSize

entero

Especifica el número mínimo de conexiones que deben existir en cualquier momento en un solo grupo de conexiones.

Default: 0

maxPoolSize

entero

Especifica el número máximo de conexiones que un grupo de conexiones puede tener en un momento determinado.

Default: 100

waitQueueTimeoutMS (deprecated)

entero

Esta opción está obsoleta. Puede configurar este tiempo de espera configurando el tiempo de espera a nivel de cliente en su lugar.

Tiempo máximo de espera en milisegundos que una operación puede esperar hasta que una conexión esté disponible. Un valor de 0 significa que no hay límite.

Default: 120000 (120 seconds)

Tiempo de espera de selección del servidor MS

entero

Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador esperará a que la selección del servidor tenga éxito antes de generar una excepción.

Default: 30000 (30 seconds)

localThresholdMS

entero

Al comunicarse con varias instancias de MongoDB en un conjunto de réplicas, el controlador solo enviará solicitudes a un servidor cuyo tiempo de respuesta sea menor o igual al servidor con el tiempo de respuesta más rápido más el umbral local, en milisegundos.

Default: 15

heartbeatFrequencyMS

entero

Especifica la frecuencia, en milisegundos, que el controlador esperará entre intentos para determinar el estado actual de cada servidor en el clúster.

Default: 10000 (10 seconds)

replicaSet

string

Especifica que la cadena de conexión proporcionada incluye varios hosts. Cuando se especifica, el controlador intenta encontrar todos los miembros de ese conjunto.

Default: null

ssl

booleano

Especifica que todas las comunicaciones con instancias de MongoDB deben usar TLS/SSL. Reemplazado por la opción tls.

Default: false

tls

booleano

Especifica que toda la comunicación con las instancias de MongoDB debe usar TLS. Reemplaza la opción SSL.

Default: false

tlsInsecure

booleano

Especifica que el controlador debe permitir nombres de host no válidos para las conexiones TLS. Tiene el mismo efecto que establecer tlsAllowInvalidHostnames trueen. Para configurar las restricciones de seguridad TLS de otras maneras, utilice un SSLContext personalizado.

Default: false

tlsPermitir nombres de host no válidos

booleano

Especifica que el controlador debe permitir nombres de host no válidos en el certificado para conexiones TLS. Reemplaza sslInvalidHostNameAllowed.

Default: false

connectTimeoutMS

entero

Especifica el tiempo máximo, en milisegundos, que el controlador Kotlin espera a que se abra una conexión antes de agotar el tiempo de espera. Un valor de 0 indica al controlador que nunca agote el tiempo de espera mientras espera a que se abra una conexión.

Default: 10000 (10 seconds)

socketTimeoutMS (deprecated)

entero

Esta opción está obsoleta. Puede configurar este tiempo de espera estableciendo el tiempo de espera a nivel de cliente.

La cantidad máxima de tiempo, en milisegundos, que el driver de Kotlin esperará para enviar o recibir una solicitud antes de que se agote el tiempo de espera. Un valor de 0 indica al driver que nunca agote el tiempo de espera mientras espera enviar o recibir una solicitud.

Default: 0

maxIdleTimeMS

entero

Especifica el tiempo máximo en milisegundos que el controlador permite que una conexión agrupada permanezca inactiva antes de cerrarla. Un valor de 0 indica que no hay límite superior para el tiempo que el controlador permite que una conexión agrupada permanezca inactiva.

Establezca este valor en un valor más alto que el período de inactividad esperado de su aplicación, pero en un valor más bajo que los tiempos de espera de conexión del firewall o proxy para evitar desconexiones inesperadas.

Default: 0

Tiempo de vida máximo MS

entero

Especifica el tiempo máximo, en milisegundos, que el controlador Kotlin continuará usando una conexión agrupada antes de cerrarla. Un valor de 0 indica que no hay límite superior para el tiempo que el controlador puede mantener abierta una conexión agrupada.

Default: 0

journal

booleano

Especifica que el controlador debe esperar a que la instancia MongoDB conectada realice la confirmación agrupada en el archivo de diario en el disco para todas las escrituras.

Default: false

w

cadena o entero

Especifica el problema de escritura. Para obtener más información sobre los valores, consulte la documentación del servidor. opción w.

Default: 1

tiempo de espera MS (deprecated)

entero

Esta opción está obsoleta. Puede configurar este tiempo de espera estableciendo el tiempo de espera a nivel de cliente.

Límite de tiempo, en milisegundos, para la operación de escritura. Para más información, consulte la documentación del servidor para la opción wtimeoutMS. Un valor de 0 indica al controlador que nunca agote el tiempo de espera de las operaciones de escritura.

Default: 0

readPreference

string

Especifica la preferencia de lectura. Para obtener más información sobre los valores, consulte la documentación del servidor para la opción readPreference.

Default: primary

readPreferenceTags

string

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

Default: null

maxStalenessSeconds

entero

Especifica, en segundos, cuán obsoleto puede estar un nodo secundario antes de que el controlador deje de comunicarse con ese nodo secundario. El valor mínimo es 90 segundos o la frecuencia de latidos más 10 segundos, lo que sea mayor. Para obtener más información, consulta la documentación del servidor sobre la opción maxStalenessSeconds. No proporcionar un parámetro o especificar explícitamente -1 indica que no debe haber verificación de obsolescencia para las secundarias.

Default: -1

mecanismo de autenticación

string

Especifica el mecanismo de autenticación que debe utilizar el controlador si se proporcionó una credencial.

Default: By default, the client picks the most secure mechanism available based on the server version. For possible values, see the server documentation for the authMechanism option.

authSource

string

Especifica la base de datos contra la cual deben validarse las credenciales suministradas.

Default: admin

Propiedades del mecanismo de autenticación

string

Especifica las propiedades de autenticación del mecanismo de autenticación especificado como una lista de propiedades y valores separados por dos puntos. Para obtener más información, consulte la documentación del servidor para la opción authMechanismProperties.

Default: null

appName

string

Especifica el nombre de la aplicación proporcionada a las instancias de MongoDB durante el protocolo de enlace de conexión. Puede usarse para registros del servidor y generación de perfiles.

Default: null

compresores

string

Especifica uno o más algoritmos de compresión que el controlador intentará usar para comprimir las solicitudes enviadas a la instancia de MongoDB conectada. Los valores posibles son: zlib, snappy y zstd.

Default: null

zlibCompressionLevel

entero

Especifica el grado de compresión que Zlib debe usar para reducir el tamaño de las solicitudes a la instancia de MongoDB conectada. El nivel puede variar de -1 a; los 9 valores más bajos comprimen más rápido (pero generan solicitudes más grandes) y los valores más altos comprimen más lento (pero generan solicitudes más pequeñas).

Default: null

retryWrites

booleano

Especifica que el controlador debe volver a intentar las operaciones de escritura admitidas si fallan debido a un error de red.

Default: true

retryReads

booleano

Especifica que el controlador debe reintentar las operaciones de lectura compatibles que fallan debido a un error de red.

Default: true

serverMonitoringMode

string

Especifica el protocolo de monitorización de servidor que utiliza el controlador. Cuando se establece en auto, el modo de monitorización se determina según el entorno en el que se ejecuta el controlador. El controlador utiliza el modo poll en entornos de función como servicio (FaaS) y el modo stream en otros entornos.

Default: auto

Representación uuid

string

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

Default: unspecified

directConnection

booleano

Especifica que el controlador debe conectarse directamente al host.

Default: false

maxConnecting

entero

Especifica el número máximo de conexiones que un pool puede establecer simultáneamente.

Default: 2

srvServiceName

string

Especifica el nombre de servicio de los registros de recursos SRV que el controlador recupera para construir la lista de semillas. Para usar esta opción, debe usar el formato de conexión de la lista de semillas DNS en la URI de conexión.

Default: mongodb

Para obtener una lista completa de opciones, consulte la página de referencia de la API de ConnectionString.

Volver

Elija un destino de conexión