명령 실행

개요

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

명령 실행

데이터베이스 명령을 실행하려면 명령 문서에 명령과 관련 매개변수를 지정한 다음 명령 문서를 명령 실행 메서드에 전달해야 합니다. Node.js 드라이버는 데이터베이스 명령을 실행하기 위해 다음과 같은 메서드를 제공합니다.

• command()Document 유형으로 명령 응답을 반환합니다. 이 방법은 모든 데이터베이스 명령과 함께 사용할 수 있습니다.

• runCursorCommand(), 명령 응답을 반복 가능한 RunCommandCursor 유형으로 반환합니다. 데이터베이스 명령이 여러 결과 문서를 반환하는 경우에만 이 메서드를 사용할 수 있습니다.

다음 코드는 command() 메서드를 사용하여 데이터베이스에서 복제본 세트의 현재 멤버의 역할에 대한 정보를 반환하는 hello 명령을 실행하는 방법을 보여 줍니다.

const result = await myDB.command({ hello: 1 });

데이터베이스 명령 및 해당 매개변수의 전체 목록은 추가 정보 섹션을 참조하십시오.

const commandOptions = { readPreference: "nearest" };
const result = await myDB.command(commandDoc, commandOptions);

응답

각 메서드는 명령이 실행된 후 Document 객체 또는 데이터베이스의 응답이 포함된 커서를 반환합니다. 각 데이터베이스 명령은 다른 기능을 수행하므로 응답 내용은 명령에 따라 다를 수 있습니다. 그러나 모든 응답에는 다음 필드가 있는 문서가 포함되어 있습니다.

예시

다음 코드는 runCursorCommand() 메서드를 사용하여 testDB 데이터베이스에서 checkMetadataConsistency 명령을 실행하고 결과를 반복하는 방법을 보여줍니다.

const db = client.db("testDB");
const cursor = await db.runCursorCommand({
    checkMetadataConsistency: 1,
});
for await (const doc of cursor) {
  console.log(doc);
}

{
  type: ...,
  description: ...,
  details: {
    namespace: ...,
    info: ...
  }
}
{
  type: ...,
  description: ...,
  details: {
    namespace: ...,
    collectionUUID: ...,
    maxKeyObj: ...,
    ...
  }
}

추가 정보

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

• db.runCommand()

• 데이터베이스 명령

• hello 명령

커서 에서 데이터를 조회 하는 방법을 학습 보려면 커서에서 데이터 액세스 기본 사항 페이지를 참조하세요.