데이터베이스 명령

이 페이지의 내용

명령 구문

사용자 명령
데이터베이스 작업
감사 명령
Atlas Search 명령

아래에 설명된 모든 명령어 문서는 명령어와 사용 가능한 매개변수에 대해 설명하고 각 명령어에 대한 문서 템플릿 또는 프로토타입을 제공합니다. 일부 명령 문서에는 관련 mongosh 헬퍼도 포함되어 있습니다.

현재 데이터베이스에 대한 명령을 실행하려면 db.runCommand()을 사용하세요.

db.runCommand( { <command> } )

admin 데이터베이스에 대해 관리 명령을 실행하려면 db.adminCommand() 을(를) 사용하십시오.

db.adminCommand( { <command> } )

참고

구문과 예시 등 특정 명령에 대한 자세한 내용을 보려면 특정 명령을 클릭하여 해당 참조 페이지로 이동하세요.

명령 구문

데이터베이스 명령을 실행할 때 명령을 db.runCommand() 에 대한 문서로 지정합니다. 문서의 키는 실행할 명령이며 값은 일반적으로 1 으로 제공됩니다. 값은 명령 출력에 영향을 주지 않습니다. 예를 들면 다음과 같습니다.

db.runCommand( { hello: 1 } )

사용자 명령

집계 명령

이름	설명	MongoDB Atlas 지원
`aggregate`	집계 파이프라인을 사용하여 `$group`과 같은 집계 작업을 수행합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`count`	컬렉션 또는 보기 화면에 있는 문서 수를 계산합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`distinct`	컬렉션이나 뷰의 지정된 키에 대해 찾은 고유 값을 표시합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`mapReduce`	대규모 데이터 세트에 대해 맵 리듀스 집계를 수행합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.

지리 공간 명령

이름	설명	MongoDB Atlas 지원
`geoSearch`	MongoDB 5.0에서 제거되었습니다. MongoDB의 haystack 인덱스 기능을 사용하는 지리 공간적 쿼리를 수행합니다.	서버리스 인스턴스는 지원하지 않습니다.

쿼리 및 쓰기 작업 명령

이름	설명	MongoDB Atlas 지원
`delete`	하나 이상의 문서를 삭제합니다.	예
`find`	컬렉션 또는 보기에서 문서를 선택합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`findAndModify`	단일 문서를 반환하고 수정합니다.	예
`getMore`	현재 커서가 가리키고 있는 문서의 배치를 반환합니다.	예
`insert`	하나 이상의 문서를 삽입합니다.	예
`resetError`	MongoDB 5.0에서 제거되었습니다. 마지막 오류 상태를 초기화합니다.	No
`update`	하나 이상의 문서를 업데이트합니다.	예

쿼리 계획 캐시 명령

이름	설명	MongoDB Atlas 지원
`planCacheClear`	컬렉션에 대해 캐시된 쿼리 계획을 제거합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`planCacheClearFilters`	컬렉션의 인덱스 필터를 지웁니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`planCacheListFilters`	컬렉션의 인덱스 필터를 나열합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`planCacheSetFilter`	컬렉션에 대한 인덱스 필터를 설정합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.

데이터베이스 작업

Authentication Commands

이름	설명	MongoDB Atlas 지원
`authenticate`	사용자 이름과 비밀번호를 사용하여 인증된 세션을 시작합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`getnonce`	인증을 위해 일회성 비밀번호를 생성하는 내부 명령입니다.	예
`logout`	현재 인증된 세션을 종료합니다.	예

사용자 관리 명령

이름	설명	MongoDB Atlas 지원
`createUser`	새 사용자를 생성합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`dropAllUsersFromDatabase`	데이터베이스와 연결된 모든 사용자를 삭제합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`dropUser`	단일 사용자를 제거합니다.	M10 클러스터는 지원되지 않습니다.
`grantRolesToUser`	사용자에게 역할과 해당 권한을 부여합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`revokeRolesFromUser`	사용자로부터 역할을 제거합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`updateUser`	사용자 데이터를 업데이트합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`usersInfo`	지정된 사용자에 대한 정보를 반환합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.

