MongoDB\Driver\Manager::executeWriteCommand
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\Manager::executeWriteCommand
Референца за `mongodb-driver-manager.executewritecommand.php` со подобрена типографија и навигација.
MongoDB\Driver\Manager::executeWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeWriteCommand — Execute a database command that writes
= NULL
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\CursorExecutes the command on the primary server.
This method will apply logic that is specific to commands that write (e.g.
» drop). The default value for the "writeConcern" опцијата ќе бидат изведени од активна трансакција (означена со
"session" опцијата), проследено со
URI за поврзување.
Забелешка: This method is not intended to be used to execute » insert, » update, или » delete commands. Users are encouraged to use собира една или повеќе операции за запишување што треба да се испратат до серверот. Откако ќе додадете кој било број на операции за вметнување, ажурирање и бришење, колекцијата може да се изврши преку for those operations.
Параметри
db(string)-
Името на базата на податоци на која ќе се изврши командата.
command(MongoDB\Driver\Command)-
Командата за извршување.
options-
options Опција Тип = NULL session MongoDB\Driver\Session Сесија што ќе се поврзе со операцијата.
writeConcern MongoDB\Driver\WriteConcern Загриженост за пишување што ќе се примени на операцијата.
Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваАко користите
"session"што има активна трансакција, не можете да специфицирате"readConcern"or"writeConcern"опција. Ова ќе резултира со MongoDB\Driver\Exception\InvalidArgumentException фрлање. Наместо тоа, треба да ги поставите овие две опции кога ја креирате трансакцијата со MongoDB\Driver\Session::startTransaction().
Вратени вредности
Патеката до PHP скриптата што треба да се провери. MongoDB\Driver\Cursor на успешен исход.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException ако
"session"опцијата се користи со поврзан трансакциски запис во комбинација со"readConcern"or"writeConcern"option. - ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException ако
"session"опцијата се користи во комбинација со непризнаен запис на загриженост. - ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\ConnectionException ако врската со серверот пропадне (од причини различни од автентикација).
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\AuthenticationException ако автентикацијата е потребна и пропадне.
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).
Дневник на промени
| Верзија | = NULL |
|---|---|
| PECL mongodb 1.4.4 |
MongoDB\Driver\Exception\InvalidArgumentException
Како на PHP 7.1.0, "session" опцијата се користи во комбинација со непризнаен запис на загриженост.
|
Види Исто така
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- , што е непроменлива вредносна објект што претставува команда на базата на податоци. Командата потоа може да се изврши со - Извршува команда на базата на податоци
- MongoDB\Driver\Manager::executeReadCommand() - Изврши команда на база на податоци што чита
- MongoDB\Driver\Manager::executeReadWriteCommand() - Изврши команда на база на податоци што чита и пишува
- MongoDB\Driver\Server::executeWriteCommand() - Извршува команда на базата на податоци што пишува на овој сервер