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 pré-definidas

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.

Warning

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.

Warning

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.

Warning

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.

Warning

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.

Warning

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.

Table of Contents