명령줄 옵션

이 페이지의 내용

정의

Compass 실행 위치
구문
옵션
자세히 알아보기

명령줄 옵션을 사용하여 MongoDB Compass를 사용자 지정할 수 있습니다.

정의

명령줄에서 MongoDB Compass를 시작하고 설정 옵션을 설정할 수 있습니다. 명령줄을 사용하여 구성 옵션을 설정하면 시작 시 옵션이 설정됩니다. 명령줄 옵션을 사용하여 구성된 설정은 Compass 인터페이스에서 수정할 수 없습니다.

Compass 실행 위치

Compass 실행 파일의 이름과 위치는 운영 체제에 따라 다릅니다.

운영 체제

실행 파일 이름

위치

Linux

mongodb-compass

설치 프로그램이 /usr/bin 디렉토리에 설치합니다.

Windows

MongoDBCompass.exe

설치 프로그램은 설치 프로세스 중에 선택한 폴더에 이를 설치합니다.

macOS

MongoDB Compass

설치 프로그램은 애플리케이션 폴더 아래에 설치합니다:

/Applications/MongoDB\ Compass.app/Contents/MacOS/MongoDB\ Compass

구문

다음 구문을 사용하여 MongoDB Compass를 시작하고 구성 옵션을 설정합니다.

<path-to-Compass-executable> --<option>

옵션

명령줄 전용

이러한 옵션은 명령줄에서만 설정할 수 있습니다. 이러한 옵션은 Settings 패널이나 Compass 구성 파일에서는 설정할 수 없습니다.

설정	정의
`--exportConnections`	즐겨찾기 연결을 내보냅니다.
`--help`	MongoDB Compass 옵션을 표시합니다.
`--importConnections`	즐겨찾는 연결을 가져옵니다.
`--passphrase`	내보낸 즐겨찾기 연결 출력 파일을 암호화하기 위한 암호를 지정합니다. 가져온 즐겨찾기 연결 파일의 암호를 해독하기 위한 암호를 지정합니다.
`--showExampleConfig`	Compass 구성 파일 예시를 제공합니다.
`--trustedConnectionString`	허용되지 않는 연결 문자열 속성에 대한 경고를 표시하지 않고 자동 연결을 허용합니다. Compass는 명령줄에서 전달된 연결 문자열을 검사하고, 연결 문자열에 보안 위험을 초래할 수 있는 매개 변수가 포함되어 있는지 확인합니다. 이 옵션은 알려진 신뢰할 수 있는 연결 문자열을 Compass에 전달하는 경우에만 설정하세요.
`--version`	MongoDB Compass 버전을 표시합니다.

일반 설정

이러한 옵션은 명령줄, 구성 파일 또는 Settings 패널에서 설정할 수 있습니다. 명령줄에서 옵션을 설정하면 Settings 패널의 값이 재정의됩니다.

