« MongoDB\Driver\Server::executeCommand
MongoDB\Driver\Server::executeReadCommand »

MongoDB\Driver\Server::executeQuery

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeQuery — Execute a database query on this server

説明

final public function MongoDB\Driver\Server::executeQuery(string $namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor

Executes the query on this server.

Default values for the "readPreference" option and Query's "readConcern" option will be inferred from an active transaction (indicated by the "session" option), followed by the connection URI.

注意:

The "readPreference" option does not control the server to which the driver issues the operation; it will always be executed on this server object. Instead, it may be used when issuing the operation to a secondary (from a replica set connection, not standalone) or mongos node to ensure that the driver sets the wire protocol accordingly or adds the read preference to the operation, respectively.

パラメータ

namespace (string)

A fully qualified namespace (e.g. "databaseName.collectionName").

query (MongoDB\Driver\Query)

The query to execute.

options

options
Option Type Description
readPreference MongoDB\Driver\ReadPreference A read preference to use for selecting a server for the operation.
session MongoDB\Driver\Session A session to associate with the operation.

戻り値

Returns MongoDB\Driver\Cursor on success.

エラー / 例外

変更履歴

バージョン 説明
PECL mongodb 2.0.0 The options parameter no longer accepts a MongoDB\Driver\ReadPreference instance.
PECL mongodb 1.21.0 Passing a MongoDB\Driver\ReadPreference object as options is deprecated and will be removed in 2.0.
PECL mongodb 1.4.0 The third parameter is now an options array. For backwards compatibility, this parameter will still accept a MongoDB\Driver\ReadPreference object.
関連キーワード:
MongoDB   Driver   query   server   Server   options   operation   ReadPreference   Execute   database   executeQuery   mongodb   Query   option   Throws   Exception   namespace   Cursor   readPreference   session   connection   parameter   driver   read   preference
関連する関数・ページ:
mongodb-driver-manager.executequery   mongodb-driver-server.executecommand   mongodb-driver-server.executereadcommand   mongodb-driver-server.executewritecommand   mongodb-driver-cursor.construct   mongodb-driver-server.executereadwritecommand