MongoDB\Driver\Server::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — Execute a database command that reads on this server
Descrierea
$db
, MongoDB\Driver\Command $command
[, array $options = array()
] ) : MongoDB\Driver\CursorExecutes the command on this server.
This method will apply logic that is specific to commands that read (e.g.
» count)
and take the MongoDB server version into account. The
"readConcern" option will default to the corresponding
value from the MongoDB
Connection URI.
Notă: Opțiunea
"readPreference"nu controlează serverul spre care driver-ul transmite operațiunea; ea întotdeauna va fi executată pe acest obiect al serverului. În loc, aceasta poate fi utilizată la transmiterea operațiunii către un secundar (printr-o conexiune către un set de replicare, nu către un secundar de sine stătător) sau către un nod mongo pentru a vă asigura că driver-ul stabilește protocolul de înscriere în mod corespunzător sau adaugă la operațiune preferința de citire corespunzătoare.
Parametri
-
db(string) -
Denumirea bazei de date asupra căreia va fi executată comanda.
-
command(MongoDB\Driver\Command) -
Comanda spre a fi executată.
-
options -
options Option Type Description readConcern MongoDB\Driver\ReadConcern O preocupare de citire pentru a fi aplicată operațiunii.
Această opțiune este disponibilă în MongoDB 3.2+ și va rezulta într-o excepție în timpul execuției dacă e specificată pentru o versiune mai veche a serverului.
readPreference MongoDB\Driver\ReadPreference Preferința de citire pentru a fi folosită la selectarea serverului pentru operațiune.
session MongoDB\Driver\Session O sesiune pentru a fi asociată cu operațiunea.
AvertizareDacă utilizați un
"session"care are o tranzacție în desfășurare, nu puteți specifica opțiunile"readConcern"sau"writeConcern". Aceasta va rezulta în emiterea unei excepții MongoDB\Driver\Exception\InvalidArgumentException. În loc, trebuie să stabiliți aceste două opțiuni când creați tranzacția cu MongoDB\Driver\Session::startTransaction().
Valorile întoarse
Întoarce MongoDB\Driver\Cursor în caz de succes.
Erori/Excepții
-
Emite MongoDB\Driver\Exception\InvalidArgumentException
dacă opțiunea
"session"este utilizată cu o tranzacție asociată, în combinație cu o opțiune"readConcern"sau"writeConcern". - Emite MongoDB\Driver\Exception\InvalidArgumentException în cazul erorilor la interpretarea argumentelor.
- Emite MongoDB\Driver\Exception\ConnectionException dacă conexiunea către server eșuează (din alte motive decât autentificarea).
- Emite MongoDB\Driver\Exception\AuthenticationException dacă este necesară autentificare și aceasta eșuează.
- Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).
A se vedea și
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Server::executeCommand() - Execute a database command on this server
- MongoDB\Driver\Server::executeReadWriteCommand() - Execute a database command that reads and writes on this server
- MongoDB\Driver\Server::executeWriteCommand() - Execute a database command that writes on this server
- MongoDB\Driver\Manager::executeReadCommand() - Execute a database command that reads
add a note
