데이터베이스 명령 실행

개요

이 가이드 에서는 MongoDB PHP 라이브러리를 사용하여 데이터베이스 명령 을 실행 하는 방법을 학습 수 있습니다. 데이터베이스 명령을 사용하여 서버 통계 가져오기, 복제본 세트 초기화 또는 집계 파이프라인 실행 과 같은 다양한 관리 및 진단 작업을 수행할 수 있습니다.

명령 실행

데이터베이스 명령 을 실행 하려면 명령 문서 에 명령과 관련 매개변수를 지정한 다음 MongoDB\Database::command() 메서드에 명령 문서 를 전달해야 합니다. 많은 데이터베이스 명령이 여러 결과 문서를 반환하므로 command() 메서드는 MongoDB\ 드라이버\Cursor 를 반환합니다. 반복할 수 있는 객체 입니다.

다음 코드는 MongoDB\Database 인스턴스 에서 command() 메서드를 사용하여 서버 에 대한 정보를 반환하는 hello 명령을 실행 하는 방법을 보여줍니다.

$database = $client->selectDatabase('myDB');
$cursor = $database->command(['hello' => 1]);

데이터베이스 명령 및 해당 매개변수의 전체 목록에 대한 링크를 찾으려면 추가 정보 섹션을 참조하세요.

$readPref = new MongoDB\Driver\ReadPreference('primaryPreferred');
$cursor = $database->command(
    ['hello' => 1], 
    ['readPreference' => $readPref]
);

응답

command() 메서드는 지정된 명령에 대한 데이터베이스 의 응답이 포함된 Cursor 객체 를 반환합니다. 각 데이터베이스 명령 은 서로 다른 기능을 수행하므로 응답 내용이 다를 수 있습니다.

단일 결과 문서 를 반환하는 명령의 경우 해당 결과는 커서 의 첫 번째이자 유일한 문서 로 사용할 수 있습니다. 여러 결과 문서를 반환하는 명령의 경우 라이브러리는 커서 ID 와 첫 번째 결과 배치 를 포함하는 원시 명령 응답의 커서 엔벨로프를 반복 가능한 커서 로 변환합니다.

명령을 실행 하기 전에 애플리케이션 이 여러 결과를 반복하거나 커서 에서 첫 번째이자 유일한 문서 를 추출할 수 있도록 명령의 응답 형식에 학습 보세요. 데이터베이스 명령의 전체 목록에 대한 링크를 찾으려면 이 가이드 의 추가 정보 섹션을 참조하세요.

원시 명령 응답에는 다음 필드가 포함되어 있습니다.

명령 예제

다음 예시 에서는 command() 메서드를 사용하여 dbStats 명령을 실행 하여 accounts 데이터베이스 의 저장 통계를 조회 합니다.

$database = $client->accounts;
$command = ['dbStats' => 1];
// dbStats returns a single document
$cursor = $database->command($command);
// Print the first document in the cursor
echo json_encode($cursor->toArray()[0]), PHP_EOL;

이 명령의 출력에는 데이터베이스 의 컬렉션에 대한 정보가 포함되며 컬렉션 전체에 저장된 데이터의 양과 크기가 설명됩니다.

{"db":"accounts","collections":2,"views":0,"objects":5,"avgObjSize":22,"dataSize":110,
"storageSize":40960,"totalFreeStorageSize":0,"numExtents":0,"indexes":2,"indexSize":40960,
"indexFreeStorageSize":0,"fileSize":0,"nsSizeMB":0,"ok":1}

추가 정보

이 가이드 의 개념에 대한 자세한 내용은 MongoDB Server 매뉴얼의 다음 문서를 참조하세요.

• db.runCommand()

• 데이터베이스 명령

• hello 명령

• dbStats 명령