Configurações de clusters

Visão geral

Neste guia, você aprenderá como o driver Java gerencia clusters.

Você pode especificar configurações para seus clusters usando umastring de conexão ou passando um objeto MongoClientSettings para o construtor MongoClient. Selecione a aba Connection String ou MongoClientSettings para visualizar as opções disponíveis:

Inclua os seguintes parâmetros em sua string de conexão para modificar o comportamento do driver ao interagir com seu Cluster MongoDB :

Nome da opção	Tipo	Descrição
`serverSelectionTimeoutMS`	inteiro	Especifica a quantidade máxima de tempo, em milissegundos, o driver aguarda o sucesso da seleção do servidor antes de lançar uma exceção. Padrão: `30000` (30 segundos)
`localThresholdMS`	inteiro	Ao se comunicar com várias instâncias do MongoDB em um conjunto de réplicas, o driver envia solicitações somente 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`
`replicaSet`	string	Especifica que a connection string fornecida inclui vários hosts. Quando especificado, o driver tenta encontrar todos os membros desse conjunto. Padrão: `null`
`directConnection`	booleano	Especifica que o driver deve se conectar diretamente ao host. Isso mapeia a aplicação de `mode(ClusterConnectionMode.SINGLE)` ao seu `MongoClientSettings`. Padrão: `false`
`loadBalanced`	booleano	Especifica se o driver está ou não se conectando ao MongoDB usando um balanceador de carga . Padrão: `null`
`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`

Este exemplo conecta o driver diretamente a um servidor, independentemente do tipo de cluster MongoDB do qual ele faz parte:

ConnectionString connectionString = "mongodb://<host>:<port>/?directConnection=true"
MongoClient mongoClient = MongoClients.create(connectionString)

Para obter mais informações sobre esses parâmetros, consulte a documentação da API ConnectionString.

Encadeie o método applyToClusterSettings() para modificar o comportamento do driver ao interagir com o cluster do MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

Método

Descrição

addClusterListener()

Adiciona um ouvinte para eventos relacionados ao cluster.

applyConnectionString()

Usa as configurações de um objeto ConnectionString.

applySettings()

Utiliza as configurações de cluster especificadas em um objeto de ClusterSettings.

hosts()

Define todas as localizações especificadas de uma implantação do Mongo.

localThreshold()

Define a quantidade de tempo que uma viagem de ida e volta do servidor pode levar e ainda ser elegível para a seleção do servidor.

Padrão: 15 milliseconds

mode()

Define como se conectar a um sistema MongoDB.

requiredClusterType()

Define o tipo de cluster necessário para o cluster.

requiredReplicaSetName()

Define o nome do conjunto de réplicas necessário para o cluster.

serverSelectionTimeout()

Define o tempo máximo para selecionar um nó primário antes de lançar uma exceção de tempo limite.

Padrão: 30 seconds

serverSelector()

Adiciona um seletor de servidor para aplicar antes da seleção do servidor.

srvHost()

Define o nome do host a ser usado para procurar um registro DNS SRV para localizar os hosts MongoDB.

Se você quiser habilitar o processamento de registros TXT associados ao host, especifique o host SRV na string de conexão usando o método applyConnectionString().

Por exemplo:

MongoClient mongoClient =
  MongoClients.create(MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com")))

srvMaxHosts()

Define o número máximo de hosts aos quais o driver pode se conectar ao usar o protocolo de conexão de seedlist de DNS (SRV), identificado pelo prefixo de cadeia de conexão do mongodb+srv.

Lança uma exceção se você não estiver usando o protocolo de conexão SRV.

Este exemplo conecta o driver diretamente a um servidor, independentemente do tipo de cluster MongoDB do qual ele faz parte:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyToClusterSettings(builder ->
        builder.mode(ClusterConnectionMode.SINGLE))
    .build());

Dica

Isto é análogo ao parâmetro directConnection que você pode especificar em seu URI de conexão. Consulte a guia String de conexão para obter mais informações.

Para obter mais informações sobre os métodos encadeados, consulte a documentação da API do MongoClientSettings.Builder.

Voltar

Pool de Conexões

Configurações do Servidor