Esta sección explica las opciones de conexión y autenticación compatibles con el driver de MongoDB. Puedes 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. Por defecto: |
maxPoolSize | entero | Especifica el número máximo de conexiones que un pool de conexiones puede tener en un momento dado. Por defecto: |
waitQueueTimeoutMS (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. El tiempo máximo de espera en milisegundos que una operación puede esperar para que una conexión esté disponible. Un valor de Por defecto: |
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. Por defecto: |
localThresholdMS | entero | Al comunicarse con varias instancias de MongoDB en un set de réplicas, el driver solo enviará solicitudes a un servidor cuyo tiempo de respuesta sea menor o igual a la del servidor con el tiempo de respuesta más rápido, más el umbral local, en milisegundos. Por defecto: |
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. Por defecto: |
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. Por defecto: |
ssl | booleano | Especifica que todas las comunicaciones con instancias de MongoDB deben usar TLS/SSL. Reemplazado por la opción tls. Por defecto: |
tls | booleano | Especifica que toda la comunicación con las instancias de MongoDB debe utilizar TLS. Sustituye la opción ssl. Por defecto: |
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 Por defecto: |
tlsAllowInvalidHostnames | booleano | Especifica que el controlador debe permitir nombres de host inválidos en el certificado para las conexiones TLS. Supera sslInvalidHostNameAllowed. Por defecto: |
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 Por defecto: |
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 Por defecto: |
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. Por defecto: |
maxLifeTimeMS | entero | Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador Kotlin seguirá usando una conexión del pool antes de cerrarla. Un valor de Por defecto: |
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. Por defecto: |
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, consulta la documentación del servidor para la opción w. Por defecto: |
wtimeoutMS (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 Por defecto: |
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. Por defecto: |
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. Por defecto: |
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 Por defecto: |
mecanismo de autenticación | string | Especifica el mecanismo de autenticación que el controlador debe utilizar si se proporcionó una credencial. Por defecto: Por defecto, el cliente selecciona el mecanismo más seguro disponible en función de la versión del servidor. Para obtener los valores posibles, consulta la documentación del servidor para la opción authMechanism. |
authSource | string | Especifica la base de datos contra la cual deben validarse las credenciales suministradas. Por defecto: |
authMechanismProperties | string | Especifica las propiedades de autenticación para el mecanismo de autenticación especificado como una lista de propiedades y valores separados por dos puntos. Para obtener más información, consulta la documentación del servidor para la opción authMechanismProperties. Por defecto: |
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. Por defecto: |
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: Por defecto: |
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 Por defecto: |
retryWrites | booleano | Especifica que el controlador debe reintentar las operaciones de escritura admitidas si fallan debido a un error de red. Por defecto: |
retryReads | booleano | Especifica que el controlador debe reintentar las operaciones de lectura compatibles que fallan debido a un error de red. Por defecto: |
serverMonitoringMode | string | Especifica qué protocolo de supervisión del servidor usa el driver. Cuando se ajusta a Por defecto: |
uuidRepresentation | 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(). Por defecto: |
directConnection | booleano | Especifica que el driver debe conectarse directamente al host. Por defecto: |
maxConnecting | entero | Especifica el número máximo de conexiones que un pool puede establecer simultáneamente. Por defecto: |
srvServiceName | string | Especifica el nombre del servicio de los registros de recursos SRV que el driver recupera para construir tu lista de nodos iniciales. Debe utilizar el formato de conexión de lista de nodos iniciales de DNS en su URI de conexión para usar esta opción. Por defecto: |
Para obtener una lista completa de opciones, consulta la página de referencia de la API ConnectionString.