MongoCursor::partial

(PECL mongo >=1.2.0)

MongoCursor::partialIf this query should fetch partial results from mongos if a shard is down

说明

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

This option allows mongos to send partial query results if a shard is unreachable. This is only applicable when running a sharded MongoDB cluster and connecting to a mongos.

If a shard goes down and a query needs to be sent to that shard, mongos will return the results (if any) from shards it already contacted, then an error message that it could not reach the shard (a MongoCursorException in PHP). If you would like to get whatever results mongos can provide and no exception, you can use this method. Note that this means that you won't have an indication that a shard is down in your query response.

This has no effect on the query if all shards are reachable. This flag was implemented in MongoDB version 1.7.5, so will only work with that version and higher.

参数

okay

If receiving partial results is okay.

返回值

Returns this cursor.

错误/异常

Throws MongoCursorException if this cursor has started iterating.

相关文章
php cubrid 函数 fetch the next row from a result setphp dbx 函数 send a query and fetch all results if any php firebird/interbase 函数 fetch a result row from a query as an associative arrayphp maxdb 函数 check if there any more query results from a multi queryphp maxdb 函数 fetch results from a prepared statement into the bound variablesphp oci8 函数 returns the next row from a query as an objectphp oci8 函数 returns the next row from a query as a numeric arrayphp mongocommandcursor checks if there are results that have not yet been sent from the databasephp mongocursor counts the number of results for this queryphp mongocursor checks if there are results that have not yet been sent from the databasephp mongocursor execute the queryphp mongocursor return an explanation of the query often useful for optimization and debuggingphp mongocursor if this query should fetch partial results from mongos if a shard is downphp mongocursor set the read preference for this queryphp mongocursorinterface checks if there are results that have not yet been sent from the databasephp mysqli stmt fetch results from a prepared statement into the bound variablesphp mysqli stmt check if there are more query results from a multiple queryphp mysqlnduhconnection check if there are any more query results from a multi queryphp solrquery if true solr includes the number of groups that have matched the query in the resultsphp solrquery if true facet counts are based on the most relevant document of each group matching the query
关注编程学问公众号