setClusterParameter
정의
setClusterParameter
setClusterParameter
는 클러스터 매개변수 값을 수정하기 위한 관리 명령입니다. 클러스터 매개변수는 복제본 세트 또는 샤딩된 클러스터의 모든 노드에 영향을 주는 구성 가능한 매개변수입니다.admin
데이터베이스에 대해setClusterParameter
명령을 실행해야 합니다.setClusterParameter
명령은 자체 관리형 설치에서만 사용할 수 있습니다. MongoDB Atlas에서는setClusterParameter
명령을 사용할 수 없습니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
db.adminCommand( { setClusterParameter: { <parameter>: <value> } } )
예제를 포함하여 사용 가능한 클러스터 매개 변수는 자체 관리형 배포서버를 위한 클러스터 매개변수를 참조하세요.
행동
admin
데이터베이스에서는setClusterParameter
만 실행할 수 있습니다. 다른 데이터베이스에서 명령을 실행하면 MongoDB에서 오류를 반환합니다.복제본 세트 프라이머리 또는 샤드 클러스터에서만
setClusterParameter
를 실행할 수 있습니다.독립형 배포에서는
setClusterParameter
를 실행할 수 없습니다 .setClusterParameter
한 번에 하나의 매개변수만 허용합니다.
액세스 제어
인증 이 활성화되면 setClusterParameter
은(는) setClusterParameter
작업에 액세스할 수 있는 역할이 있는 사용자로 인증된 경우에만 작동합니다.
지속성
setClusterParameter
을(를) 사용하여 수정한 매개변수는 복제본 세트와 샤드 cluster에 유지됩니다. 이렇게 하면 setClusterParameter
을(를) 사용하여 수정한 매개변수가 재시작 후에도 계속 유지됩니다.
Stable API
apiStrict가 true
로 설정된 Stable API V1을 사용하는 경우 setClusterParameter
를 사용하여 서버 매개변수를 수정할 수 없습니다.