MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommand — 다음을 작성하는 데이터베이스 명령을 실행합니다.

설명

---

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

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

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

참고: 이 메서드는 » 삽입, » 업데이트 또는 » 삭제 명령을 실행하는 데 사용되지 않습니다. 사용자는 해당 명령에 MongoDB\Driver\Manager::executeBulkWrite()를 사용하는 것이 좋습니다.

매개변수

---

db (string)

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

command (MongoDB\Driver\Command)

실행할 명령입니다.

options

options

Option	Type	설명
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\Manager::removeSubscriber() - 이 Manager에 모니터링 이벤트 구독자를 등록 취소합니다.
• MongoDB\Driver\Command
• MongoDB\Driver\Cursor
• MongoDB\Driver\Manager::executeCommand() - 데이터베이스 명령 실행
• MongoDB\Driver\Manager::executeReadCommand() - 다음을 읽는 데이터베이스 명령을 실행합니다.
• MongoDB\Driver\Manager::executeReadWriteCommand() - 읽고 쓰는 데이터베이스 명령 실행
• MongoDB\Driver\Server::executeWriteCommand() - 이 서버에 기록하는 데이터베이스 명령을 실행합니다.