Menu Docs
Página inicial do Docs
/ / /
Driver de sincronização Java
/ /

Opções de conexão

Esta seção explica as opções de conexão e autenticação MongoDB suportadas pelo driver. Você pode passar as opções de conexão como parâmetros do URI de conexão para especificar o comportamento do cliente.

Nome da opção
Tipo
Descrição
Tamanho mínimo da piscina
inteiro

Especifica o número mínimo de conexões que devem existir a qualquer momento em um único pool de conexões.

Padrão: 0
Tamanho máximo da piscina
inteiro

Define o limite máximo de conexões que um pool de conexões pode ter em um determinado momento.

Padrão: 100
waitQueueTimeoutMS
inteiro

Especifica a quantidade máxima de tempo, em milissegundos que uma conversa pode esperar que uma conexão se torne disponível.

Padrão: 120000 (120 segundos)
serverSelectionTimeoutMS
inteiro

Especifica a quantidade máxima de tempo, em milissegundos, o driver esperará o sucesso da seleção do servidor antes de lançar uma exceção.

Padrão: 30000 (30 segundos)
Limite local MS
inteiro

Ao se comunicar com várias instâncias do MongoDB em um conjunto de réplicas, o driver só enviará solicitações para um servidor cujo tempo de resposta seja menor ou igual ao servidor com o tempo de resposta mais rápido mais o limite local, em milissegundos.

Padrão: 15
heartbeatFrequencyMS
inteiro

Especifica a frequência, em milissegundos que o driver esperará entre as tentativas de determinar o estado atual de cada servidor no cluster.

Padrão: 10000 (10 segundos)
réplicaSet
string

Especifica que aconnection string do fornecida inclui múltiplos hosts. Quando especificado, o driver tenta encontrar todos os membros desse conjunto.

Padrão: null
ssl
booleano

Especifica que toda comunicação com instâncias MongoDB deve usar TLS/SSL. Substituído pela opção tls .

Padrão: false
tls
booleano

Especifica que toda comunicação com instâncias MongoDB deve usar TLS. Suplanta a opção ssl.

Padrão: false
TLS inseguro
booleano

Especifica que o driver deve permitir nomes de host inválidos para conexões TLS. Tem o mesmo efeito que configurar tlsAllowInvalidHostnames para true. Para configurar restrições de segurança TLS de outras formas, use um SSLContext personalizado.

Padrão: false
tlsAllowInvalidHostnames
booleano

Especifica que o driver deve permitir nomes de host inválidos no certificado para conexões TLS. Suplanta sslInvalidHostNameAllowed.

Padrão: false
connectTimeoutMS
inteiro

Especifica o tempo máximo, em milésimos de segundo, que o driver Java aguarda a abertura de uma conexão antes de atingir o tempo-limite. Um valor de 0 instrui o driver a nunca atingir o tempo-limite enquanto espera a abertura de uma conexão.

Padrão: 10000 (10 segundos)
socketTimeoutMS
inteiro

Especifica a quantidade máxima de tempo, em milissegundos, que o driver Java aguardará para enviar ou receber uma solicitação antes de atingir o tempo limite. Um valor de 0 instrui o driver a nunca expirar enquanto aguarda para enviar ou receber uma solicitação.

Padrão: 0
maxIdleTimeMS
inteiro

Especifica o tempo máximo, em milissegundos, durante o qual o driver Java permitirá que uma conexão em pool fique inativa antes de fechar a conexão. Um valor de 0 indica que não há limite superior de quanto tempo o driver pode permitir que uma coleção agrupada fique inativa.

Padrão: 0
maxLifeTimeMS
inteiro

Especifica a quantidade máxima de tempo, em milissegundos, o driver Java continuará usando uma pool de conexão antes de fechar a conexão. Um valor de 0 indica que não há limite superior de quanto tempo o driver pode manter uma pool de conexão aberta.

Padrão: 0
revista
booleano

Especifica que o driver deve aguardar que a instância do MongoDB conectada faça o commit em grupo no arquivo de diário no disco para todas as gravações.

Padrão: false
w
string ou inteiro

Especifica a write concern. Para obter mais informações sobre valores, consulte a documentação do servidor para a opção w.

