MongoDB\Driver\Server::executeReadWriteCommand
Execute a database command that reads and writes on this server
説明
final public MongoDB\Driver\Cursor MongoDB\Driver\Server::executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, arraynull $options = null)
This method will apply logic that is specific to commands that read and write
(e.g. » aggregate).
Default values for the "readConcern" and
"writeConcern" options will be inferred from an active
transaction (indicated by the "session" option), followed
by the connection URI.
パラメータ
-
db (string)
-
The name of the database on which to execute the command.
-
command (MongoDB\Driver\Command)
-
The command to execute.
-
options
-
options
| Option |
Type |
Description |
| readConcern |
MongoDB\Driver\ReadConcern |
A read concern to apply to the operation.
This option is available in MongoDB 3.2+ and will result in an
exception at execution time if specified for an older server
version.
|
| session |
MongoDB\Driver\Session |
A session to associate with the operation.
|
| writeConcern |
MongoDB\Driver\WriteConcern |
A write concern to apply to the operation.
|
警告
If you are using a "session" which has a transaction
in progress, you cannot specify a "readConcern" or
"writeConcern" option. This will result in an
MongoDB\Driver\Exception\InvalidArgumentException
being thrown. Instead, you should set these two options when you create
the transaction with
MongoDB\Driver\Session::startTransaction.
戻り値
Returns MongoDB\Driver\Cursor on success.
エラー / 例外
- Throws MongoDB\Driver\Exception\InvalidArgumentException if the
"session" option is used with an associated transaction in combination with a "readConcern" or "writeConcern" option.
- Throws MongoDB\Driver\Exception\InvalidArgumentException if the
"session" option is used in combination with an unacknowledged write concern.
- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
- Throws MongoDB\Driver\Exception\ConnectionException if connection to the server fails (for reasons other than authentication).
- Throws MongoDB\Driver\Exception\AuthenticationException if authentication is needed and fails.
- Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).
注意
注意:
It is the caller's responsibility to ensure that the server is capable
of executing the write operation. For example, executing a write operation
on a secondary (excluding its "local" database) will fail.
参考
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Server::executeCommand
- MongoDB\Driver\Server::executeReadCommand
- MongoDB\Driver\Server::executeWriteCommand
- MongoDB\Driver\Manager::executeReadWriteCommand