Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu
Docs Home
/ /
Conectar
Docs Home
/ /
Driver de Java Reactive Streams
/
Conectar
Docs Home
/
Librerías de clientes
/
Java
/
Driver de Java Reactive Streams
/
Conectar

Especificar opciones de URI de conexión

Overview

Esta sección describe las opciones de conexión y autenticación de MongoDB que puede pasar como parámetros del URI de conexión en el controlador de Java Reactive Streams.

Uso del URI de conexión

Si pasas un URI de conexión al constructor MongoClient, puedes incluir opciones de conexión en la string como pares <name>=<value>. En el siguiente ejemplo, el URI de la conexión contiene la opción connectTimeoutMS con un valor de 60000 y la opción tls con un valor de true:

public class MongoConnection {
public static void main(String[] args) {
    String uri = "mongodb://<hostname>:<port>/?connectTimeoutMS=60000&tls=true";
    try (MongoClient client = MongoClients.create(uri)) {
            // Use client here
        }
    }
}

Opciones de conexión

Las siguientes secciones describen las opciones de conexión disponibles en el controlador Java Reactive Streams. Puedes pasar estos parámetros como parámetros del URI de conexión para especificar el comportamiento del cliente.

Autenticación

Opción de conexión
Descripción

mecanismo de autenticación

Establece el mecanismo que utiliza el controlador Java Reactive Streams para autenticar la
aplicación. Las opciones válidas se definen en la documentación de la API de la clase ConnectionString.

Tipo de datos: String
Valor predeterminado: "SCRAM-SHA-256" al conectarse a MongoDB4 v.0 o posterior.
"SCRAM-SHA-1" al conectarse a MongoDB v.3 0 hasta3 13v..
Ejemplo de URI de conexión: authMechanism=MONGODB-X509

authMechanismProperties

Configura opciones específicas para el mecanismo de autenticación.

Tipo de datos: String
Predeterminado: ""
Ejemplo de URI de conexión: authMechanismProperties=AWS_SESSION_TOKEN:12435

authSource

Establece el origen de las credenciales de autenticación. El origen suele ser una
base de datos. Esta opción solo se respeta cuando authMechanism se establece
MONGO-CRen.

Tipo de datos: String
Predeterminado: La base de datos en el URI de conexión, o "admin" si no se proporciona ninguna.
Ejemplo de URI de conexión: authSource=admin

Nombre de usuario

Establece el nombre de usuario para la autenticación. Cuando esta opción se incluye en un
URI de conexión, debe escaparse con caracteres de porcentaje.

Tipo de datos: String
Predeterminado: ""
Ejemplo de URI de conexión: username=my+user

Contraseña

Establece la contraseña para la autenticación. Cuando esta opción se incluye en un
URI de conexión, debe escaparse con caracteres de porcentaje.

Tipo de datos: String
Predeterminado: ""
Ejemplo de URI de conexión: password=strong+password

Configuración de conexión

Opción de conexión
Descripción

connectTimeoutMS

Establece el número de milisegundos que puede durar la conexión antes de que se agote el tiempo de espera. Si una
operación no finaliza en el tiempo especificado, el controlador Java Reactive Streams genera una excepción de tiempo de espera.

Tipo de datos: Integer
Valor predeterminado: null
Ejemplo de URI de conexión: connectTimeoutMS=6000

maxIdleTimeMS

Establece el número máximo de milisegundos que una conexión puede
permanecer inactiva en el grupo antes de ser eliminada y cerrada. Establece este valor
por encima del período de inactividad esperado de tu aplicación, pero por debajo de los tiempos de espera
de conexión del firewall o proxy para evitar desconexiones inesperadas.

Tipo Integer
de datos: Predeterminado: null
Ejemplo de URI de conexión: maxIdleTimeMS=6000

maxLifeTimeMS

Establece la duración máxima en milisegundos de una conexión agrupada. Si una
operación no finaliza en el tiempo especificado, el controlador Java Reactive Streams
cierra la conexión.

Tipo deInteger
datos: null
Valor predeterminado: Ejemplo de URI de conexión: maxLifeTimeMS=6000

socketTimeoutMS (deprecated)

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

de cliente. Milisegundos que puede tardar una recepción en un socket antes de que se agote el tiempo de
espera. Si una operación no finaliza en el
tiempo especificado, el controlador Java Reactive Streams genera una excepción de tiempo de espera.

Tipo Integer
de datos: Predeterminado: null
Ejemplo de URI de conexión: socketTimeoutMS=6000

ssl

Establece si se debe conectar mediante TLS/SSL.

Tipo de datos: boolean
Valor predeterminado: null
Ejemplo de URI de conexión: ssl=true

sslInvalidHostNameAllowed

Permite nombres de host no válidos para conexiones TLS/SSL.

Tipo de datos: boolean
Predeterminado: null
Ejemplo de URI de conexión: sslInvalidHostNameAllowed=true

tls

Establece si se debe conectar mediante TLS. Sustituye a la ssl opción.

Tipo de datos: boolean
Predeterminado: null
Ejemplo de URI de conexión: tls=true

