getParameter
정의
getParameter
getParameter
은(는) 매개변수 값을 검색하기 위한 관리 명령입니다.db.adminCommand( { command } )
메서드를 사용하여admin
데이터베이스 에서getParameter
명령을 실행 합니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0, M2 및 M5 클러스터에서 제한적으로 지원 됩니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.adminCommand( { getParameter: <value>, <parameter> : <value>, comment: <any> } )
명령 필드
이 명령은 다음 필드를 사용합니다.
필드 | 유형 | 설명 |
---|---|---|
getParameter | int, 문자열, 문서 | 다음 값을 지정합니다.
|
<parameter> | 문자열 | 검색할 매개변수의 문자열 이름입니다.
|
comment | any | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
행동
getParameter
는 admin
데이터베이스에서만 실행되며 다른 데이터베이스에서 실행하면 오류를 반환합니다.
<parameter>
에 사용할 수 있는 값은 사용 중인 버전 및 storage engine 에 따라 달라질 수 있습니다. 사용 가능한 매개변수 목록의 예는 모든 매개변수 조회 를 참조하세요.
예시
Retrieve Single Parameter
다음 작업은 admin
데이터베이스에서 saslHostName
값을 사용하여 getParameter
를 실행하여 해당 매개변수의 값을 검색합니다.
db.adminCommand( { getParameter : 1, "saslHostName" : 1 } )
이 명령은 다음 출력을 반환합니다.
참고
출력은 MongoDB 인스턴스의 버전 및 특정 구성에 따라 달라질 수 있습니다.
{ "saslHostName" : "www.example.net:27018", "ok" : 1 }
Retrieve All Parameters
다음 작업은 '*'
값으로 getParameter
를 실행하여 모든 매개변수를 조회합니다.
db.adminCommand( { getParameter : '*' } )
참고
출력은 MongoDB의 버전과 실행 중인 MongoDB 인스턴스의 특정 구성에 따라 달라질 수 있습니다.
단일 매개변수에 대한 세부 정보 보고
다음 예시에서는 getParameter
{showDetails: true}
saslHostName
와 함께 { 를 실행하여 에 대한 세부 정보 를 보고 .
db.adminCommand( { getParameter : { showDetails: true }, "saslHostName" : 1 } )
출력 예시:
{ saslHostName: { value: '<hostname>', settableAtRuntime: false, settableAtStartup: true }, ok: 1 }
참고
출력은 MongoDB 인스턴스의 버전 및 특정 구성에 따라 달라질 수 있습니다.
모든 매개변수에 대한 세부 정보 보고
다음 예제에서는 getParameter
와 {showDetails: true, allParameters: true}
함께 { 를 실행하여 모든 매개변수에 대한 세부 정보 를 보고합니다.
db.adminCommand( { getParameter : { showDetails: true, allParameters: true } } )
Retrieve All Startup Parameters
버전 8.0에 추가 되었습니다.
다음 예시 에서는 getParameter
명령을 실행하여 모든 스타트업 매개변수를 조회 합니다.
db.adminCommand( { getParameters: { allParameters: true, setAt: "startup" } } )
Retrieve All Runtime Parameters
버전 8.0에 추가 되었습니다.
다음 예시 에서는 getParameter
명령을 실행하여 모든 런타임 매개변수를 조회 합니다.
db.adminCommand( { getParameters: { allParameters: true, setAt: "runtime" } } )