MongoDB\Driver\Manager::executeReadWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadWriteCommand — 읽고 쓰는 데이터베이스 명령 실행

설명

---

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

주 서버에서 명령을 실행합니다.

이 메서드는 읽고 쓰는 명령(예: » 집계)과 관련된 로직을 적용하고 MongoDB 서버 버전을 고려합니다. "readConcern" 및 "writeConcern" 옵션은 기본적으로 MongoDB 연결 URI의 해당 값으로 설정됩니다.

매개변수

---

db (string)

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

command (MongoDB\Driver\Command)

실행할 명령입니다.

options

options

Option	Type	설명
readConcern	MongoDB\Driver\ReadConcern	작업에 적용할 읽기 관심사입니다. 이 옵션은 MongoDB 3.2 이상에서 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다.
session	MongoDB\Driver\Session	작업과 연결할 세션입니다.
writeConcern	MongoDB\Driver\WriteConcern	작업에 적용할 쓰기 관심사입니다.

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

반환 값

---

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

오류/예외

---

• "session" 옵션이 "readConcern" 또는 "writeConcern" 옵션과 함께 연결된 트랜잭션과 함께 사용되는 경우 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
• "session" 옵션이 승인되지 않은 쓰기 문제와 함께 사용되는 경우 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\Manager::executeCommand() - 데이터베이스 명령 실행
• MongoDB\Driver\Manager::executeReadCommand() - 다음을 읽는 데이터베이스 명령을 실행합니다.
• MongoDB\Driver\Manager::executeWriteCommand() - 다음을 작성하는 데이터베이스 명령을 실행합니다.
• MongoDB\Driver\Server::executeReadWriteCommand() - 이 서버에서 읽고 쓰는 데이터베이스 명령을 실행합니다.