PHP 8.5.0 Alpha 2 available for testing

MongoDB\Driver\Server::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeWriteCommandEjecuta un comando de base de datos que escribe en este servidor

Descripción

final public MongoDB\Driver\Server::executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

Ejecuta el comando en este servidor.

Este método aplicará una lógica específica a los comandos que escriben (por ejemplo » drop). El valor por omisión para la opción "writeConcern" será deducido de una transacción activa (indicada por la opción "session"), seguida de la URI de conexión.

Nota: Este método no está destinado a ser utilizado para ejecutar » insert, » update, o » delete comandos. Se recomienda a los usuarios utilizar MongoDB\Driver\Server::executeBulkWrite() para estas operaciones.

Parámetros

db (string)

El nombre de la base de datos sobre la cual se 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 a la operación.

writeConcern MongoDB\Driver\WriteConcern

Una preocupación de escritura a aplicar a la operación.

Advertencia

Si se utiliza una "session" que tiene una transacción en curso, no se puede especificar la opción "readConcern" o "writeConcern". Intentar hacer esto lanzará una excepción MongoDB\Driver\Exception\InvalidArgumentException. En su lugar, debe definir estas opciones cuando se crea la transacción con MongoDB\Driver\Session::startTransaction().

Valores devueltos

Retorna un MongoDB\Driver\Cursor en caso de éxito.

Errores/Excepciones

  • Throws MongoDB\Driver\Exception\InvalidArgumentException if the "session" option is used with an associated transaction in combination with a "readConcern" or "writeConcern" option.
  • Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.
  • Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
  • Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación
  • Lanza una MongoDB\Driver\Exception\RuntimeException en caso de otros errores (por ejemplo: comando inválido).

Historial de cambios

Versión Descripción
PECL mongodb 1.4.4 Una MongoDB\Driver\Exception\InvalidArgumentException será lanzada si la opción "session" es utilizada en combinación con un writeConcern no reconocido.

Notas

Nota: Es responsabilidad del llamante asegurarse de que el servidor sea capaz de ejecutar la operación de escritura. Por ejemplo, la ejecución de una operación de escritura en un secundario (excluyendo su base de datos "local") fallará.

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top