Docs Menu
Docs Home
/ /
Conectar

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

entero

Especifica la cantidad máxima de tiempo, en milisegundos, que un hilo puede esperar hasta que una conexión esté disponible.

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 el Lacadena 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

entero

Especifica el tiempo máximo, en milisegundos, que el controlador de Kotlin esperará para enviar o recibir una solicitud antes de agotar el tiempo de espera. Un valor de 0 indica al controlador 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.

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 para la opción w.

Default: 1

tiempo de espera MS

entero

Especifica un límite de tiempo, en milisegundos, para la operación de escritura. Para obtener 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

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

Conéctese a MongoDB