MongoCursor::partial

(PECL mongo >=1.2.0)

MongoCursor::partial — Si la requête doit récupérer des résultats partiels depuis mongos si un partage est inaccessible

Description

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

Cette option permet à mongos d'envoyer des résultats partiels de requête si un partage est inaccessible. Ceci n'est valable que lors d'une exécution sur un cluster MongoDB partagé, et lors d'une connexion à un mongos.

Si un partage devient inaccessible et qu'une requête doit être envoyée sur ce partage, mongos retournera les résultats (s'il y en a) depuis les partages déjà contactés, puis, un message d'erreur indiquant qu'il n'a pu atteindre le partage (une exeception MongoCursorException en PHP). Si vous voulez récupérer tous les résultats que mongos peut fournir sans émission d'une exception, vous pouvez utiliser cette méthode. Notez que cela signifie que vous n'aurez aucune indication quant au fait qu'un partage n'est pas accessible dans la réponse.

Cette méthode n'a aucun effet sur la requête si tous les partages sont disponibles. Ce drapeau a été implémenté en MongoDB version 1.7.5, aussi, vous ne pouvez vous en service qu'à partir de cette version et supérieure.

Liste de paramètres

okay: Si nous souhaitons recevoir des résultats partiels.

Valeurs de retour

Retourne ce curseur.

Erreurs / Exceptions

Émets une exception MongoCursorException si le curseur à commencer son itération.