MongoDB\Driver\Manager::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadCommand — Execute a database command that reads
Descrierea
$db
, MongoDB\Driver\Command $command
, array $options = array()
) : MongoDB\Driver\Cursor
Selects a server according to the "readPreference" option
and executes the command on that server. By default, the read preference from
the MongoDB Connection
URI will be used.
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.
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\Manager::executeCommand() - Execute a database command
- MongoDB\Driver\Manager::executeReadWriteCommand() - Execute a database command that reads and writes
- MongoDB\Driver\Manager::executeWriteCommand() - Execute a database command that writes
- MongoDB\Driver\Server::executeReadCommand() - Execute a database command that reads on this server
add a note
