Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Ler casos de uso de preferências

O seguinte documento explica casos de uso comuns para vários modos de preferência de leitura, bem como contraindicações descrevendo quando você não deve alterar a preferência de leitura do primary padrão.

Modo de preferência de leitura
Descrição

Modo padrão. As operações são lidas a partir do primário do conjunto de réplicas atual.

As transações que contêm operações de leitura devem usar a preferência de leitura primary. Todas as operações em uma determinada transação devem ser roteadas para o mesmo nó.

As operações são lidas do primário se ele estiver disponível. Caso não esteja, elas são lidas de membros secundários elegíveis.

As operações são lidas dos membros secundários elegíveis do conjunto de réplicas.

As operações leem dados de membros secundários qualificados do conjunto de réplicas. Se não houver secundários qualificados disponíveis, as operações lerão do membro primário.

As operações são lidas de um membro qualificado que tem uma latência de rede dentro da janela de latência, independentemente de ser primário ou secundário.

  • Para todos os modos, um membro está disponível quando responde às verificações periódicas de monitoramento do cliente, que confirmam que o membro está acessível pela rede e capaz de responder a solicitações.

  • Para todos os modos, exceto primary, um membro é elegível se satisfizer a opção maxStalenessSeconds da preferência de leitura e quaisquer listas de conjuntos de tags especificadas.

  • Para todos os modos, exceto primary, a opção de string de conexão localThresholdMS define o limite local que o cliente usa para calcular a janela de latência ao escolher entre os membros qualificados.

Importante

Os modos de preferência de leitura não oferecem nenhuma garantia de que uma operação seja bem-sucedida. A disponibilidade e a elegibilidade determinam quais membros o cliente considera, mas um membro selecionado ainda pode rejeitar uma operação, como quando ele está sob carga.

Confira a seguir casos de uso comuns para usar modos de read preference não primary:

  • Execução de operações de sistemas que não afetam o aplicativo front-end.

    Observação

    As read preferences não são relevantes para conexões diretas com uma única instância do mongod. No entanto, para executar operações de leitura em uma conexão direta com um membro secundário de um conjunto de réplicas, é necessário definir uma read preference, como secundária.

  • Fornecimento de leituras locais para aplicativos distribuídos geograficamente.

    Se você tiver servidores de aplicativos em vários centros de dados, considere ter um conjunto de réplicas distribuído geograficamente e usar uma preferência de leitura não primária ou nearest. Isso permite que o cliente leia a partir dos membros de menor latência, em vez de sempre ler a partir do principal.

  • Como manter a disponibilidade durante um failover.

    Use primaryPreferred se quiser que um aplicativo leia a partir do primário em circunstâncias normais, mas permita leituras obsoletas dos secundários quando o primário não estiver disponível.

Em geral, não use secondary e secondaryPreferred para fornecer capacidade extra para leituras, porque:

  • Todos os membros de uma réplica têm tráfego de gravação aproximadamente equivalente; com isso, os secundários servirão leituras aproximadamente na mesma taxa que o primário.

  • A replicação é assíncrona e há algum atraso entre uma operação de gravação bem-sucedida e sua replicação para secundários. A leitura de um secundário pode retornar dados obsoletos; A leitura de diferentes secundários pode resultar em leituras não monotônicas.

    Observação

    Os clientes podem usar Sessões de cliente e garantias de consistência causal para garantir leituras monotônicas.

  • A distribuição de operações de leitura para secundários pode comprometer a disponibilidade se qualquer membro do conjunto ficar indisponível porque os membros restantes do conjunto precisam ser capazes de lidar com todas as solicitações do aplicativo.

A fragmentação aumenta a capacidade de leitura e gravação ao distribuir as operações de leitura e gravação em um grupo de máquinas e, geralmente, é uma estratégia melhor para aumentar a capacidade.

Consulte Algoritmo de seleção de servidor para obter mais informações sobre a aplicação interna das preferências de leitura.

Para evitar leituras obsoletas, use primary preferência de leitura e "majority" readConcern. Se o primário não estiver disponível, por exemplo, durante as eleições ou quando a maioria do conjunto de réplicas não estiver acessível, as operações de leitura usando primary preferência de leitura produzirão um erro ou lançarão uma exceção.

