readPreference

Visão geral

Para escolher de qual membro de um conjunto de réplicas ler, você pode usar o driver Java Reactive Streams para configurar as preferências de leitura. Você também pode controlar as propriedades de consistência e isolamento dos dados lidos de conjuntos de réplicas e clusters fragmentados configurando read concerns. Neste guia, você pode aprender como usar o Driver MongoDB Java Reactive Streams para configurar read preferences e read concerns.

É possível configurar a preferência de leitura e a preocupação de leitura nos seguintes níveis:

• Para sua implementação do MongoDB

• Para seu banco de dados de dados

• Para sua coleção

Configurar a read preference no nível do sistema

É possível configurar a preferência de leitura no nível do sistema das seguintes maneiras:

• Criando uma instância do MongoClientSettings , como mostrado no seguinte código:

  MongoClient mongoClient = MongoClients.create(MongoClientSettings.builder()
      .applyConnectionString(new ConnectionString("mongodb://host1,host2"))
      .readPreference(ReadPreference.secondary())
      .build());

• Criando uma instância do ConnectionString , como mostrado no seguinte código:

  MongoClient mongoClient =
  MongoClients.create("mongodb://host1:27017,host2:27017/?readPreference=secondary");

Configurar a read preference no nível do banco de dados ou da collection

Você pode configurar a preferência de leitura no nível do banco de dados de dados ou da collection das seguintes maneiras:

• Em um MongoDatabase usando o método withReadPreference() , conforme mostrado no código a seguir:

  MongoDatabase database = mongoClient.getDatabase("test")
      .withReadPreference(ReadPreference.secondary());

• Em um MongoCollection usando o método withReadPreference() , conforme mostrado no código a seguir:

  MongoCollection<Document> collection = database.getCollection("restaurants")
      .withReadPreference(ReadPreference.secondary());

MongoDatabase e MongoCollection instâncias são imutáveis. Chamar withReadPreference() em uma instância MongoDatabase ou MongoCollection existente retorna uma nova instância e não afeta a instância na qual o método é chamado.

No exemplo a seguir , a instância collectionWithReadPref tem a preferência de leitura de primaryPreferred , enquanto a preferência de leitura do collection não é afetada:

MongoCollection<Document> collectionWithReadPref = collection.withReadPreference(ReadPreference.primaryPreferred());

Configurar read concern no nível de sistema

Você pode configurar a preocupação de leitura no nível de sistema das seguintes maneiras:

• Criando uma instância do MongoClientSettings , como mostrado no seguinte código:

  MongoClient mongoClient = MongoClients.create(MongoClientSettings.builder()
      .applyConnectionString(new ConnectionString("mongodb://host1,host2"))
      .readConcern(ReadConcern.MAJORITY)
      .build());

• Criando uma instância do ConnectionString , como mostrado no seguinte código:

  MongoClient mongoClient =
  MongoClients.create("mongodb://host1:27017,host2:27017/?readConcernLevel=majority");

Configure a preocupação de leitura no nível do banco de dados ou da coleção

Você pode configurar a preocupação de leitura no banco de banco de dados ou nível de coleção das seguintes maneiras:

• Em um MongoDatabase usando o método withReadConcern() , conforme mostrado no código a seguir:

  MongoDatabase database = mongoClient.getDatabase("test")
      .withReadConcern(ReadConcern.MAJORITY);

• Em um MongoCollection usando o método withReadConcern() , conforme mostrado no código a seguir:

  MongoCollection<Document> collection = database.getCollection("restaurants")
      .withReadConcern(ReadConcern.MAJORITY);

MongoDatabase e MongoCollection instâncias são imutáveis. Chamar withReadConcern() em uma instância MongoDatabase ou MongoCollection existente retorna uma nova instância e não afeta a instância na qual o método é chamado.

No exemplo a seguir, a instância collWithReadConcern tem um read concern AVAILABLE , enquanto a read concern do collection não é afetada:

MongoCollection<Document> collWithReadConcern =
collection.withReadConcern(ReadConcern.AVAILABLE);

Combine read concern, read preference e write concern

Você pode construir instâncias do MongoClientSettings, MongoDatabase ou MongoCollection para incluir combinações de read concerns, read preferences e write concerns.

Por exemplo, o seguinte código define todos os três no nível da collection:

collection = database.getCollection("restaurants")
    .withReadPreference(ReadPreference.primary())
    .withReadConcern(ReadConcern.MAJORITY)
    .withWriteConcern(WriteConcern.MAJORITY);

Informações adicionais

Para saber mais sobre a preferência de leitura, consulte oguia de read preference no manual do MongoDB Server . Para saber mais sobre preocupação de leitura, consulte o guia Read Concern no manual do MongoDB Server .