tlsAllowInvalidHostnames

Permite nombres de host no válidos para conexiones TLS. Sustituye a la
sslInvalidHostNameAllowed opción.

Tipo de datos: boolean
Predeterminado: null
Ejemplo de URI de conexión: tlsAllowInvalidHostnames=true

tlsInsecure

Permite conexiones TLS no seguras al conectarse mediante TLS.

Tipo de datos: boolean
Predeterminado: null
Ejemplo de URI de conexión: tlsInsecure=true

Configuración del pool de conexiones

Opción de conexión
Descripción

maxConnecting

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

Tipo de datos: ValorInteger
predeterminado: null
Ejemplo de URI de conexión: maxConnecting=5

maxPoolSize

Establece el número máximo de conexiones en el grupo de conexiones. Si una operación necesita una nueva conexión mientras el grupo de conexiones tiene maxPoolSize conexiones abiertas, la nueva operación espera a que se abra una nueva conexión. Para limitar este tiempo de espera, utilice la configuración de tiempo de espera único. Para obtener más información, consulte la guía Limitar el tiempo de ejecución del servidor.

Tipo Integer
de datos: null
Predeterminado:Ejemplo de URI de conexión:maxPoolSize=5

minPoolSize

Establece el número mínimo de conexiones en el grupo de conexiones.

Tipo de datos: ValorInteger
predeterminado: null
Ejemplo de URI de conexión: minPoolSize=3

waitQueueTimeoutMS (deprecated)

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

Tiempo máximo de espera en milisegundos antes de que
una conexión en uso esté disponible o se cree una conexión y
comience a establecerse.

Tipo de datos: Integer
Predeterminado: null
Ejemplo de URI de conexión: waitQueueTimeoutMS=6000

Configuración del compresor

Opción de conexión
Descripción

compresores

Establece los tipos de compresión preferidos, en orden, para los mensajes de protocolo
de red enviados o recibidos del servidor. Los tipos de compresión deben pasarse como una
lista separada por comas. El controlador utiliza el primero de estos tipos de compresión
que admite el servidor.

Tipo String
null
de datos: Predeterminado:Ejemplo de URI de conexión:compressors=snappy,zstd,zlib

zlibCompressionLevel

Establece el nivel de compresión que usará zlib. Esta opción acepta
un valor entero entre -1 9y:

-:1 (Predeterminado). zlib usa su nivel de compresión predeterminado 6 (normalmente).
0-: Sin compresión.
1-: Máxima velocidad, pero menor compresión.
-: Máxima compresión, pero menor 9 velocidad.

Integer
Tipo-1
de datos: Predeterminado:Ejemplo de URI de conexión:zLibCompressionLevel=3

Configuración general

Opción de conexión
Descripción

directConnection

Establece si el controlador se conecta directamente al host.

Tipo de datos: Valorboolean
predeterminado: null
Ejemplo de URI de conexión: directConnection=true

loadBalanced

Establece si el controlador se conecta a MongoDB mediante un
balanceador de carga. Si true es, el controlador asume que se conecta a través de un
balanceador de carga.

Tipo de datos: Valorboolean
predeterminado: null
Ejemplo de URI de conexión: directConnection=true

retryWrites

Establece si el controlador reintenta o no las operaciones de escritura compatibles si
fallan debido a un error de red.

Tipo de datos: Valorboolean
predeterminado: True
Ejemplo de URI de conexión: retryWrites=true

retryReads

Establece si el controlador reintenta o no las operaciones de lectura compatibles si
fallan debido a un error de red.

Tipo de datos: boolean
Predeterminado: True
Ejemplo de URI de conexión: retryReads=true

uuidRepresentation

Establece el mecanismo que utiliza
el controlador Java Reactive Streams para codificar instancias de UUID. Consulte la documentación de la API de representación de UUID para obtener una lista de todas las
opciones válidas.

Tipo de datos: String
Predeterminado: unspecified
Ejemplo de URI de conexión: uuidRepresentation=unspecified

Configuración del proxy

Opción de conexión
Descripción

proxyHost

Establece el5 host proxy SOCKS para establecer una conexión.
El valor de proxyHost puede ser una dirección IPv4 válida,6
una dirección IPv o un nombre de dominio.
Obligatorio si proxyPassword proxyUsername proxyPort se especifican, o.

Tipo de datos: String
Predeterminado: null
Ejemplo de URI de conexión: proxyHost=example.com

proxyPort

Establece el número de puerto para el5 servidor proxy SOCKS. Debe ser un número entero no negativo.

Tipo de datos: Integer
Valor predeterminado: null
Ejemplo de URI de conexión: proxyPort=27

proxyUsername

Establece el nombre de usuario para autenticarse con el servidor proxy. Obligatorio si proxyPassword se especifica.

Tipo de datos: String
Predeterminado: null
Ejemplo de URI de conexión: proxyUsername=example

proxyPassword

Establece la contraseña para autenticarse con el servidor proxy. Obligatorio si
proxyPassword se especifica.

Tipo de datos: String
Predeterminado: null
Ejemplo de URI de conexión: proxyPassword=password