역할 관리 명령

이름	설명	MongoDB Atlas 지원
`createRole`	역할을 생성하고 해당 권한을 지정합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`dropRole`	사용자 정의 역할을 삭제합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`dropAllRolesFromDatabase`	데이터베이스에서 모든 사용자 정의 역할을 삭제합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`grantPrivilegesToRole`	사용자 정의 역할에 권한을 할당합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`grantRolesToRole`	사용자 정의 역할이 권한을 상속 받을 역할을 지정합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`invalidateUserCache`	자격 증명 및 역할을 포함한 사용자 정보의 인메모리 캐시를 플러시합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`revokePrivilegesFromRole`	사용자 정의 역할에서 지정된 권한을 제거합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`revokeRolesFromRole`	사용자 정의 역할에서 지정된 상속된 역할을 제거합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`rolesInfo`	지정된 역할에 대한 정보를 반환합니다.	예
`updateRole`	사용자 정의 역할을 업데이트합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.

복제 명령

이름	설명	MongoDB Atlas 지원
`appendOplogNote`	작동하지 않는 항목을 oplog에 씁니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`applyOps`	oplog 항목을 현재 데이터 세트에 적용하는 내부 명령입니다.	서버리스 인스턴스는 지원하지 않습니다.
`hello`	기본인지 여부를 포함하여 복제본 세트에서 이 구성원의 역할에 대한 정보를 표시합니다.	예
`replSetAbortPrimaryCatchUp`	선출된 프라이머리가 동기화(따라잡기)를 중단한 후 프라이머리로 전환을 완료하도록 강제합니다.	예
`replSetFreeze`	현재 회원이 일정 기간 동안 예비선거로 선거에 출마하지 못하도록 합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`replSetGetConfig`	리플리카 세트의 구성 객체를 반환합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`replSetGetStatus`	복제본 세트의 상태를 보고하는 문서를 반환합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`replSetInitiate`	새 복제본 세트를 초기화합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`replSetMaintenance`	보조 노드를 `RECOVERING` 상태로 만드는 유지 관리 모드를 사용하거나 사용하지 않도록 설정합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`replSetReconfig`	기존 복제 세트에 새 구성을 적용합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`replSetResizeOplog`	복제본 집합 멤버에 대한 oplog의 크기를 동적으로 조정합니다. WiredTiger 스토리지 엔진에서만 사용할 수 있습니다.	M10 클러스터는 지원되지 않습니다.
`replSetStepDown`	현재 기본 후보가 물러나고 보조 후보가 되어 선거를 강제로 실시합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`replSetSyncFrom`	복제할 멤버를 선택하기 위한 기본 논리를 명시적으로 재정의합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.

팁

다음도 참조하세요.

복제에 관한 자세한 내용은 복제를 참조하세요.

샤딩 명령

