MongoCursor::partial

(PECL mongo >=1.2.0)

MongoCursor::partialЕсли этот запрос должен получить частичные результаты от mongos, если шард недоступен

Описание

public MongoCursor::partial ([ bool $okay = TRUE ] ) : MongoCursor

Эта опция позволяет mongos отправлять частичные результаты запроса, если шард недоступен. Это применимо только при запуске сегментированного кластера MongoDB и подключении к mongos.

Если шард выходит из строя и запрос должен быть отправлен этому шарду, mongos вернет результаты (если таковые имеются) от шардов, с которыми он уже связался, а затем сообщение об ошибке, что он не может достигнуть шарда (исключение MongoCursorException в PHP). Если вы хотите получить любые результаты, которые могут предоставить mongos, и не исключение, вы можете использовать этот метод. Обратите внимание, что это означает, что у вас не будет указания на то, что шард недоступен в вашем запросе.

Это не влияет на запрос, если все шарды достижимы. Этот флаг был реализован в MongoDB версии 1.7.5, поэтому будет работать только с этой версией и выше.

Список параметров

okay

Если получение частичных результатов в порядке.

Возвращаемые значения

Возвращает курсор.

Ошибки

Выдает исключение MongoCursorException, если этот курсор начал итерацию.