MongoCollection::setReadPreference

(PECL mongo >=1.3.0)

MongoCollection::setReadPreference — Establecer la preferencia de lectura para esta colección

Descripción

public MongoCollection::setReadPreference ( string $read_preference [, array $tags ] ) : bool

Parámetros

read_preference

El modo de preferencia de lectura: MongoClient::RP_PRIMARY, MongoClient::RP_PRIMARY_PREFERRED, MongoClient::RP_SECONDARY, MongoClient::RP_SECONDARY_PREFERRED, o MongoClient::RP_NEAREST.

tags

Un array de cero o más conjuntos de etiquetas, donde cada conjunto de etiquetas es también un array de criterios usados para comparar etiquetas con miembros de un conjunto de réplicas.

Valores devueltos

Devuelve TRUE en caso de éxito, o FALSE en caso contrario.

Errores/Excepciones

Emite un error de nivel E_WARNING si el parámetro no es válido, o si se proporcionan uno o más conjuntos de etiquetas con el modo de preferencia de lectura MongoClient::RP_PRIMARY.

Ejemplos

Ejemplo #1 Ejemplo de sintaxis de array de conjunto de etiquetas con MongoCollection::setReadPreference()

<?php

$m = new MongoClient();
$c = $m->test->users;

// Preferir el servidor más cercano del centro de datos "east" también usado para notificación,
// pero recurrir a un servidor del centro de datos "west"
$c->setReadPreference(MongoClient::RP_NEAREST, array(
    array('dc' => 'east', 'use' => 'reporting'),
    array('dc' => 'west'),
));
?>

Ver también