이름	설명	MongoDB Atlas 지원
`abortReshardCollection`	리샤딩 작업을 중단합니다. 버전 5.0에 추가.	예
`addShard`	샤딩된 클러스터에 샤드를 추가합니다.	서버리스 인스턴스는 지원하지 않습니다.
`addShardToZone`	샤드를 영역 과 연결합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	서버리스 인스턴스는 지원하지 않습니다.
`balancerCollectionStatus`	샤드된 컬렉션의 청크가 균형을 이루고 있는지에 대한 정보를 반환합니다.	서버리스 인스턴스는 지원하지 않습니다.
`balancerStart`	밸런서 스레드를 시작합니다.	서버리스 인스턴스는 지원하지 않습니다.
`balancerStatus`	밸런서 상태에 대한 정보를 반환합니다.	서버리스 인스턴스는 지원하지 않습니다.
`balancerStop`	밸런서 스레드를 중지합니다.	서버리스 인스턴스는 지원하지 않습니다.
`clearJumboFlag`	청크의 `jumbo` 플래그를 지웁니다.	서버리스 인스턴스는 지원하지 않습니다.
`cleanupOrphaned`	분할된 데이터베이스가 소유한 청크 범위를 벗어나는 분할된 키 값을 가진 분리된 데이터를 제거합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`cleanupReshardCollection`	Cleans up a failed resharding operation. 버전 5.0에 추가.	예
`commitReshardCollection`	쓰기 차단 및 완료를 위해 리샤딩 작업을 강제로 수행합니다. 버전 5.0에 추가.	예
`configureCollectionBalancing`	샤드 컬렉션의 밸런서 설정을 구성합니다. 버전 5.3에 추가.	예
`enableSharding`	데이터베이스를 생성합니다.	서버리스 인스턴스는 지원하지 않습니다.
`flushRouterConfig`	`mongod` 2} / 인스턴스를 강제로 / 인스턴스가 캐시된 라우팅 메타데이터를 업데이트하도록 합니다.`mongos`	서버리스 인스턴스는 지원하지 않습니다.
`getShardMap`	샤딩된 클러스터의 상태를 보고하는 내부 명령입니다.	M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다.
`isdbgrid`	프로세스가 `mongos` 인지 확인합니다.	예
`listShards`	구성된 샤드 목록을 반환합니다.	서버리스 인스턴스는 지원하지 않습니다.
`moveChunk`	샤드 간에 청크를 마이그레이션하는 내부 명령입니다.	서버리스 인스턴스는 지원하지 않습니다.
`movePrimary`	샤딩된 클러스터에서 샤드를 제거할 때 기본 샤드를 재할당합니다.	서버리스 인스턴스는 지원하지 않습니다.
`moveRange`	샤드 간 범위를 이동합니다.	예
`mergeChunks`	단일 샤드에 청크를 결합하는 기능을 제공합니다.	서버리스 인스턴스는 지원하지 않습니다.
`refineCollectionShardKey`	기존 키에 접미사를 추가하여 컬렉션의 샤드 키를 구체화합니다.	M10 클러스터 및 서버리스 인스턴스는 지원되지 않습니다.
`removeShard`	샤딩된 클러스터에서 샤드를 제거하는 프로세스를 시작합니다.	M10 클러스터 및 서버리스 인스턴스는 지원되지 않습니다.
`removeShardFromZone`	샤드와 영역 간의 연결을 제거합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	서버리스 인스턴스는 지원하지 않습니다.
`reshardCollection`	컬렉션의 샤드 키를 변경하는 리샤딩 작업을 시작하여 데이터 배포를 변경합니다. 버전 5.0에 추가.	예
`setAllowMigrations`	컬렉션에서 새로운 자동 마이그레이션을 방지합니다.	서버리스 인스턴스는 지원하지 않습니다.
`shardCollection`	컬렉션에 대한 샤딩 기능을 활성화하여 컬렉션을 샤딩할 수 있습니다.	서버리스 인스턴스는 지원하지 않습니다.
`shardingState`	`mongod` 가 샤딩된 클러스터의 구성원인지 여부를 보고합니다.	예
`split`	새로운 청크를 생성합니다.	서버리스 인스턴스는 지원하지 않습니다.
`splitVector`	분할 지점을 결정하는 내부 명령입니다.	예
`unsetSharding`	MongoDB 5.0에서 제거되었습니다. MongoDB 배포에서 인스턴스 간 연결에 영향을 주는 내부 명령입니다.	예
`updateZoneKeyRange`	분할된 데이터 범위와 영역 간의 연결을 추가하거나 제거합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	서버리스 인스턴스는 지원하지 않습니다.

팁

다음도 참조하세요.

MongoDB의 샤딩 기능에 대한 자세한 내용은 샤딩을 참조하세요.

세션 명령

명령	설명	Atlas 지원
`abortTransaction`	트랜잭션을 중단합니다.	예
`commitTransaction`	트랜잭션을 커밋합니다.	예
`endSessions`	세션 제한 시간 전에 세션을 만료합니다.	예
`killAllSessions`	모든 세션을 종료합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`killAllSessionsByPattern`	지정된 패턴과 일치하는 모든 세션 종료	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`killSessions`	지정된 세션을 종료합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`refreshSessions`	유휴 세션을 새로 고칩니다.	예
`startSession`	새 세션을 시작합니다.	예