Padrão: 1
WTimeoutMS
inteiro

Especifica um limite de tempo, em milésimos de segundo, para o write concern. Para obter mais informações, consulte a documentação do servidor para a opção wtimeoutMS. Um valor de 0 instrui o driver a nunca esgotar as operações de gravação.

Padrão: 0
readPreference
string

Especifica a read preference. Para obter mais informações sobre valores, consulte a documentação do servidor para a opção readPreference.

Padrão: primary
etiquetas de referência de leitura
string

Especifica as marcações de read preference. Para obter mais informações sobre valores, consulte a documentação do servidor para a opção readPreferenceTags.

Padrão: null
maxStalenessSeconds
inteiro

Especifica, em segundos, o quão obsoleto um secundário pode ficar antes que o driver pare de se comunicar com esse secundário. O valor mínimo é 90 segundos ou a frequência de pulsação mais 10 segundos, o que for maior. Para obter mais informações, consulte a documentação do servidor para a opção maxStalenessSeconds. Não fornecer um parâmetro ou especificar explicitamente -1 indica que não deve haver verificação de obsolescência para secundários.

Padrão: -1
mecanismo de autenticação
string

Especifica o mecanismo de autenticação que o driver usa se uma credencial foi fornecida.

Padrão: por padrão, o cliente escolhe o mecanismo mais seguro disponível com base na versão do servidor. Para obter os valores possíveis, consulte a documentação do servidor para a opção authMechanism.
Fonte de autenticação
string

Especifica o banco de dados no qual as credenciais fornecidas são validadas.

Padrão: admin
Propriedades do mecanismo de autenticação
string

Especifica as propriedades de autenticação para o mecanismo de autenticação especificado como uma lista de propriedades e valores separados por dois pontos. Para obter mais informações, consulte a documentação do servidor para a opção authMechanismProperties.

Padrão: null
appName
string

Especifica o nome do aplicativo fornecido às instâncias MongoDB durante o handshake de conexão. Pode ser usado para registros e perfis do servidor.

Padrão: null
compressores, compressores
string

Especifica um ou mais algoritmos de compressão que o driver tentará usar para compactar as solicitações enviadas à instância conectada do MongoDB. Os valores possíveis incluem: zlib, snappy e zstd.

Padrão: null
zlibCompressionLevel
inteiro

Especifica o grau de compressão que a usa para diminuir o tamanho das solicitações para zlib a MongoDB instância conectada. O nível pode variar de -1 a 9, com valores mais baixos sendo compactados mais rapidamente (mas resultando em solicitações maiores) e valores maiores compactando mais lentamente (mas resultando em solicitações menores).

Padrão: null
retryWrites
booleano

Especifica que o driver deve repetir as operações de gravação com suporte se elas não puderem ser concluídas devido a um erro de rede.

Padrão: true
Tente ler novamente
booleano

Especifica que o driver deve repetir as operações de leitura com suporte se não for possível concluir devido a um erro de rede.

Padrão: true
serverMonitoringMode
string

Especifica qual protocolo de monitoramento de servidor o driver usa. Quando definido como auto, o modo de monitoramento é determinado pelo ambiente no qual o driver está sendo executado. O driver usa o modo poll em ambientes de função como serviço (FaaS) e o modo stream em outros ambientes.

Padrão: auto
uuidRepresentação
string

Especifica a representação do UUID a ser usada nas operações de leitura e gravação. Para obter mais informações, consulte a documentação do driver para o método MongoClientSettings.getUuidRepresentation().

Padrão: unspecified
conexão direta
booleano

Especifica que o driver deve se conectar diretamente ao host.

Padrão: false
maxConnecting
inteiro

Especifica o número máximo de conexões que um pool pode estabelecer simultaneamente.

Padrão: 2
srvServiceName
string

Especifica o nome do serviço dos registros de recursos SRV que o driver recupera para construir sua lista de sementes. Você deve usar o formato de conexão da lista de sementes do DNS em seu URI de conexão para usar essa opção.

Padrão: mongodb

Para obter uma lista completa de opções, consulte a documentação da API ConnectionString.

← Conecte-se ao MongoDB