설정	정의
`--autoUpdates`	자동 업데이트를 활성화합니다. 자동 업데이트를 비활성화하려면 `--no-autoUpdates`를 사용합니다.
`--browserCommandForOIDCAuth`	서버에 연결하거나 Atlas Cloud 계정에 로그인할 때 OIDC 인증을 위해 브라우저를 시작할 shell 명령을 지정합니다.
`--enableFeedbackPanel`	피드백 패널을 활성화합니다. 자동 업데이트를 사용하지 않으려면 `--no-enableFeedbackPanel`을 사용합니다.
`--enableDevTools`	Compass에서 Chrome 개발자 도구를 활성화합니다. 자세히 알아보려면 Chrome 개발자 도구 토글을 참조하세요.
`--enableMaps`	MongoDB Compass가 타사 매핑 서비스에 요청하도록 허용합니다. 매핑 요청을 사용하지 않으려면 `--no-enableMaps`를 사용합니다.
`--enableShell`	Compass에서 임베디드된 MongoDB Shell을 활성화 또는 비활성화합니다. 자세한 내용은 임베디드 MongoDB Shell 비활성화를 참조하세요.
`--file <file>`	MongoDB Compass가 시작되면 자동으로 사용할 수 있는 연결 목록이 포함된 파일을 지정합니다.
`--forceConnectionOptions`	Compass를 통해 MongoDB 배포에 연결할 때 사용할 연결 옵션 값을 지정합니다. Compass 인터페이스의 연결이나 명령줄 연결 문자열로 이러한 연결 옵션을 재정의할 수 없습니다. 자세한 내용은 읽기 설정 및 태그 지정을 참조하세요.
`--ignoreAdditionalCommandLineFlags`	추가 명령줄 플래그를 허용합니다.
`--installURLHandlers`	Compass를 mongodb:// 및 mongodb+srv:// URL의 핸들러로 등록합니다. Install Compass as URL Protocol Handler 이 활성화된 경우, 인터넷 브라우저에서 mongodb:// 또는 mongodb+srv:// URL로 이동하여 Compass를 열 수 있습니다. macOS 및 Windows에서 사용할 수 있습니다.
`--maxTimeMS`	모든 Compass 데이터베이스 작업에 대한 시간 제한 상한을 지정합니다.
`--networkTraffic`	발신 네트워크 작업만 데이터베이스에 연결할 수 있도록 MongoDB Compass를 구성합니다. 자세한 내용은 발신 네트워크 연결 차단을 참조하세요.
`--password`	연결 문자열에 제공된 Compass 및 MongoDB 배포에 대한 인증용 비밀번호를 지정합니다. `--username`과 함께 사용하세요.
`--persistOIDCTokens`	MongoDB 서버 연결에 MongoDB OIDC 인증 메커니즘을 사용할 때 로그인 상태를 유지할 수 있습니다. 세션 토큰은 시스템 키체인을 사용하여 암호화되고 저장됩니다.
`--protectConnectionStrings`	모든 연결 문자열을 읽기 전용으로 설정합니다. 연결 문자열의 비밀번호는 `*****`로 표시됩니다. `protectConnectionStrings`가 활성화되면 Compass는 Edit connection string 옵션을 비활성화하고 Edit connection string 토글을 숨깁니다. 자세히 알아보려면 연결 문자열에서 자격 증명 숨기기를 참조하세요.
`--protectConnectionStringsForNewConnections`	기본적으로 새 연결에 대한 연결 문자열을 읽기 전용으로 설정합니다. 새 연결 문자열의 비밀번호는 `*****`로 표시됩니다. `protectConnectionStringsForNewConnections`가 활성화된 경우 Compass는 Edit connection string 옵션을 비활성화하지만 사용자가 Edit connection string 토글을 사용해 옵션을 수동으로 활성화하는 것을 방지하지는 않습니다.
`--readOnly`	사용자가 Compass를 통해 MongoDB 배포에 대한 쓰기 작업을 수행하지 못하도록 합니다. 자세히 알아보려면 MongoDB에 대한 쓰기 작업 제한을 참조하세요.
`--showInsights`	스키마 및 쿼리에 대한 성능 인사이트를 활성화합니다. 자세히 알아보려면 성능 인사이트를 참조합니다.
`--showKerberosPasswordField`	Compass 연결 양식에서 Kerberos 비밀번호 필드를 표시하거나 숨깁니다. 자세한 내용은 Kerberos 비밀번호 필드 표시를 참조하세요.
`--showOIDCDeviceAuthFlow`	MongoDB 서버에서 OIDC 인증을 위한 장치 인증 흐름을 활성화합니다. 이는 브라우저 기반 인증을 사용할 수 없을 때 대체 수단으로 사용할 수 있는 덜 안전한 인증 흐름을 사용하도록 설정합니다.
`--theme`	MongoDB Compass UI 테마를 지정합니다. 지원되는 테마는 `DARK`, `LIGHT`, `OS_THEME`입니다.
`--trackUsageStatistics`	사용량 통계 전송을 활성화합니다. 사용량 통계 전송을 사용하지 않으려면 `--no-trackUsageStatistics`를 사용합니다.
`--username`	연결 문자열에 제공된 Compass 및 MongoDB 배포에 대한 인증을 위한 사용자 이름을 지정합니다. 원하는 경우 `--password` 와 함께 사용합니다

참고

사용 가능한 모든 Compass 구성 옵션을 보려면 MongoDB Compass 실행 파일이 들어 있는 폴더에서 다음 명령을 실행하세요.

<path-to-Compass-executable> --help

자세히 알아보기

돌아가기

인터페이스 설정

구성 파일 설정