관리 명령

이름	설명	MongoDB Atlas 지원
`cloneCollectionAsCapped`	비고정 사이즈 컬렉션을 새로운 고정 사이즈 컬렉션으로 복사합니다.	M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다.
`collMod`	컬렉션에 옵션을 추가하거나 뷰 정의를 수정합니다.	예
`compact`	컬렉션을 조각 모음하고 인덱스를 다시 빌드합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`compactStructuredEncryptionData`	상태 컬렉션에 지정된 문서를 압축하고 중복 문서를 삭제합니다.	예
`convertToCapped`	비고정 사이즈 컬렉션을 고정 사이즈 컬렉션으로 변환합니다.	서버리스 인스턴스는 지원하지 않습니다.
`create`	컬렉션 또는 뷰를 만듭니다.	예
`createIndexes`	컬렉션에 대해 하나 이상의 인덱스를 작성합니다.	예
`currentOp`	데이터베이스 인스턴스에 대해 진행 중인 작업에 대한 정보가 포함된 문서를 반환합니다.	예
`drop`	데이터베이스에서 지정된 컬렉션을 제거합니다.	예
`dropDatabase`	현재 데이터베이스를 제거합니다.	예
`dropConnections`	지정된 호스트 목록에 대한 발신 연결을 제거합니다.	예
`dropIndexes`	컬렉션에서 인덱스를 제거합니다.	예
`filemd5`	GridFS를 사용하여 저장된 파일의 md5 해시를 반환합니다.	예
`fsync`	보류 중인 쓰기를 스토리지 계층으로 플러시하고 백업을 허용하도록 데이터베이스를 잠급니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`fsyncUnlock`	하나의 fsync 락을 해제합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`getDefaultRWConcern`	배포에 대한 전역 기본 읽기 및 쓰기 고려 옵션을 검색합니다.	예
`getClusterParameter`	클러스터의 모든 노드에서 클러스터 매개변수 값을 검색합니다. 버전 6.0에 추가.	예
`getParameter`	Retrieves configuration options.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`killCursors`	컬렉션에 대해 지정된 커서를 종료합니다.	예
`killOp`	작업 ID에 지정된 대로 작업을 종료합니다.	M0, M2, M5 및 M10 클러스터에 대한 지원이 제한됩니다.
`listCollections`	현재 데이터베이스에 있는 컬렉션의 목록을 반환합니다.	예
`listDatabases`	모든 데이터베이스를 나열하고 기본 데이터베이스 통계를 반환하는 문서를 반환합니다.	예
`listIndexes`	컬렉션의 모든 인덱스를 나열합니다.	예
`logRotate`	단일 파일이 너무 많은 공간을 차지하지 않도록 MongoDB 로그를 회전합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`reIndex`	컬렉션의 모든 인덱스를 다시 작성합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`renameCollection`	기존 컬렉션의 이름을 변경합니다.	예
`rotateCertificates`	온라인 TLS 인증서 로테이션을 수행합니다.	예
`setFeatureCompatibilityVersion`	이전 버전과 호환되지 않는 데이터를 보존하는 기능을 사용하거나 사용하지 않도록 설정합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`setIndexCommitQuorum`	프라이머리가 해당 인덱스를 준비 상태로 표시하기 전에 진행 중인 인덱스 빌드을 커밋하기 위해 투표해야 하는 최소 데이터 보유 노드 수(즉, 커밋 쿼럼)를 변경합니다.	예
`setClusterParameter`	복제본 세트 또는 샤딩된 클러스터의 모든 노드에 대한 구성 옵션을 수정합니다. 버전 6.0에 추가.	예
`setParameter`	구성 옵션을 수정합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`setDefaultRWConcern`	배포에 대한 전역 기본 읽기 및 쓰기 쓰기 고려 옵션을 설정합니다.	예
`setUserWriteBlockMode`	클러스터 전체에 대한 쓰기를 차단하고 차단을 해제합니다.	No
`shutdown`	`mongod` 또는 `mongos` 프로세스를 종료합니다.	M0, M2, M5 및 M10 클러스터는 지원되지 않습니다.
`validateDBMetadata`	데이터베이스 또는 컬렉션의 저장된 메타데이터가 특정 API 버전 내에서 유효한지 확인합니다. 버전 5.0에 추가.	예

