명령 실행

개요

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

이 가이드에는 다음 섹션이 포함되어 있습니다.

• 명령 실행 은 run_command() 및 run_cursor_command() 메서드의 구문과 동작을 설명합니다.

• 응답 은 명령 실행 메서드가 반환하는 정보를 설명합니다.

• 명령 예제 는 명령 예제를 제공하고 명령의 출력을 설명합니다.

• 추가 정보에서 이 가이드에 언급된 유형 및 메소드에 대한 리소스 및 API 문서 링크를 찾을 수 있습니다.

명령 실행

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

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

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

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

let result = my_db.run_command(doc! { "hello": 1 }).await?;

checkMetadataConsistency 명령은 여러 개의 결과 문서를 반환합니다. 다음 코드와 같이 run_cursor_command() 메서드를 사용하여 이 명령을 실행하고 결과를 수집할 수 있습니다.

let cursor = my_db
    .run_cursor_command(doc! { "checkMetadataConsistency": 1 })
    .await?;

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

let result = my_db
    .run_command(doc! { "hello": 1 })
    .selection_criteria(SelectionCriteria::ReadPreference(ReadPreference::Primary))
    .await?;

응답

run_command() 메서드는 명령이 실행된 후 데이터베이스의 응답이 포함된 Document 객체를 반환합니다. run_cursor_command() 는 여러 결과 문서를 참고하는 Cursor 을 반환합니다.

각 데이터베이스 명령은 다른 기능을 수행하므로 응답 내용은 실행된 명령에 따라 달라질 수 있습니다. 그러나 모든 응답에는 다음 필드가 있는 문서가 포함되어 있습니다.

명령 예제

다음 코드는 run_command() explain 메서드를 count 사용하여 flowers plants 데이터베이스의 collection 작업에 대한 명령을 실행하는 방법을 보여줍니다. explain 명령은 "queryPlanner" 상세도 모드에서 실행됩니다.

let my_db = client.database("plants");
let count_command = doc! { "count": "flowers" };
let explain_command =
    doc! {
    "explain": count_command,
    "verbosity": "queryPlanner"
};
let result = my_db.run_command(explain_command).await?;

{
    "$clusterTime": {
        "clusterTime": {
            "T": 1673969525,
            "I": 24
        },
        "signature": {...}
    },
    "command": {
        "$db": "plants",
        "count": "flowers"
    },
    "explainVersion": "1",
    "ok": 1,
    "operationTime": {
        "T": 1673969525,
        "I": 24
    },
    "queryPlanner": {
        "indexFilterSet": false,
        "maxIndexedAndSolutionsReached": false,
        "maxIndexedOrSolutionsReached": false,
        "maxScansToExplodeReached": false,
        "namespace": "plants.flowers",
        "rejectedPlans": [],
        "winningPlan": {
            "stage": "RECORD_STORE_FAST_COUNT"
        }
    },
    "serverInfo": {...},
    "serverParameters": {
        "internalDocumentSourceGroupMaxMemoryBytes": 104857600,
        ...
    }
}

추가 정보

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

• db.runCommand()

• 데이터베이스 명령

• hello 명령

• explain 명령