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 un momento dado en un único pool 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. El tiempo máximo de espera en milisegundos que una operación puede esperar para que una conexión esté disponible. Un valor de Default: 120000 (120 seconds) |
serverSelectionTimeoutMS | entero | Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador esperará a que se complete la selección del servidor antes de lanzar 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 driver intenta encontrar a todos los nodos 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 utilizar TLS. Sustituye la opción ssl. Default: false |
tlsInsecure | booleano | Especifica que el driver debe permitir nombres de host no válidos para las conexiones TLS. Tiene el mismo efecto que establecer tlsAllowInvalidHostnames en Default: false |
tlsAllowInvalidHostnames | 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 la cantidad máxima de tiempo, en milisegundos, que el driver de Kotlin espera para que se abra una conexión antes de que se agote el tiempo de espera. Un valor de Default: 10000 (10 seconds) |
socketTimeoutMS (deprecated) | entero | Esta opción está obsoleta. Puedes configurar este tiempo de espera estableciendo el tiempo de espera a nivel de cliente en su lugar. 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 Default: 0 |
maxIdleTimeMS | entero | Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador permite que una conexión agrupada permanezca inactiva antes de cerrarla. Un valor de Configure este valor más alto que el período de inactividad esperado de su aplicación, pero menor que los tiempos de espera de conexión del firewall o del proxy para evitar desconexiones inesperadas. Default: 0 |
maxLifeTimeMS | entero | Especifica el tiempo máximo, en milisegundos, que el controlador Kotlin continuará usando una conexión agrupada antes de cerrarla. Un valor de Default: 0 |
journal | booleano | Especifica que el driver debe esperar a que la instancia conectada de MongoDB agrupe los commit en el archivo de registro en disco para todos los guardados. Default: false |
w | string o número entero | Especifica el nivel de confirmación de escritura (write concern). Para obtener más información sobre los valores, consulte la documentación del servidor para el con la opción w. Default: 1 |
tiempo de espera MS (deprecated) | entero | Esta opción está obsoleta. Puedes configurar este tiempo de espera estableciendo el tiempo de espera a nivel de cliente en su lugar. Límite de tiempo, en milisegundos, para el nivel de confirmación de escritura (write concern). Para más información, consulta la documentación del servidor sobre la opción wtimeoutMS. Un valor de Default: 0 |
readPreference | string | Especifica la preferencia de lectura. Para obtener más información sobre los valores, consulta 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 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 |
authMechanismProperties | 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 apretón de manos de conexión. Se puede utilizar para los registros de servidor y la elaboración de perfiles. Default: null |
compresores | string | Especifica uno o varios algoritmos de compresión que el driver intentará unir para comprimir las solicitudes enviadas a la instancia conectada de MongoDB. Los valores posibles incluyen: Default: null |
zlibCompressionLevel | entero | Especifica el grado de compresión que Zlib debe utilizar para reducir el tamaño de las solicitudes a la instancia conectada de MongoDB. El nivel puede ir de Default: null |
retryWrites | booleano | Especifica que el controlador debe reintentar 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 qué protocolo de supervisión del servidor usa el driver. Cuando se ajusta a Default: auto |
Representación uuid | string | Especifica la representación de UUID que se usará para las operaciones de lectura y escritura. Para más información, consulta la documentación del driver para el método MongoClientSettings.getUuidRepresentation(). Default: unspecified |
directConnection | booleano | Especifica que el driver 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.