진단 명령

이름	설명	MongoDB Atlas 지원
`buildInfo`	MongoDB 빌드에 대한 통계를 표시합니다.	예
`collStats`	지정된 컬렉션에 대한 스토리지 활용 통계를 보고합니다.	예
`connPoolStats`	이 MongoDB 인스턴스에서 배포의 다른 MongoDB 인스턴스로 나가는 연결에 대한 통계를 보고합니다.	예
`connectionStatus`	현재 연결에 대한 인증 상태를 보고합니다.	예
`dataSize`	데이터 범위의 데이터 크기를 반환합니다. 내부용입니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`dbHash`	데이터베이스와 해당 컬렉션의 해시값을 반환합니다.	M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다.
`dbStats`	지정된 데이터베이스에 대한 스토리지 활용도 통계를 보고합니다.	M0, M2및 M5 클러스터에 대한 지원이 제한됩니다.
`explain`	다양한 작업의 실행에 대한 정보를 반환합니다.	예
`getCmdLineOpts`	MongoDB 인스턴스에 대한 런타임 인수와 구문 분석된 옵션이 포함된 문서를 반환합니다.	예
`getLog`	최근 로그 메시지를 반환합니다.	예
`hostInfo`	기본 호스트 시스템을 반영하는 데이터를 반환합니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`listCommands`	현재 `mongod` 인스턴스에서 제공하는 모든 데이터베이스 명령을 나열합니다.	예
`lockInfo`	현재 보유 중이거나 보류 중인 잠금에 대한 정보를 반환하는 내부 명령입니다. `mongod` 인스턴스 에만 사용할 수 있습니다.	M0, M2 및 M5 클러스터는 지원되지 않습니다.
`ping`	배포 내 연결을 테스트하는 내부 명령입니다.	예
`profile`	데이터베이스 프로파일러용 인터페이스입니다.	예
`serverStatus`	인스턴스 전체의 리소스 사용률 및 상태에 대한 컬렉션 메트릭을 반환합니다.	예
`shardConnPoolStats`	MongoDB 5.0에서 제거되었습니다. 대신 `connPoolStats`를 사용하세요.	서버리스 인스턴스는 지원하지 않습니다.
`top`	`mongod` 인스턴스의 각 데이터베이스에 대한 원시 사용량 통계를 반환합니다.	서버리스 인스턴스는 지원하지 않습니다.
`validate`	컬렉션의 데이터와 인덱스의 정확성을 검사하는 내부 명령입니다.	M0, M2및 M5 클러스터 및 서버리스 인스턴스를 지원하지 않습니다.
`whatsmyuri`	현재 클라이언트에 대한 정보를 반환하는 내부 명령입니다.	예

감사 명령

이름	설명	MongoDB Atlas 지원
`getAuditConfig`	`mongod` 및 `mongos` 인스턴스에서 감사 구성을 검색합니다.	No
`logApplicationMessage`	감사 로그에 사용자 지정 메시지를 게시합니다.	예
`setAuditConfig`	런타임에 `mongod` 및 `mongos` 인스턴스에 대한 감사 구성을 설정합니다.	No

Atlas Search 명령

버전 6.0.7에 추가 되었습니다.

이름	설명
`createSearchIndexes`	지정된 컬렉션에 하나 이상의 Atlas Search 인덱스를 만듭니다.
`dropSearchIndex`	기존 Atlas Search 인덱스를 삭제합니다.
`updateSearchIndex`	기존의 Atlas Search 인덱스를 업데이트합니다.

돌아가기

연결 문자열 예시

집계