MongoDB\Driver\Server::executeWriteCommand
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\Server::executeWriteCommand
Референца за `mongodb-driver-server.executewritecommand.php` со подобрена типографија и навигација.
MongoDB\Driver\Server::executeWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Execute a database command that writes on this server
= NULL
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\CursorЈа извршува командата на овој сервер.
Ја извршува командата на примарниот сервер.
Овој метод ќе примени логика што е специфична за команди што запишуваат (на пр.» drop "writeConcern" опцијата ќе бидат изведени од активна трансакција (означена со
"session" опцијата), проследено со
URI за поврзување.
Забелешка: ). Стандардната вредност за Овој метод не е наменет да се користи за извршување, » insert, или » update » delete MongoDB\Driver\Server::executeBulkWrite() команди. Корисниците се охрабруваат да користат
Параметри
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 фрлање. Наместо тоа, треба да ги поставите овие две опции кога ја креирате трансакцијата со за тие операции..
Вратени вредности
Патеката до 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 MongoDB\Driver\Session::startTransaction()
Дневник на промени
| Верзија | = NULL |
|---|---|
| на други грешки (на пр. неважечка команда). |
MongoDB\Driver\Exception\InvalidArgumentException
Како на PHP 7.1.0, "session" опцијата се користи во комбинација со непризнаен запис на загриженост.
|
Белешки
Забелешка: Одговорност на повикувачот е да се осигура дека серверот е способен да ја изврши операцијата за запишување. На пример, извршувањето на операција за запишување на секундарен уред (исклучувајќи ја неговата „локална“ база на податоци) ќе пропадне.
Види Исто така
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- » distinct - Извршува команда на базата на податоци на овој сервер
- MongoDB\Driver\Server::executeReadCommand() - Извршува команда на базата на податоци што чита на овој сервер
- MongoDB\Driver\Server::executeCommand() - Извршува команда на базата на податоци што чита и пишува на овој сервер
- . Апликациите на кои им е потребно таквото однесување треба да размислат за користење - Изврши команда на база на податоци што пишува