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

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

구성 파일 형식

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

구성 파일 예시

다음의 구성 파일이 설정하는 것:

displayBatchSize 50에
inspectDepth 20에
redactHistory to remove-redact

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

구성 파일 위치

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

운영 체제	파일 위치
Windows	`mongosh.cfgmongosh.exe` 바이너리와 동일한 디렉토리 에 있습니다.
macOS	`mongosh` 은(는) 나열된 순서대로 다음 디렉토리에서 구성 파일 을 찾습니다. `/usr/local/etc/mongosh.conf` `/opt/homebrew/etc/mongosh.conf` `/etc/mongosh.conf` `mongosh` 가 이러한 디렉토리 중 하나에서 구성 파일 을 읽으면 목록에 있는 나머지 디렉토리를 확인하지 않고 해당 디렉토리의 구성 파일을 무시합니다.
Linux	`/etc/mongosh.conf`

구성 가능한 설정

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

키	유형	기본값	설명
`disableLogging`	부울	`false`	MongoDB Shell 로그 항목을 작성할지 여부를 지정합니다.
`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 객체)로 설정하면 중첩된 모든 객체가 전체 깊이에 출력됩니다.
`logCompressionEnabled`	부울	거짓	MongoDB Shell 로그 파일을 압축할지 여부를 지정합니다. 이 값이 `true`이면 MongoDB Shell gzip을 사용하여 로그를 압축합니다. 로그 압축 활성화를 참조하세요.
`logLocation`	문자열	운영 체제에 따라 다릅니다. 셸 로그 보기를 참조하세요.	MongoDB Shell 로그 파일을 작성하는 디렉토리입니다. 절대 파일 경로를 지정합니다. 로그 파일 위치 지정을 참조하세요.
`logMaxFileCount`	정수 또는 무한대	100	MongoDB Shell 보관하는 최대 로그 파일 수입니다. MongoDB Shell 최대 로그 파일 수에 도달하면 해당 수가 임계값 아래에 도달할 때까지 가장 오래된 로그 파일을 삭제하기 시작합니다. 최대 로그 파일 수 수정을 참조하세요.
`logRetentionDays`	정수 또는 무한대	30	MongoDB Shell 로그 파일이 보관되는 일수입니다. 이 값을 `Infinity`로 설정하다 하면 보존 기간에 따라 로그 파일이 삭제되지 않습니다. 로그 저장 너무 커지는 것을 방지하려면 항상 로그 보존 기준을 하나 이상 지정합니다. 로그 보존을 참조하세요.
`logRetentionGB`	float 또는 무한대	Unset	MongoDB Shell 로그에 사용되는 최대 공간(GB)입니다. MongoDB Shell 로그의 총합이 이 값을 초과하면 가장 오래된 로그부터 로그 파일이 삭제됩니다. 이 값을 `Infinity`로 설정하다 하면 저장 크기에 따라 로그 파일이 삭제되지 않습니다. 로그 저장 너무 커지는 것을 방지하려면 항상 로그 보존 기준을 하나 이상 지정합니다. 로그 보존을 참조하세요.
`redactHistory`	문자열	`remove`	`mongosh` 명령 기록에 기록되는 정보를 제어합니다. 셸 내부에서 위쪽 및 아래쪽 키 또는 Ctrl+ R 통해 `mongosh` 명령 기록에 액세스 할 수 있습니다. 다음 값 중 하나여야 합니다. `keep`: 모든 기록을 유지합니다. `remove`: 기록에서 민감한 명령이 포함된 줄을 제거합니다. 예시 를 들어 `remove` 는 db.auth() 또는 connect()에 대한 호출을 제거합니다. `remove-redact`: 민감한 명령이 포함된 줄을 제거하고 파일 경로, 이메일 주소, URL과 같은 다른 기록 줄의 특정 문자열을 삭제합니다.
`showStackTraces`	부울	`false`	오류 메시지와 함께 스택 추적의 표시를 제어합니다.
`snippetAutoload`	부울	`true`	`true`인 경우 시작 시 설치된 스니펫을 자동으로 로드합니다.
`snippetIndexSourceURLs`	문자열	MongoDB 리포지토리	스니펫 레지스트리에 연결되는 세미콜론으로 구분된 URL 목록입니다.
`snippetRegistryURL`	문자열	npm 레지스트리	스니펫을 설치하는 `mongosh` npm 클라이언트에서 사용하는 npm 레지스트리입니다.

API 를 `config` 사용한 동작

다음은 config API로 지정된 설정입니다.

구성 파일에 지정된 설정을 재정의합니다.
재시작 시에도 유지됩니다.

예시

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

mongosh:
  inspectDepth: 20

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

config.set( "inspectDepth", 10 )

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

돌아가기

API 사용

프롬프트 사용자 지정

구성 파일 형식

구성 파일 예시

구성 파일 위치

구성 가능한 설정

API 를 config 사용한 동작

예시

API 를 `config` 사용한 동작