명령 실행

개요

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

명령 실행

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

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

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

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

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

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

명령 옵션

command() 및 runCursorCommand() 메서드에 대한 선택적 명령 동작을 지정할 수 있습니다.

command() 메서드는 RunCommandOptions 객체를 허용합니다. 유형에 대해 자세히 알아보려면 API RunCommandOptions 설명서를 참조하세요.

runCursorCommand() method 은(는) RunCursorCommandOptions 객체를 허용합니다. 유형에 대해 자세히 알아보려면 API RunCursorCommandOptions 설명서를 참조하세요.

Node.js 드라이버 버전 6.0부터 command() 메서드에 다음 옵션만 전달할 수 있습니다.

• comment

• enableUtf8Validation

• raw

• readPreference

• session

command() 메서드에 전달하는 문서에서 더 많은 옵션을 설정할 수 있습니다. 명령 및 해당 명령이 허용하는 옵션에 대해 자세히 알아보려면 명령을 찾아 MongoDB Server 매뉴얼의 데이터베이스 명령 섹션에 있는 링크를 클릭하세요.

다음 코드는 majority 쓰기 고려 (write concern)로 실행되는 grantRolesToUser 명령을 지정하는 방법을 보여줍니다.

const commandDoc = {
    grantRolesToUser: "user011",
    roles: [ "readWrite" ],
    writeConcern: { w: "majority" }
};
const result = await myDB.command(commandDoc);

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

응답

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

예제

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

// Connect to the "testDB" database
const db = client.db("testDB");
// Run a cursor command to check metadata consistency within the database
const cursor = await db.runCursorCommand({
    checkMetadataConsistency: 1,
});
// Iterate through the cursor's results and print the contents
for await (const doc of cursor) {
  console.log(doc);
}

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

추가 정보

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

• db.runCommand()

• 데이터베이스 명령

• hello 명령

• find 명령

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