MongoDB\Driver\Server::executeCommand

(mongodb >=1.0.0)

MongoDB \ Driver \ Server :: executeCommand - 이 서버에서 데이터베이스 명령 실행


설명

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

이 메서드는 명령에 특별한 논리를 적용하지 않습니다. 이 메서드는 명령 문서에 통합될 "readConcern""writeConcern" 옵션을 허용하지만 이러한 옵션은 기본적으로 MongoDB Connection URI의 해당 값으로 설정되지 않으며 MongoDB 서버 버전도 고려되지 않습니다. 따라서 사용자는 가능한 경우 특정 읽기 및/또는 쓰기 명령 메서드를 사용하는 것이 좋습니다.

참고: "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 작업과 연결할 세션입니다.
writeConcern MongoDB\Driver\WriteConcern 작업에 적용할 쓰기 관심사입니다.

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


반환 값

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


오류/예외


변경 로그

버전 설명
PECL mongodb 1.4.4 "session" 옵션이 승인되지 않은 쓰기 문제와 함께 사용되면 MongoDB\Driver\Exception\InvalidArgumentException이 발생합니다.
PECL mongodb 1.4.0 세 번째 매개변수는 이제 options 배열입니다. 이전 버전과의 호환성을 위해 이 매개변수는 여전히 MongoDB\Driver\WriteConcern 개체를 허용합니다.

노트

참고: 서버가 쓰기 작업을 실행할 수 있는지 확인하는 것은 호출자의 책임입니다. 예를 들어, 보조(해당 "로컬" 데이터베이스 제외)에서 쓰기 작업을 실행하면 실패합니다.


기타