데이터베이스 명령
아래에 설명된 모든 명령어 문서는 명령어와 사용 가능한 매개변수에 대해 설명하고 각 명령어에 대한 문서 템플릿 또는 프로토타입을 제공합니다. 일부 명령 문서에는 관련 mongosh
헬퍼도 포함되어 있습니다.
현재 데이터베이스에 대한 명령을 실행하려면 db.runCommand()
을 사용하세요.
db.runCommand( { <command> } )
admin
데이터베이스에 대해 관리 명령을 실행하려면 db.adminCommand()
을(를) 사용하십시오.
db.adminCommand( { <command> } )
참고
구문 및 예시를 포함하여 특정 명령에 대한 자세한 내용을 보려면 명령 참조 페이지 링크를 클릭합니다.
명령 구문
데이터베이스 명령을 실행할 때 명령을 db.runCommand()
에 대한 문서로 지정합니다. 문서의 키는 실행할 명령이며 값은 일반적으로 1
으로 제공됩니다. 값은 명령 출력에 영향을 주지 않습니다. 예를 들면 다음과 같습니다.
db.runCommand( { hello: 1 } )
사용자 명령
집계 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | ||
컬렉션 또는 보기 화면에 있는 문서 수를 계산합니다. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | |
컬렉션이나 뷰의 지정된 키에 대해 찾은 고유 값을 표시합니다. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | |
대규모 데이터 세트에 대해 맵 리듀스 집계를 수행합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. |
지리 공간 명령
쿼리 및 쓰기 작업 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
한 번의 요청으로 여러 컬렉션에 대한 여러 삽입, 업데이트, 삭제 작업을 수행합니다. 버전 8.0에 추가 되었습니다. | No | |
하나 이상의 문서를 삭제합니다. | 예 | |
컬렉션 또는 보기에서 문서를 선택합니다. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | |
단일 문서를 반환하고 수정합니다. | 예 | |
현재 커서가 가리키고 있는 문서의 배치를 반환합니다. | 예 | |
하나 이상의 문서를 삽입합니다. | 예 | |
MongoDB 5.0에서 제거되었습니다. 마지막 오류 상태를 초기화합니다. | No | |
하나 이상의 문서를 업데이트합니다. | 예 |
쿼리 계획 캐시 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
컬렉션에 대해 캐시된 쿼리 계획을 제거합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
컬렉션의 인덱스 필터를 지웁니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
컬렉션의 인덱스 필터를 나열합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
컬렉션에 대한 인덱스 필터를 설정합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. |
데이터베이스 작업
Authentication Commands
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
사용자 이름과 비밀번호를 사용하여 인증된 세션을 시작합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
현재 인증된 세션을 종료합니다. | 예 |
사용자 관리 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
새 사용자를 생성합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
데이터베이스와 연결된 모든 사용자를 삭제합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
단일 사용자를 제거합니다. | M10 클러스터는 지원되지 않습니다. | |
사용자에게 역할과 해당 권한을 부여합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
사용자로부터 역할을 제거합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
사용자 데이터를 업데이트합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
지정된 사용자에 대한 정보를 반환합니다. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. |
역할 관리 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
역할을 생성하고 해당 권한을 지정합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
사용자 정의 역할을 삭제합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
데이터베이스에서 모든 사용자 정의 역할을 삭제합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
사용자 정의 역할에 권한을 할당합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
사용자 정의 역할이 권한을 상속 받을 역할을 지정합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
자격 증명 및 역할을 포함한 사용자 정보의 인메모리 캐시를 플러시합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
사용자 정의 역할에서 지정된 권한을 제거합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
사용자 정의 역할에서 지정된 상속된 역할을 제거합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
지정된 역할에 대한 정보를 반환합니다. | 예 | |
사용자 정의 역할을 업데이트합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. |
복제 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
작동하지 않는 항목을 oplog에 씁니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
oplog 항목을 현재 데이터 세트에 적용하는 내부 명령입니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
기본인지 여부를 포함하여 복제본 세트에서 이 구성원의 역할에 대한 정보를 표시합니다. | 예 | |
선출된 프라이머리가 동기화(따라잡기)를 중단한 후 프라이머리로 전환을 완료하도록 강제합니다. | 예 | |
현재 회원이 일정 기간 동안 예비선거로 선거에 출마하지 못하도록 합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
리플리카 세트의 구성 객체를 반환합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
복제본 세트의 상태를 보고하는 문서를 반환합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
새 복제본 세트를 초기화합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
보조 노드를 RECOVERING 상태로 만드는 유지 관리 모드를 사용하거나 사용하지 않도록 설정합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
기존 복제 세트에 새 구성을 적용합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
복제본 집합 멤버에 대한 oplog의 크기를 동적으로 조정합니다. WiredTiger 스토리지 엔진에서만 사용할 수 있습니다. | M10 클러스터는 지원되지 않습니다. | |
M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | ||
복제할 멤버를 선택하기 위한 기본 논리를 명시적으로 재정의합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. |
샤딩 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
리샤딩 작업을 중단합니다. 버전 5.0에 추가. | 예 | |
진행 중인 버전 8.0에 추가 되었습니다. | ||
진행 중인 버전 8.0에 추가 되었습니다. | ||
서버리스 인스턴스는 지원하지 않습니다. | ||
서버리스 인스턴스는 지원하지 않습니다. | ||
샤드 키를 평가하기 위한 메트릭을 계산합니다. 버전 7.0에 추가. | 예 | |
샤드된 컬렉션의 청크가 균형을 이루고 있는지에 대한 정보를 반환합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
밸런서 스레드를 시작합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
밸런서 상태에 대한 정보를 반환합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
밸런서 스레드를 중지합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
샤딩 메타데이터에 대한 일련의 일관성 검사를 수행합니다. 버전 7.0에 추가. | 예 | |
청크의 jumbo 플래그를 지웁니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
Cleans up a failed resharding operation. 버전 5.0에 추가. | 예 | |
쓰기 차단 및 완료를 위해 리샤딩 작업을 강제로 수행합니다. 버전 5.0에 추가. | 예 | |
샤드 컬렉션의 밸런서 설정을 구성합니다. 버전 5.3에 추가. | 예 | |
컬렉션에 대한 쿼리 샘플링을 구성합니다. 버전 7.0에 추가. | 예 | |
데이터베이스를 생성합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
서버리스 인스턴스는 지원하지 않습니다. | ||
샤딩된 클러스터의 상태를 보고하는 내부 명령입니다. | M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다. | |
프로세스가 mongos 인지 확인합니다. | 예 | |
구성된 샤드 목록을 반환합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
샤드 간에 청크를 마이그레이션하는 내부 명령입니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
샤딩된 클러스터에서 샤드를 제거할 때 기본 샤드를 재할당합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
샤드 간 범위를 이동합니다. | 예 | |
주어진 컬렉션에 대해 샤드가 소유한 모든 병합 가능한 청크를 병합합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
단일 샤드에 청크를 결합하는 기능을 제공합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
기존 키에 접미사를 추가하여 컬렉션의 샤드 키를 구체화합니다. | ||
샤딩된 클러스터에서 샤드를 제거하는 프로세스를 시작합니다. | ||
서버리스 인스턴스는 지원하지 않습니다. | ||
컬렉션의 샤드 키를 변경하는 리샤딩 작업을 시작하여 데이터 배포를 변경합니다. 버전 5.0에 추가. | 예 | |
컬렉션에서 새로운 자동 마이그레이션을 방지합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
컬렉션에 대한 샤딩 기능을 활성화하여 컬렉션을 샤딩할 수 있습니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
mongod 가 샤딩된 클러스터의 구성원인지 여부를 보고합니다. | 예 | |
새로운 청크를 생성합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
분할 지점을 결정하는 내부 명령입니다. | 예 | |
구성 샤드로 실행할 전용 Config 서버를 구성합니다. 버전 8.0에 추가 되었습니다. | ||
전용 Config 서버로 실행할 구성 샤드를 구성합니다. 버전 8.0에 추가 되었습니다. | ||
MongoDB 5.0에서 제거되었습니다. MongoDB 배포에서 인스턴스 간 연결에 영향을 주는 내부 명령입니다. | 예 | |
예 | ||
서버리스 인스턴스는 지원하지 않습니다. |
세션 명령
명령 | 설명 | Atlas 지원 |
---|---|---|
트랜잭션을 중단합니다. | 예 | |
트랜잭션을 커밋합니다. | 예 | |
세션 제한 시간 전에 세션을 만료합니다. | 예 | |
모든 세션을 종료합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
지정된 패턴과 일치하는 모든 세션 종료 | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
지정된 세션을 종료합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
유휴 세션을 새로 고칩니다. | 예 | |
새 세션을 시작합니다. | 예 |
관리 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
비고정 사이즈 컬렉션을 새로운 고정 사이즈 컬렉션으로 복사합니다. | M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다. | |
컬렉션에 옵션을 추가하거나 뷰 정의를 수정합니다. | 예 | |
컬렉션을 조각 모음하고 인덱스를 다시 빌드합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
상태 컬렉션에 지정된 문서를 압축하고 중복 문서를 삭제합니다. | 예 | |
비고정 사이즈 컬렉션을 고정 사이즈 컬렉션으로 변환합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
컬렉션 또는 뷰를 만듭니다. | 예 | |
컬렉션에 대해 하나 이상의 인덱스를 작성합니다. | 예 | |
데이터베이스 인스턴스에 대해 진행 중인 작업에 대한 정보가 포함된 문서를 반환합니다. | 예 | |
데이터베이스에서 지정된 컬렉션을 제거합니다. | 예 | |
현재 데이터베이스를 제거합니다. | 예 | |
지정된 호스트 목록에 대한 발신 연결을 제거합니다. | 예 | |
컬렉션에서 인덱스를 제거합니다. | 예 | |
예 | ||
보류 중인 쓰기를 스토리지 계층으로 플러시하고 백업을 허용하도록 데이터베이스를 잠급니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
하나의 fsync 락을 해제합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
배포에 대한 전역 기본 읽기 및 쓰기 고려 옵션을 검색합니다. | 예 | |
클러스터의 모든 노드에서 클러스터 매개변수 값을 검색합니다. 버전 6.0에 추가. | 예 | |
Retrieves configuration options. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | |
컬렉션에 대해 지정된 커서를 종료합니다. | 예 | |
작업 ID에 지정된 대로 작업을 종료합니다. | M0, M2, M5 및 M10 클러스터에 대한 지원이 제한됩니다. | |
현재 데이터베이스에 있는 컬렉션의 목록을 반환합니다. | 예 | |
모든 데이터베이스를 나열하고 기본 데이터베이스 통계를 반환하는 문서를 반환합니다. | 예 | |
컬렉션의 모든 인덱스를 나열합니다. | 예 | |
단일 파일이 너무 많은 공간을 차지하지 않도록 MongoDB 로그를 회전합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
컬렉션의 모든 인덱스를 다시 작성합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
기존 컬렉션의 이름을 변경합니다. | 예 | |
온라인 TLS 인증서 로테이션을 수행합니다. | 예 | |
이전 버전과 호환되지 않는 데이터를 보존하는 기능을 사용하거나 사용하지 않도록 설정합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
프라이머리가 해당 인덱스를 준비 상태로 표시하기 전에 진행 중인 인덱스 빌드을 커밋하기 위해 투표해야 하는 최소 데이터 보유 노드 수(즉, 커밋 쿼럼)를 변경합니다. | 예 | |
복제본 세트 또는 샤딩된 클러스터의 모든 노드에 대한 구성 옵션을 수정합니다. 버전 6.0에 추가. | 예 | |
구성 옵션을 수정합니다. | M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | |
배포에 대한 전역 기본 읽기 및 쓰기 쓰기 고려 옵션을 설정합니다. | 예 | |
클러스터 전체에 대한 쓰기를 차단하고 차단을 해제합니다. | No | |
M0, M2, M5 및 M10 클러스터는 지원되지 않습니다. | ||
데이터베이스 또는 컬렉션의 저장된 메타데이터가 특정 API 버전 내에서 유효한지 확인합니다. 버전 5.0에 추가. | 예 |
진단 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
MongoDB 빌드에 대한 통계를 표시합니다. | 예 | |
지정된 컬렉션에 대한 스토리지 활용 통계를 보고합니다. | 예 | |
이 MongoDB 인스턴스에서 배포의 다른 MongoDB 인스턴스로 나가는 연결에 대한 통계를 보고합니다. | 예 | |
현재 연결에 대한 인증 상태를 보고합니다. | 예 | |
데이터 범위의 데이터 크기를 반환합니다. 내부용입니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
데이터베이스와 해당 컬렉션의 해시값을 반환합니다. | M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다. | |
지정된 데이터베이스에 대한 스토리지 활용도 통계를 보고합니다. | M0, M2및 M5 클러스터에 대한 지원이 제한됩니다. | |
다양한 작업의 실행에 대한 정보를 반환합니다. | 예 | |
MongoDB 인스턴스에 대한 런타임 인수와 구문 분석된 옵션이 포함된 문서를 반환합니다. | 예 | |
최근 로그 메시지를 반환합니다. | 예 | |
기본 호스트 시스템을 반영하는 데이터를 반환합니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
현재 mongod 인스턴스에서 제공하는 모든 데이터베이스 명령을 나열합니다. | 예 | |
현재 보유 중이거나 보류 중인 잠금에 대한 정보를 반환하는 내부 명령입니다. mongod 인스턴스 에만 사용할 수 있습니다. | M0, M2 및 M5 클러스터는 지원되지 않습니다. | |
배포 내 연결을 테스트하는 내부 명령입니다. | 예 | |
데이터베이스 프로파일러용 인터페이스입니다. | 예 | |
인스턴스 전체의 리소스 사용률 및 상태에 대한 컬렉션 메트릭을 반환합니다. | 예 | |
MongoDB 5.0에서 제거되었습니다. 대신 connPoolStats 를 사용하세요. | 서버리스 인스턴스는 지원하지 않습니다. | |
mongod 인스턴스의 각 데이터베이스에 대한 원시 사용량 통계를 반환합니다. | 서버리스 인스턴스는 지원하지 않습니다. | |
컬렉션의 데이터와 인덱스의 정확성을 검사하는 내부 명령입니다. | M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다. | |
현재 클라이언트에 대한 정보를 반환하는 내부 명령입니다. | 예 |
감사 명령
이름 | 설명 | MongoDB Atlas 지원 |
---|---|---|
No | ||
감사 로그에 사용자 지정 메시지를 게시합니다. | 예 | |
No |
Atlas Search 명령
버전 7.0에 새로 추가됨: (6.0.7부터 사용 가능)
이름 | 설명 |
---|---|
지정된 컬렉션에 하나 이상의 Atlas Search 인덱스를 만듭니다. | |
기존 Atlas Search 인덱스를 삭제합니다. | |
기존의 Atlas Search 인덱스를 업데이트합니다. |