MongoDB\Driver\Server::executeWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Execute a database command that writes on this server
Descripción
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\CursorExecutes the command on this server.
This method will apply logic that is specific to commands that write (e.g.
» drop) and
take the MongoDB server version into account. The
"writeConcern" option will default to the corresponding
value from the MongoDB
Connection URI.
Nota: This method is not intended to be used to execute » insert, » update, or » delete commands. Users are encouraged to use MongoDB\Driver\Server::executeBulkWrite() for those commands.
Parámetros
-
db(string) -
El nombre de la base de datos en la que ejecutar el comando.
-
command(MongoDB\Driver\Command) -
El comando a ejecutar.
-
options -
options Option Type Description session MongoDB\Driver\Session Una sesión a asociar con la operación.
writeConcern MongoDB\Driver\WriteConcern Un asunto de escritura a aplicar a la operación.
AdvertenciaSi se usa la opción
"session"con sesión que tenga una transacción en progreso, no se puede especificar una opción"readConcern"o"writeConcern". Esto resultarña en una MongoDB\Driver\Exception\InvalidArgumentException. En su lugar se debería establecer estas dos opciones al crear la transacción con MongoDB\Driver\Session::startTransaction().
Valores devueltos
Devuelve un MongoDB\Driver\Cursor en caso de éxito.
Errores/Excepciones
- Lanza una MongoDB\Driver\Exception\InvalidArgumentException si la opción
"session"se usa con una transacción asociada junto a la opción"readConcern"o"writeConcern"option. - Lanza una MongoDB\Driver\Exception\InvalidArgumentException si la opción
"session"se usa junto a un asunto de escritura no reconocido. - Lanza una MongoDB\Driver\Exception\InvalidArgumentException en errores de análisis de argumentos.
- Lanza una MongoDB\Driver\Exception\ConnectionException si la conexión al servidor falla (por razones diferentes a la autenticación).
- Lanza una MongoDB\Driver\Exception\AuthenticationException si la autenticación es necesaria y falla.
- Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).
Historial de cambios
| Versión | Descripción |
|---|---|
| PECL mongodb 1.4.4 |
MongoDB\Driver\Exception\InvalidArgumentException
will be thrown if the "session" option is used in
combination with an unacknowledged write concern.
|
Notas
Nota: Es responsabilidad del llamador asegurarse de que el servidor es capaz de ejecutar la operación de escritura. Por ejemplo, ejecutar un operación de escritura en un secundario (excluyendo su base de datos "local"), fallará.
Ver también
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Server::executeCommand() - Execute a database command on this server
- MongoDB\Driver\Server::executeReadCommand() - Execute a database command that reads on this server
- MongoDB\Driver\Server::executeReadWriteCommand() - Execute a database command that reads and writes on this server
- MongoDB\Driver\Manager::executeWriteCommand() - Execute a database command that writes
add a note
