MongoDB\Driver\Manager::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadCommand — 다음을 읽는 데이터베이스 명령을 실행합니다.

final public MongoDB\Driver\Manager::executeReadCommand(string $db, MongoDB\Driver\Command $command, array $options = array()): MongoDB\Driver\Cursor

"readPreference" 옵션에 따라 서버를 선택하고 해당 서버에서 명령을 실행합니다. 기본적으로 MongoDB Connection URI의 읽기 기본 설정이 사용됩니다.

이 메서드는 읽고(예: » count) MongoDB 서버 버전을 고려하는 명령에 특정한 로직을 적용합니다. "readConcern" 옵션은 기본적으로 MongoDB Connection URI의 해당 값으로 설정됩니다.

db (string)

명령을 실행할 데이터베이스의 이름입니다.

실행할 명령입니다.

options

options

Option	Type	설명
readConcern	MongoDB\Driver\ReadConcern	작업에 적용할 읽기 관심사입니다. 이 옵션은 MongoDB 3.2 이상에서 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다.
readPreference	MongoDB\Driver\ReadPreference	작업을 위한 서버를 선택하는 데 사용할 읽기 기본 설정입니다.
session	MongoDB\Driver\Session	작업과 연결할 세션입니다.

경고 트랜잭션이 진행 중인 "session"을 사용하는 경우 "readConcern" 또는 "writeConcern" 옵션을 지정할 수 없습니다. 그러면 MongoDB\Driver\Exception\InvalidArgumentException이 발생합니다. 대신 MongoDB\Driver\Session::startTransaction()으로 트랜잭션을 생성할 때 이 두 가지 옵션을 설정해야 합니다.

성공하면 MongoDB\Driver\Cursor를 반환합니다.

"session" 옵션이 "readConcern" 또는 "writeConcern" 옵션과 함께 연결된 트랜잭션과 함께 사용되는 경우 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
인수 구문 분석 오류에 대해 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
(인증 이외의 이유로) 서버 연결이 실패하면 MongoDB\Driver\Exception\ConnectionException을 던집니다.
인증이 필요하고 실패하면 MongoDB\Driver\Exception\AuthenticationException을 던집니다.
다른 오류(예: 잘못된 명령)에서 MongoDB\Driver\Exception\RuntimeException을 발생시킵니다.