PHP 8.4.2 Released!

    A classe MongoDB\Driver\ReadPreference

    (mongodb >=1.0.0)

    Introdução

    Resumo da classe

    final class MongoDB\Driver\ReadPreference implements MongoDB\BSON\Serializable, Serializable {
    /* Constantes */
    const int RP_PRIMARY = 1;
    const int RP_PRIMARY_PREFERRED = 5;
    const int RP_SECONDARY = 2;
    const int RP_SECONDARY_PREFERRED = 6;
    const int RP_NEAREST = 10;
    const string PRIMARY = primary;
    const string PRIMARY_PREFERRED = primaryPreferred;
    const string SECONDARY = secondary;
    const string SECONDARY_PREFERRED = secondaryPreferred;
    const string NEAREST = nearest;
    const int NO_MAX_STALENESS = -1;
    const int SMALLEST_MAX_STALENESS_SECONDS = 90;
    /* Métodos */
    final public bsonSerialize(): stdClass
    final public __construct(string|int $mode, ?array $tagSets = null, ?array $options = null)
    final public getHedge(): ?object
    final public getMaxStalenessSeconds(): int
    final public getMode(): int
    final public getModeString(): string
    final public getTagSets(): array
    final public serialize(): string
    final public unserialize(string $data): void
    }

    Constantes predefinidas

    MongoDB\Driver\ReadPreference::RP_PRIMARY

    Todas as operações são lidas do conjunto de réplicas primário atual. Esta é a preferência de leitura padrão do MongoDB.

    Aviso

    Esta constante tornou-se DEFASADA a partir da versão 1.20.0 da extensão e será removida na 2.0. As aplicações devem usar MongoDB\Driver\ReadPreference::PRIMARY em seu lugar.

    MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED

    Na maioria das situações, as operações são lidas a partir dos membros primários, mas se não estiver disponível, as operações são lidas a partir dos membros secundários.

    Aviso

    Esta constante tornou-se DEFASADA a partir da versão 1.20.0 da extensão e será removida na 2.0. As aplicações devem usar MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED em seu lugar.

    MongoDB\Driver\ReadPreference::RP_SECONDARY

    Todas as operações são lidas nos membros secundários do conjunto de réplicas.

    Aviso

    Esta constante tornou-se DEFASADA a partir da versão 1.20.0 da extensão e será removida na 2.0. As aplicações devem usar MongoDB\Driver\ReadPreference::SECONDARY em seu lugar.

    MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED

    Na maioria das situações, as operações são lidas a partir de membros secundários, mas se nenhum membro secundário estiver disponível, as operações são lidas a partir do primário.

    Aviso

    Esta constante tornou-se DEFASADA a partir da versão 1.20.0 da extensão e será removida na 2.0. As aplicações devem usar MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED em seu lugar.

    MongoDB\Driver\ReadPreference::RP_NEAREST

    Operações lidas do membro do conjunto de réplicas com a menor latência de rede, independentemente do tipo do membro.

    Aviso

    Esta constante tornou-se DEFASADA a partir da versão 1.20.0 da extensão e será removida na 2.0. As aplicações devem usar MongoDB\Driver\ReadPreference::NEAREST em seu lugar.

    MongoDB\Driver\ReadPreference::PRIMARY

    Todas as operações são lidas do conjunto de réplicas primário atual. Esta é a preferência de leitura padrão do MongoDB.

    MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED

    Na maioria das situações, as operações são lidas a partir dos membros primários, mas se não estiver disponível, as operações são lidas a partir dos membros secundários.

    MongoDB\Driver\ReadPreference::SECONDARY

    Todas as operações são lidas nos membros secundários do conjunto de réplicas.

    MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED

    Na maioria das situações, as operações são lidas a partir de membros secundários, mas se nenhum membro secundário estiver disponível, as operações são lidas a partir do primário.

    MongoDB\Driver\ReadPreference::NEAREST

    Operações lidas do membro do conjunto de réplicas com a menor latência de rede, independentemente do tipo do membro.

    MongoDB\Driver\ReadPreference::NO_MAX_STALENESS

    O valor padrão para a opção "maxStalenessSeconds" é não especificar nenhum limite de inatividade máxima, o que significa que o driver não considerará o atraso de um secundário ao escolher para onde direcionar uma operação de leitura.

    MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS

    O valor mínimo para a opção "maxStalenessSeconds" é 90 segundos. O driver estima a inatividade dos secundários verificando periodicamente a data de gravação mais recente de cada membro do conjunto de réplicas. Como essas verificações são pouco frequentes, a estimativa de inatividade é grosseira. Assim, o driver não pode impor um valor máximo de inatividade inferior a 90 segundos.

    Registro de Alterações

    Versão Descrição
    PECL mongodb 1.20.0

    As constantes MongoDB\Driver\ReadPreference::RP_PRIMARY, MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::RP_SECONDARY, MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED, e MongoDB\Driver\ReadPreference::RP_NEAREST tornaram-se defasadas.

    PECL mongodb 1.7.0

    As constantes MongoDB\Driver\ReadPreference::PRIMARY, MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::SECONDARY, MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED, e MongoDB\Driver\ReadPreference::NEAREST foram adicionadas.

    Implementa Serializable.

    PECL mongodb 1.2.0

    As constantes MongoDB\Driver\ReadPreference::NO_MAX_STALENESS e MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS foram adicionadas.

    Implementa MongoDB\BSON\Serializable.

    Índice

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês)

    Não há notas de usuários para esta página.
    To Top