Configuración de preferencia de lectura

Opción de conexión
Descripción

readPreference

Establece la preferencia de lectura para esta conexión. Los valores enumerados
primary primaryPreferredsecondaryson:,,, secondaryPreferred nearesty.

Tipo de datos: Enum
Predeterminado: primary
Ejemplo de URI de conexión: readPreference.primary

readPreferenceTags

Especifica un conjunto de etiquetas como una lista de
pares clave-valor separadosdc:ny,rack:1
por dos puntos y separados por comas, por ejemplo,. Se eliminan los espacios al principio y al final de todas las claves y valores. Para
especificar una lista de conjuntos de etiquetas, utilice varios,readPreferenceTags separados por punto y
coma. Para obtener más información readPreferenceTags sobre, consulte la documentación de la API de la clase ConnectionString.

Tipo String
de datos: Predeterminado: null
Ejemplo de URI de conexión: readPreferenceTags=dc:ny

maxStalenessSeconds

Establece el tiempo máximo de caducidad en segundos. Para obtener más información sobre la caducidad,
consulte la documentación de la API de la clase ConnectionString.

Tipo de datos: Integer
Predeterminado: null
Ejemplo de URI de conexión: maxStalenessSeconds=60

Configuración del set de réplicas

Opción de conexión
Descripción

replicaSet

Especifica el nombre del conjunto de réplicas al que conectarse.

Tipo de datos: ValorString
predeterminado: null
Ejemplo de URI de conexión: replicaSet=replicaSet

Configuración del servidor

Opción de conexión
Descripción

appName

Establece el nombre lógico de la aplicación.
El cliente puede usar este nombre para identificar la
aplicación ante el servidor, así como
para su uso en los registros del servidor, los registros de consultas lentas y la recopilación de perfiles.

Tipo de datos: String
Valor predeterminado: null
Ejemplo de URI de conexión: appName=name

heartbeatFrequencyMS

Frecuencia en milisegundos del controlador que determina el estado actual de cada servidor en el clúster.

Tipo de datos: Integer
Predeterminado: null
Ejemplo de URI de conexión: heartbeatFrequencyMS=6000

localThresholdMS

Establece un umbral de tiempo de ping para elegir entre varios servidores MongoDB
a los que enviar una solicitud. Cuando se establece este valor, el controlador solo enviará
la solicitud a un servidor cuyo
tiempo de ping sea menor o igual al del servidor con el tiempo de ping más rápido más el umbral local.

Tipo de datos: Integer
Predeterminado: null
Ejemplo de URI de conexión: localThresholdMS=6000

serverMonitoringMode

Configura el modo de monitorización del servidor, que define el protocolo de monitorización a utilizar. Los valores enumerados son:, stream poll autoy.

Tipo de datos: Enum
Predeterminado: auto
Ejemplo de URI de conexión: serverMonitoringMode.auto

serverSelectionTimeoutMS

Establece cuánto tiempo esperará el controlador a que la selección del servidor sea exitosa antes de generar una excepción.

Tipo de datos: ValorInteger
predeterminado: null
Ejemplo de URI de conexión: serverSelectionTimeoutMS=6000

Configuración de SRV

Opción de conexión
Descripción

srvServiceName

Establece el nombre del servicio SRV. Consulte la

documentación de la API ClusterSettings.getSrvServiceName() para obtener más información.

Tipo de datos: String
Predeterminado: "mongodb"
Ejemplo de URI de conexión: srvServiceName=mongodb

srvMaxHosts

Establece el número máximo de hosts del registro SRV a los que conectarse.

Tipo de datos: Integer
Predeterminado: null
Ejemplo de URI de conexión: srvMaxHosts=5

Configuración del nivel de confirmación de escritura

Opción de conexión
Descripción

seguro

Establece si el controlador garantiza que el servidor MongoDB confirme todas las escrituras
o, de lo contrario, genera una excepción. Si false es, el controlador
no garantiza que el servidor MongoDB confirme todas las escrituras.

Tipo de datos: Valorboolean
predeterminado: null
Ejemplo de URI de conexión: safe=true

journal

Establece si el controlador espera a que el servidor confirme el grupo en el
archivo de registro en el disco.

Tipo de datos: boolean
Predeterminado: null
Ejemplo de URI de conexión: journal=true

w

Si se establece, el controlador agrega { w : wValue } a todos los comandos de escritura. Si se establece,
implica safe=True que.

Tipo de datos: Integer o String
Predeterminado: null
Ejemplo de URI de conexión: w=60

wtimeoutMS (deprecated)

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

Si se establece, el controlador agrega { wtimeout : ms } a todos los comandos de escritura. Si se
establece,safe=true implica. Esta opción se usa en combinación w con.

Tipo deInteger
datos: null
Predeterminado:Ejemplo de URI de conexión:wtimeoutMS=6000

Para obtener más información sobre las opciones de conexión en esta sección, consulte la guía Bases de datos y colecciones.

Volver

Elija un destino de conexión

Next

Bases de datos y colecciones

En esta página