getClusterParameter
정의
getClusterParameter
getClusterParameter
는 클러스터 매개변수 의 값을 검색하기 위한 관리 명령입니다. 클러스터 매개변수는 샤딩된 클러스터 의 모든 노드에 영향을 미치는 구성 가능한 매개변수입니다.getClusterParameter
을(를) 실행하려면db.adminCommand( { command } )
메서드를 사용합니다.getClusterParameter
명령은 자체 관리형 설치에서만 사용할 수 있습니다. MongoDB Atlas에서는getClusterParameter
명령을 사용할 수 없습니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 대한 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.adminCommand( { getClusterParameter: <parameter> | [<parameter>, <parameter>] | "'*'" } )
명령 필드
이 명령은 다음 필드를 사용합니다.
필드 | 유형 | 설명 |
---|---|---|
<parameter> | 문자열 또는 문자열 배열 | 다음 중 하나를 지정할 수 있습니다.
|
행동
admin
데이터베이스에서는getClusterParameter
만 실행할 수 있습니다. 다른 데이터베이스에서 명령을 실행하면 MongoDB에서 오류를 반환합니다.복제본 세트 또는 샤드 클러스터의 모든 노드에서
getClusterParameter
를 실행할 수 있습니다.mongod
에서getClusterParameter
를 실행하면getClusterParameter
는 캐시된 매개변수 값을 반환합니다.에서 를
getClusterParameter
실행하면 는mongos
getClusterParameter
config 서버 에서 cluster 매개변수의 지속형 값을 반환합니다.
액세스 제어
인증 이 활성화되면 getClusterParameter
은(는) getClusterParameter
작업에 액세스할 수 있는 역할이 있는 사용자로 인증된 경우에만 작동합니다.
예시
참고
다음 예제의 출력은 실행 중인 MongoDB deployment의 특정 구성에 따라 달라질 수 있습니다.
단일 cluster 매개변수 조회
다음 작업은 hostName
값을 사용하여 admin
데이터베이스에서 getClusterParameter
을 실행하여 hostName
이라는 가상의 cluster 매개변수의 값을 조회합니다.
use admin db.adminCommand( { getClusterParameter : "hostName" } )
여러 cluster 매개변수 조회
다음 작업은 hostName
및 testParameter
값을 사용하여 admin
데이터베이스에서 getClusterParameter
을 실행하여 hostName
및 testParameter
라는 가상의 cluster 매개변수의 값을 조회합니다.
use admin db.adminCommand( { getClusterParameter: [ "hostName", "testParameter" ] } )
모든 cluster 매개변수 조회
다음 작업은 '*'
값으로 getClusterParameter
를 실행하여 모든 cluster 매개변수에서 값을 검색합니다.
use admin db.adminCommand( { getClusterParameter : '*' } )