MongoDB\Driver\Server::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — 이 서버에서 읽는 데이터베이스 명령을 실행합니다.
설명
final public MongoDB\Driver\Server::executeReadCommand(string $db, MongoDB\Driver\Command $command, array $options = array()): MongoDB\Driver\Cursor
이 서버에서 명령을 실행합니다.
이 메서드는 읽고(예: » 카운트) MongoDB 서버 버전을 고려하는 명령에 특정한 로직을 적용합니다. "readConcern" 옵션은 기본적으로 MongoDB 연결 URI의 해당 값으로 설정됩니다.
참고: "readPreference" 옵션은 드라이버가 작업을 실행하는 서버를 제어하지 않습니다. 항상 이 서버 개체에서 실행됩니다. 대신, 드라이버가 유선 프로토콜을 적절하게 설정하거나 작업에 읽기 기본 설정을 각각 추가하도록 하기 위해 보조(독립형이 아닌 복제 세트 연결에서) 또는 mongos 노드에 작업을 실행할 때 사용할 수 있습니다.
매개변수
db(string)- 명령을 실행할 데이터베이스의 이름입니다.
command(MongoDB\Driver\Command)- 실행할 명령입니다.
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을 던집니다.
기타
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Server::executeCommand() - 이 서버에서 데이터베이스 명령 실행
- MongoDB\Driver\Server::executeReadWriteCommand() - 이 서버에서 읽고 쓰는 데이터베이스 명령을 실행합니다.
- MongoDB\Driver\Server::executeWriteCommand() - 이 서버에 기록하는 데이터베이스 명령을 실행합니다.
- MongoDB\Driver\Manager::executeReadCommand() - 다음을 읽는 데이터베이스 명령을 실행합니다.