데이터베이스 명령

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

현재 데이터베이스에 대해 명령을 실행하려면 db.runCommand() 을(를) 사용하십시오.

db.runCommand( { <command> } )

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

db.adminCommand( { <command> } )

참고

구문 및 예시를 포함하여 특정 명령에 대한 자세한 내용을 보려면 명령 참조 페이지 링크를 클릭합니다.

명령 구문

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

db.runCommand( { hello: 1 } )

사용자 명령

집계 명령

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

쿼리 및 쓰기 작업 명령

이름	설명	MongoDB Atlas 지원
`bulkWrite`	한 번의 요청으로 여러 컬렉션에 대한 여러 삽입, 업데이트, 삭제 작업을 수행합니다. 버전 8.0에 추가 되었습니다.	예
`delete`	하나 이상의 문서를 삭제합니다.	예
`find`	컬렉션 또는 보기에서 문서를 선택합니다.	무료 및 Flex 클러스터는 제한적으로 지원됩니다.
`findAndModify`	단일 문서를 반환하고 수정합니다.	예
`insert`	하나 이상의 문서를 삽입합니다.	예
`update`	하나 이상의 문서를 업데이트합니다.	예

쿼리 계획 캐시 명령

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

데이터베이스 작업

Authentication Commands

이름	설명	MongoDB Atlas 지원
`authenticate`	사용자 이름과 비밀번호를 사용하여 인증된 세션을 시작합니다.	무료 및 Flex 클러스터는 지원되지 않습니다.
`logout`	현재 인증된 세션을 종료합니다.	예

사용자 관리 명령

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

역할 관리 명령

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

복제 명령

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

팁

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

샤딩 명령

이름	설명	MongoDB Atlas 지원
`abortReshardCollection`	리샤딩 작업을 중단합니다.	예
`abortMoveCollection`	진행 중인 `moveCollection` 작업을 중지합니다. 버전 8.0에 추가 되었습니다.	Atlas 무료 및 Flex 계층지원 되지 않습니다.
`abortUnshardCollection`	진행 중인 `unshardCollection` 작업을 중지합니다. 버전 8.0에 추가 되었습니다.	Atlas 무료 및 Flex 계층지원 되지 않습니다.
`addShard`	샤딩된 클러스터에 샤드를 추가합니다.	예
`addShardToZone`	샤드를 영역 과 연결합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	예
`analyzeShardKey`	샤드 키를 평가하기 위한 메트릭을 계산합니다. 버전 7.0에 추가 되었습니다.	예
`balancerCollectionStatus`	샤드된 컬렉션의 청크가 균형을 이루고 있는지에 대한 정보를 반환합니다.	예
`balancerStart`	밸런서 스레드를 시작합니다.	예
`balancerStatus`	밸런서 상태에 대한 정보를 반환합니다.	예
`balancerStop`	밸런서 스레드를 중지합니다.	예
`checkMetadataConsistency`	샤딩 메타데이터에 대한 일련의 일관성 검사를 수행합니다. 버전 7.0에 추가 되었습니다.	예
`clearJumboFlag`	청크의 `jumbo` 플래그를 지웁니다.	예
`cleanupOrphaned`	밸런서를 비활성화하지 않고 샤드에서 고아 문서를 제거합니다. 버전 8.0부터 더 이상 사용되지 않습니다.	무료 및 Flex 클러스터는 지원되지 않습니다.
`cleanupReshardCollection`	Cleans up a failed resharding operation.	예
`commitReshardCollection`	쓰기 차단 및 완료를 위해 리샤딩 작업을 강제로 수행합니다.	예
`configureCollectionBalancing`	샤드 컬렉션의 밸런서 설정을 구성합니다.	예
`configureQueryAnalyzer`	컬렉션에 대한 쿼리 샘플링을 구성합니다. 버전 7.0에 추가 되었습니다.	예
`enableSharding`	데이터베이스를 생성합니다.	예
`flushRouterConfig`	`mongod` 2} / 인스턴스를 강제로 / 인스턴스가 캐시된 라우팅 메타데이터를 업데이트하도록 합니다.`mongos`	예
`getShardMap`	샤딩된 클러스터의 상태를 보고하는 내부 명령입니다.	무료 및 Flex 클러스터는 지원되지 않습니다.
`isdbgrid`	프로세스가 `mongos` 인지 확인합니다.	예
`listShards`	구성된 샤드 목록을 반환합니다.	예
`moveChunk`	샤드 간에 청크를 마이그레이션하는 내부 명령입니다.	예
`moveCollection`	샤딩되지 않은 단일 컬렉션 을 다른 샤드 로 이동합니다.	예
`movePrimary`	샤딩된 클러스터에서 샤드를 제거할 때 기본 샤드를 재할당합니다.	예
`moveRange`	샤드 간 범위를 이동합니다.	예
`mergeAllChunksOnShard`	주어진 컬렉션에 대해 샤드가 소유한 모든 병합 가능한 청크를 병합합니다.	예
`mergeChunks`	단일 샤드에 청크를 결합하는 기능을 제공합니다.	예
`refineCollectionShardKey`	기존 키에 접미사를 추가하여 컬렉션의 샤드 키를 구체화합니다.	M10 클러스터는 지원되지 않습니다.
`removeShard`	샤딩된 클러스터에서 샤드를 제거하는 프로세스를 시작합니다.	M10 클러스터는 지원되지 않습니다.
`removeShardFromZone`	샤드와 영역 간의 연결을 제거합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	예
`reshardCollection`	컬렉션의 샤드 키를 변경하는 리샤딩 작업을 시작하여 데이터 배포를 변경합니다.	예
`setAllowMigrations`	컬렉션에서 새로운 자동 마이그레이션을 방지합니다.	예
`shardCollection`	컬렉션에 대한 샤딩 기능을 활성화하여 컬렉션을 샤딩할 수 있습니다.	예
`shardingState`	`mongod` 가 샤딩된 클러스터의 구성원인지 여부를 보고합니다.	예
`split`	새로운 청크를 생성합니다.	예
`transitionFromDedicatedConfigServer`	구성 샤드로 실행할 전용 Config 서버를 구성합니다. 버전 8.0에 추가 되었습니다.	Atlas 무료 및 Flex 계층지원 되지 않습니다.
`transitionToDedicatedConfigServer`	전용 Config 서버로 실행할 구성 샤드를 구성합니다. 버전 8.0에 추가 되었습니다.	Atlas 무료 및 Flex 계층지원 되지 않습니다.
`unsetSharding`	MongoDB 5.0에서 제거되었습니다. MongoDB 배포에서 인스턴스 간 연결에 영향을 주는 내부 명령입니다.	예
`unshardCollection`	기존 샤딩된 컬렉션을 분할하여 컬렉션 데이터를 단일 샤드로 옮깁니다. 컬렉션의 샤딩을 해제하면 컬렉션을 여러 개의 샤드로 분할할 수 없고 분할 키가 제거됩니다. 버전 8.0에 추가 되었습니다.	예
`updateZoneKeyRange`	분할된 데이터 범위와 영역 간의 연결을 추가하거나 제거합니다. 샤딩된 클러스터의 영역 구성을 지원합니다.	예

팁

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

세션 명령

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

관리 명령

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

진단 명령

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

감사 명령

이름	설명	MongoDB Atlas 지원
`logApplicationMessage`	감사 로그에 사용자 지정 메시지를 게시합니다.	예

Atlas Search

버전 7.0의 새로운 기능: ( 6.0.7부터 사용 가능)

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

돌아가기

국가 및 언어 설정 및 기본 매개변수

planCacheClear