MongoDB\Driver\Server::executeReadCommand
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\Server::executeReadCommand
Референца за `mongodb-driver-server.executereadcommand.php` со подобрена типографија и навигација.
MongoDB\Driver\Server::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — (mongodb >=1.4.0)
= NULL
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Изврши команда на базата на податоци што чита на овој сервер
"readPreference" option.
Ја извршува командата на овој сервер, без оглед на
Овој метод ќе примени логика специфична за команди што читаат (на пр.). Стандардни вредности за "readPreference" and
"readConcern" опциите ќе бидат изведени од активна трансакција (означена со "session" опцијата), проследено со URI за поврзување.
Забелешка: На
"readPreference"опцијата не го контролира серверот на кој драјверот ја издава операцијата; таа секогаш ќе се извршува на овој сервер објект. Наместо тоа, може да се користи при издавање на операцијата до секундарен (од врска со реплика сет, не самостоен) или mongos јазол за да се осигура дека драјверот соодветно го поставува протоколот за комуникација или ја додава преференцијата за читање на операцијата, соодветно.
Параметри
db(string)- Името на базата на податоци на која ќе се изврши командата.
command(MongoDB\Driver\Command)- Командата за извршување.
options-
options Опција Тип = NULL readConcern MongoDB\Driver\ReadConcern Загриженост за читање што ќе се примени на операцијата. Оваа опција е достапна во MongoDB 3.2+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. readPreference MongoDB\Driver\ReadPreference Преференција за читање што ќе се користи за избор на сервер за операцијата. session MongoDB\Driver\Session Сесија што ќе се поврзе со операцијата. Ги ескејпува специјалните знаци во стринг за употреба во 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 » Промени текови
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\ConnectionException ако врската со серверот пропадне (од причини различни од автентикација).
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\AuthenticationException ако автентикацијата е потребна и пропадне.
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\RuntimeException MongoDB\Driver\Session::startTransaction()
Види Исто така
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- » distinct - Извршува команда на базата на податоци на овој сервер
- MongoDB\Driver\Server::executeCommand() - Извршува команда на базата на податоци што чита и пишува на овој сервер
- MongoDB\Driver\Manager::executeReadWriteCommand() - Извршува команда на базата на податоци што пишува на овој сервер
- PECL mongodb 1.4.4 - Изврши команда на база на податоци што чита