문서 메뉴

문서 홈 → 보기 & 데이터 분석 → MongoDB Shell

구성 파일을 사용하여 설정 구성

이 페이지의 내용

  • 구성 파일 형식
  • 구성 파일 위치
  • 구성 가능한 설정
  • config API를 사용한 동작

전역 구성 파일에서 mongosh 설정을 지정할 수 있습니다. 구성 파일에 설정을 지정하면 해당 설정은 시작 시 적용됩니다. 구성 파일을 만든 후에는 다음에 mongosh 을(를) 시작할 때 파일의 설정이 적용됩니다.

구성 파일 형식

mongosh 구성 파일은 YAML 형식을 사용합니다. 모든 옵션은 mongosh 네임스페이스 아래에 있습니다.

구성 파일 예시

구성 파일 세트는 다음과 같습니다.

  • displayBatchSize 50으로

  • inspectDepth 20으로

  • redactHistory to remove-redact

mongosh:
  displayBatchSize: 50
  inspectDepth: 20
  redactHistory: "remove-redact"

구성 파일 위치

mongosh 가 구성 파일을 찾는 파일 위치는 운영 체제에 따라 다릅니다.

운영 체제
파일 위치
Windows
mongosh.cfg바이너리와 동일한 디렉토리에 mongosh.exe 있습니다.
macOS

mongosh 은(는) 나열된 순서대로 다음 디렉토리에서 구성 파일을 찾습니다.

  1. /usr/local/etc/mongosh.conf

  2. /opt/homebrew/etc/mongosh.conf

  3. /etc/mongosh.conf

mongosh 가 이러한 디렉토리 중 하나에서 구성 파일을 읽으면 목록에 있는 나머지 디렉토리를 확인하지 않고 해당 디렉토리의 구성 파일을 무시합니다.

Linux
/etc/mongosh.conf

구성 가능한 설정

구성 파일에서 다음 mongosh 설정을 지정할 수 있습니다.

키
유형
기본값
설명
displayBatchSize
integer
20
커서 반복당 표시되는 항목 수
enableTelemetry
부울
true
MongoDB에 익명화된 추적 및 진단 데이터를 보낼 수 있습니다.
editor
문자열
null
mongosh 콘솔 내에서 사용할 편집기를 지정합니다. 환경 변수가 설정되어 있으면 EDITOR 환경 변수를 재정의합니다.
forceDisableTelemetry
부울
false
글로벌 구성 파일에서만 사용할 수 있습니다. true인 경우 사용자는 원격 측정을 수동으로 활성화할 수 없습니다.
historyLength
integer
1000
mongosh REPL의 히스토리 파일에 저장할 항목 수입니다.
inspectCompact
정수 또는 부울
3

mongosh가 한 줄에 출력하는 내부 요소의 레벨입니다. 짧은 배열 요소도 한 줄로 그룹화됩니다.

false로 설정하면 mongosh는 각 필드를 자체 행에 출력합니다.

inspectDepth
정수 또는 무한대
6
객체가 출력되는 깊이입니다. inspectDepth를 Infinity(javascript 객체)로 설정하면 중첩된 모든 객체가 전체 깊이에 출력됩니다.
redactHistory
문자열
remove

셸 기록에 어떤 정보를 기록할지 제어합니다. 다음 중 하나여야 합니다.

  • keep: 모든 기록을 유지합니다.

  • remove: 민감한 정보가 포함된 줄을 제거합니다.

  • remove-redact: 민감한 정보를 삭제합니다.

showStackTraces
부울
false
오류 메시지와 함께 스택 추적의 표시를 제어합니다.
snippetAutoload
부울
true
true인 경우 시작 시 설치된 스니펫을 자동으로 로드합니다.
snippetIndexSourceURLs
문자열
MongoDB 리포지토리
스니펫 레지스트리에 연결되는 세미콜론으로 구분된 URL 목록입니다.
snippetRegistryURL
문자열
npm 레지스트리
스니펫을 설치하는 mongosh npm 클라이언트에서 사용하는 npm 레지스트리입니다.

config API를 사용한 동작

config API로 지정된 설정:

  • 구성 파일에 지정된 설정을 재정의합니다.

  • 재시작 시에도 유지됩니다.

예제

inspectDepth 설정을 20 로 설정하는 다음 구성 파일을 고려하세요.

mongosh:
  inspectDepth: 20

mongosh 세션 중에 다음 명령을 실행하여 inspectDepth 을 10 로 설정합니다.

config.set( "inspectDepth", 10 )

의 값은 inspectDepth 10 10 이 mongosh 되며 을 다시 시작하더라도 상태로 유지됩니다.

← API를 사용하여 설정 구성
사용자 지정 mongosh 프롬프트 →

이 페이지의 내용