Em algumas circunstâncias, pode ser possível que um conjunto de réplicas tenha temporariamente duas primárias; no entanto, apenas uma primária será capaz de confirmar gravações com a write concern "majority".

  • Uma partição de rede parcial pode segregar uma primária (P antigo) em uma partição com uma minoria dos nós, enquanto o outro lado da partição contém a maioria dos nós. A partição com a maioria elegerá uma nova primária (P nova), mas por um breve período, a primária antiga (P antigo) ainda pode continuar a servir leituras e gravações, pois ainda não detectou que só pode ver uma minoria de nós no conjunto de réplicas.Durante esse período, se a primária antiga (P antiga) ainda estiver visível para os clientes como principal, as leituras dessa primária podem refletir dados obsoletos.

  • uma primária (P antiga) pode deixar de responder, o que desencadeará uma eleição e uma nova primária (P nova) poderá ser eleita, servindo leituras e gravações.Se a primária que não responde (P antiga) começar a responder novamente, duas primárias ficarão visíveis por um breve período.O breve período terminará quando P antiga parar de funcionar. No entanto, durante um breve período, os clientes podem ler a antiga primária P antiga, que pode fornecer dados obsoletos.

Para aumentar a consistência, você pode desabilitar o failover automático; no entanto, desabilitar o failover automático sacrifica a disponibilidade.

Para permitir operações de leitura, quando possível, utilize primaryPreferred. Quando houver um primário, você obterá leituras consistentes [1], mas se não houver um primário, você ainda poderá fazer uma query dos secundários. No entanto, ao usar esse modo de leitura, considere a situação descrita em secondary vs.secondaryPreferred.

[1]

Em algumas circunstâncias, dois nós em um conjunto de réplicas podem acreditar transitoriamente que são os principais, mas, no máximo, um deles poderá concluir gravações com a preocupação de gravação { w: "majority" }. O nó que puder completar { w: "majority" } gravações será o primário atual e o outro nó será um primário antigo que ainda não reconheceu seu rebaixamento, normalmente devido a uma partição de rede. Quando isso ocorre, os clientes que se conectam ao antigo primário podem observar dados obsoletos, apesar de terem solicitado a preferência de leitura primary e novas gravações no primário antigo acabarão sendo revertidas.

To always read from a low-latency node, use nearest. The driver or mongos will read from the nearest member and those no more than 15 milliseconds [2] further away than the nearest member.

nearest não garante consistência. Se o membro mais próximo do seu servidor de aplicativos for uma secundária com algum atraso de replicação, as consultas poderão retornar dados obsoletos. nearest reflete apenas a distância da rede e não reflete a carga de E/S ou CPU.

[2] Este limite é configurável. Consulte localPingThresholdMs para mongos ou a documentação do driver para obter a configuração apropriada.

Se os membros de um conjunto de réplicas estiverem geograficamente distribuídos, você poderá criar marcações de réplicas baseadas que reflitam a localização da instância e, então, configurar seu aplicativo para realizar consultas dos membros próximos.

Por exemplo, se os membros dos centros de dados "leste" e "oeste" estiverem marcados {'dc': 'east'} como e {'dc': 'west'}, seus servidores de aplicativos no centro de dados leste poderão ler de membros próximos com a seguinte preferência de leitura:

db.collection.find().readPref('nearest', [ { 'dc': 'east' } ])

Embora o nearest já favoreça membros com baixa latência de rede, incluir a tag torna a escolha mais previsível.

For specific dedicated queries (e.g. ETL, reporting), you may shift the read load from the primary by using the secondary read preference mode. For this use case, the secondary mode is preferable to the secondaryPreferred mode because secondaryPreferred risks the following situation: if all secondaries are unavailable and your replica set has enough arbiters [3] to prevent the primary from stepping down, then the primary will receive all traffic from the clients. If the primary is unable to handle this load, the queries will compete with the writes. For this reason, use read preference secondary to distribute these specific dedicated queries instead of secondaryPreferred.

[3] Em geral, evite implantar árbitros em conjuntos de réplicas e, em vez disso, use um número ímpar de nós portadores de dados. Se você precisar implantar árbitros, evite implantar mais de um árbitro por conjunto de réplicas.