옵션

일반 옵션

--build-info

JSON 형식의 문서와 mongosh 빌드 및 드라이버 종속성에 대한 정보를 반환합니다.

예시: 빌드 정보 보기

터미널에서 다음 명령을 실행하여 mongosh 바이너리의 빌드 정보 및 드라이버 종속성을 확인할 수 있습니다:

mongosh --build-info

이 명령은 다음과 같은 JSON 형식의 문서를 반환합니다.

{
  version: '1.10.1',
  distributionKind: 'packaged',
  buildArch: 'x64',
  buildPlatform: 'linux',
  buildTarget: 'unknown',
  buildTime: '2023-06-21T09:49:37.225Z',
  gitVersion: '05ad91b4dd40382a13f27abe1ae8c3f9f52a38f7',
  nodeVersion: 'v16.20.1',
  opensslVersion: '3.1.1',
  sharedOpenssl: true,
  runtimeArch: 'x64',
  runtimePlatform: 'darwin',
  deps: {
     nodeDriverVersion: '5.6.0'
   }
}

--eval <javascript>

JavaScript 표현식을 평가합니다. 단일 --eval 인수를 사용하거나 여러 개의 --eval 인수를 함께 사용할 수 있습니다.

mongosh는 인수를 평가한 후 --eval 결과를 명령줄에 인쇄합니다. --eval 성명서를 여러 개 사용하는 경우 mongosh는 마지막 --eval 결과만 인쇄합니다.

--eval과 함께 --json 플래그를 사용하여 확장 JSON 형식으로 mongosh 결과를 반환할 수 있습니다. mongosh는 --json=canonical 및 --json=relaxed 모드를 모두 지원합니다. 모드를 생략하면 mongosh 기본값은 canonical 모드입니다. --json 플래그는 --shell과 상호 배타적입니다.

예시: 형식 출력

자동 구문 분석에 적합한 출력을 얻으려면 EJSON.stringify()를 사용합니다.

mongosh --quiet  --host rs0/centos1104 --port 27500 \
        --eval "EJSON.stringify(rs.status().members.map( \
          m => ({'id':m._id, 'name':m.name, 'stateStr':m.stateStr})));" \
| jq

jq로 구문 분석을 수행하면 다음과 같은 결과가 표시됩니다.

[
  {
     "id": 0,
     "name": "centos1104:27500",
     "stateStr": "PRIMARY"
  },
  {
     "id": 1,
     "name": "centos1104:27502",
     "stateStr": "SECONDARY"
  },
  {
     "id": 2,
     "name": "centos1104:27503",
     "stateStr": "SECONDARY"
  }
]

참고

EJSON 에는 서식 지정 옵션이 내장되어 jq와 같은 구문 분석기가 필요하지 않을 수 있습니다. 예를 들어, 다음 코드는 위와 동일한 형식의 결과를 생성합니다.

mongosh --quiet  --host rs0/centos1104 --port 27500 \
        --eval "EJSON.stringify( rs.status().members.map( \
          ({ _id, name, stateStr }) => ({ _id, name, stateStr })), null, 2);"

예: 다중 --eval 인수

moviesDatabase에서 컬렉션 목록을 확보하려면 여러 --eval 성명서를 사용합니다.

mongosh --quiet \
        --eval 'use moviesDatabase' \
        --eval 'show collections' \
        mongodb://localhost/

예: --json 옵션

여러 --eval 문을 사용하여 확장 JSON 형식으로 컬렉션의 통계를 반환하려면 다음을 수행합니다.

mongosh --quiet --json=relaxed \
        --eval 'use <database-name>' \
        --eval 'db.<collection>.stats()' \
        mongodb://localhost/

--file, -f <javascript>

MongoDB Shell 콘솔에 들어가지 않고 명령줄에서 스크립트를 실행합니다.

자세한 내용과 예제는 명령줄에서 스크립트 실행을 참조합니다.

--help, -h

MongoDB Shell의 옵션 및 사용에 대한 정보를 반환합니다.

--nodb

셸의 데이터베이스 인스턴스 연결을 방지합니다.

--no-quiet

비대화 셸 세션에 대해 기본값 옵션 모드 를 비활성화합니다. 이 --quiet mongosh 옵션을 지정하면 가 스타트업 시 모든 메시지를 표시합니다.

--norc

시작 시 셸의 ~/.mongoshrc.js 소싱 및 평가를 방지합니다.

--norc 또한 snippet install 명령으로 설치한 스니펫이 shell에 로드되지 않도록 합니다. 대신 snippet load-all 명령을 사용하여 스니펫을 로드할 수 있습니다. 자세한 내용은 스니펫 명령을 참조하세요.

--quiet

시작할 때 모든 메시지(예: 환영 메시지 및 시작 경고)를 건너뛰고 프롬프트로 바로 이동합니다.

비대화 셸 세션의 경우 MongoDB 기본값 으로 를 --quiet 활성화합니다.--no-quiet 을(를) 사용하여 이 동작을 비활성화할 수 있습니다.

--skipStartupWarnings

세션을 mongosh 생성할 때 가 서버 스타트업 경고를 표시하지 않도록 합니다. 모든 스타트업 메시지를 표시하지 않으려면 옵션을 --quiet 사용합니다.

--shell

셸 인터페이스를 활성화합니다.mongosh 명령을 호출하고 JavaScript 파일 인수로 지정하거나 --eval 를 사용하여 명령줄 에 JavaScript --shell 지정하는 경우 옵션은 파일 실행이 완료된 후 사용자에게 셸 프롬프트를 표시합니다.--shell 플래그는 --json 와 상호 배타적입니다.

--verbose

연결 프로세스가 진행되는 동안 또는 명령이 실행될 때 셸 결과의 상세도를 높입니다.

--version

MongoDB Shell 릴리스 번호를 반환합니다.

Stable API 옵션

--apiVersion <version number>

apiVersion을 "1" 지정합니다. 현재로서는 가 유일하게 지원되는 값입니다.

--apiStrict

애플리케이션이 Stable API 외부의 명령이나 동작을 사용하는 경우 서버가 APIStrictError 로 응답하도록 지정합니다.

--apiVersion를 --apiStrict지정하는 경우 도 지정해야 합니다.

--apiDeprecationErrors

애플리케이션 지정된 에서 더 이상 사용되지 않는 명령이나 동작을 사용하는 경우 서버 APIDeprecationError로 응답하도록 지정합니다.apiVersion

--apiVersion를 --apiDeprecationErrors지정하는 경우 도 지정해야 합니다.

연결 옵션

--host <hostname>

mongod 또는 mongos가 실행 중인 호스트 머신의 이름을 지정합니다. 지정하지 않으면 MongoDB Shell은 localhost에서 실행 중인 MongoDB 프로세스에 연결을 시도합니다.

다음을 수행하여 복제본 세트에 연결합니다.

및 설정하다 멤버의 시드 목록 지정합니다. 다음 양식을 사용합니다.replica set name

<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

TLS/SSL 연결의 경우(--tls),

MongoDB Shell은 호스트 이름(--host 옵션 또는 연결 문자열에서 지정)이 mongod 또는 mongos에서 제시하는 인증서의 SAN (SAN이 없는 경우 CN)과 일치하는지 확인합니다. SAN이 있는 경우 MongoDB Shell은 CN와 일치하지 않습니다. 호스트 이름이 SAN (또는 CN)과 일치하지 않으면 MongoDB Shell 연결에 실패합니다.

DNS 시드 목록 연결의 경우,

연결 프로토콜 mongodb+srv(으)로 지정하고 그 뒤에 DNS SRV 호스트 이름 기록 과 옵션을 지정합니다. authSource 및 replicaSet 옵션이 연결 문자열 에 포함된 경우, TXT 기록 에 설정하다 해당 DNS 구성 옵션을 재정의합니다. mongodb+srv: 연결 문자열 사용하면 클라이언트 연결에 TLS(일반적으로 tls=true로 설정하다 )가 암시적으로 활성화됩니다. 쿼리 문자열에서 tls=false을 설정하여 TLS 옵션을 해제할 수 있습니다.

예시

mongodb+srv://server.example.com/?connectionTimeoutMS=3000

--port <port>

또는 인스턴스 수신 대기 중인 포트를 mongod mongos 지정합니다. 를 --port 지정하지 않으면 MongoDB Shell 포트 27017 에 연결을 시도합니다.

인증 옵션

--authenticationDatabase <dbname>

지정된 가 생성된 --username 인증 데이터베이스 지정합니다. 인증 데이터베이스를 참조하세요.

값을 지정하지 않으면 MongoDB Shell 연결 문자열 에 지정된 데이터베이스 --authenticationDatabase 사용합니다.

--authenticationMechanism <name>

MongoDB Shellmongod또는mongos에 인증하는 데 사용하는 인증 메커니즘 을 지정합니다. authenticationMechanism을(를) 지정하지 않고 사용자 자격 증명 제공하는 경우, MongoDB Shell 및 드라이버는 SCRAM-SHA-256 사용을 시도합니다. 이 작업이 실패하면 SCRAM-SHA-1로 돌아갑니다.

값	설명
SCRAM-SHA-1	SHA- 해시 함수를 사용하는RFC 표준 솔티드 챌린지 응답 인증 메커니즘.5802 1
SCRAM-SHA-256	SHA- 해시 함수를 사용하는RFC 표준 솔티드 챌린지 응답 인증 메커니즘.7677 256 featureCompatibilityVersion이 4.0으로 설정되어야 합니다.
MONGODB-X509	MongoDB TLS 인증서 인증.
GSSAPI (Kerberos)	Kerberos를 사용한 외부 인증. 이 메커니즘은 MongoDB Enterprise에서만 사용할 수 있습니다.
PLAIN (LDAP SASL)	LDAP 사용한 외부 인증 . PLAIN 을(를) 사용하여 데이터베이스 내 사용자를 인증할 수도 있습니다. PLAIN 은(는) 비밀번호를 일반 텍스트로 전송합니다. 이 메커니즘은 MongoDB 엔터프라이즈 및 MongoDB Atlas 에서 사용할 수 있습니다.
MONGODB-OIDC (OpenID Connect)	OpenID Connect를 사용한 외부 인증 . 이 메커니즘은 MongoDB 엔터프라이즈 및 MongoDB Atlas 에서 사용할 수 있습니다.
MONGODB-AWS (Amazon Web Services IAM)	Amazon Web Services Identity and Access Management(Amazon Web Services IAM) 자격 증명 사용한 외부 인증 . 이 메커니즘은 MongoDB 엔터프라이즈 및 MongoDB Atlas 에서 사용할 수 있습니다.

--gssapiServiceName

GSSAPI/ Kerberos 사용하여 서비스 이름을 지정합니다. 서비스가 기본값 이름인 mongodb 를 사용하지 않는 경우에만 필요합니다.

이 옵션은 MongoDB Enterprise에서만 사용할 수 있습니다.

--sspiHostnameCanonicalization <string>

호스트 이름 표준화 사용 여부를 지정합니다.

는 연결 문자열 의 부분에서 authMechanismProperties 키 쌍을--sspiHostnameCanonicalization설정하는 것과 동일한 효과가 있습니다.CANONICALIZE_HOST_NAME:true|false

가 다음으로 설정하다 --sspiHostnameCanonicalization 경우:

• forwardAndReverse정방향 DNS 조회를 수행한 다음 역방향 조회를 수행합니다. mongosh 1.3.0에 추가되었습니다.

• forwardauthMechanismProperties=CANONICALIZE_HOST_NAME:true 설정과 효과가 동일합니다.

• noneauthMechanismProperties=CANONICALIZE_HOST_NAME:false 설정과 효과가 동일합니다.

--oidcFlows

OpenID Connect 흐름을 쉼표로 구분된 목록으로 지정합니다. OpenID Connect 흐름은 인증 프로세스를 위해 mongosh가 멱등과 상호 작용하는 방법을 지정합니다. mongosh는 다음 OpenID Connect 흐름을 지원합니다.

OpenID 연결 흐름	설명
auth-code	기본값. mongosh를 클릭하면 브라우저가 열리고 멱등 로그인 화면으로 리디렉션됩니다.
device-auth	mongosh 는 인증을 완료하기 위한 URL과 코드를 제공합니다. 이는 보안성이 낮은 OpenID Connect 흐름으로 간주되지만 mongosh가 브라우저를 열 수 없는 환경에서 실행될 때 사용할 수 있습니다

device-auth를 auth-code의 대체 옵션으로 설정하는 방법은 다음 예시에서 확인 가능합니다.

mongosh 'mongodb://localhost/' --authenticationMechanism MONGODB-OIDC --oidcFlows=auth-code,device-auth

--oidcDumpTokens

mongosh가 예비 디버깅 정보가 포함된 토큰을 출력할지 여부를 지정합니다. 이 옵션은 디버깅 용도로만 사용합니다.

--oidcDumpTokens 옵션은 다음과 같은 값을 허용합니다.

값	설명
redacted	--oidcDumpTokens만 설정할 때 기본값입니다. 민감한 정보가 삭제된 상태로 토큰 디버깅 정보를 출력합니다.
include-secrets	데이터베이스 서버에 인증할 수 있는 자격 증명을 포함하여 토큰 디버깅 정보를 출력합니다.

중요

include-secrets 값은 공격자가 인증에 사용할 수 있는 자격 증명을 노출합니다. 권한이 없는 사람이 mongosh의 출력을 볼 수 없고 진단 목적으로 자격 증명이 필요한 경우에만 이 옵션을 사용하세요.

--oidcIdTokenAsAccessToken

mongosh가 자격 증명 공급자로부터 받은 ID 토큰을 액세스 토큰 대신 사용하는지 여부를 지정합니다. JWT 액세스 토큰을 제공하도록 구성할 수 없는 자격 증명 공급자와 함께 이 옵션을 사용합니다.

--oidcNoNonce

기본값으로 mongosh 은 OIDC 권한 부여 코드 흐름 중에 논스 매개 변수를 전송합니다.

--oidcNoNonce 옵션을 설정하다 하면 mongosh 은 논스 매개변수를 전송하지 않습니다. 자격 증명 공급자 가 권한 부여 의 일부로 논스 값을 지원 하지 않는 경우 이 옵션을 사용합니다.

--oidcRedirectUri

인증 후 멱등이 사용자를 리디렉션할 URI를 지정합니다. URI는 멱등의 구성과 일치해야 합니다. 기본값은 http://localhost:27097/redirect입니다.

--oidcTrustedEndpoint

현재 연결이 Atlas 또는 localhost이(가) 아닌 신뢰할 수 있는 엔드포인트에 있음을 나타냅니다. 이렇게 하면 액세스 토큰이 서버 로 전송됩니다. 신뢰할 수 있는 서버에 연결할 때만 이 옵션을 사용합니다.

--browser

MONGODB-OIDC가 활성화된 경우 mongosh가 리디렉션하는 브라우저를 지정합니다.

이 옵션은 시스템 셸에서 실행됩니다.

브라우저 열기를 완전히 비활성화하려면 --no-browser 를 설정합니다.

--password <password>, -p <password>

인증 사용하는 MongoDB database 에 인증하는 데 사용할 비밀번호를 --username 지정합니다. 및 옵션과 함께 사용합니다.--authenticationDatabase

MongoDB Shell 비밀번호를 입력하라는 메시지를 표시하려면 마지막 옵션으로 옵션을 입력하고 인수를 --password 생략합니다.

--username <username>, -u <username>

인증 사용하는 MongoDB database 에 인증할 사용자 이름 --password 지정합니다. 및 옵션과 함께 사용합니다.--authenticationDatabase

세션 옵션

--retryWrites

재시도 가능 쓰기를 활성화합니다.

기본적으로 재시도 가능한 쓰기는 다음과 같습니다.

• 활성화됨 mongosh

• 레거시 mongo 셸에서 비활성화됨

재시도 가능 쓰기를 비활성화하려면 --retryWrites=false 를 사용합니다.

세션 정보는 클라이언트 세션 및 인과적 일관성 보장에서 확인하세요.

필드 레벨 암호화 옵션

--cryptSharedLibPath <string>

버전 8.2에 추가 되었습니다.

자동 암호화 공유 라이브러리의 경로입니다. 라이브러리는 8 2버전이.. 이상이어야 합니다.0 mongosh 셸 세션에 자동 암호화 사용하는 데 필요합니다.

--awsAccessKeyId <string>

AWS 키 관리 서비스(KMS )에 대한 List 및 권한이 있는 IAM 사용자와 Read mongosh 연결된 AWS 액세스 키입니다. 은(는) 지정된 을(를) 사용하여 --awsAccessKeyId KMS 에 액세스 .

셸 세션에 mongosh 대해 클라이언트 측 --awsAccessKeyId --awsAccessKeyId 필드 레벨 암호화 활성화 하려면 이(가) 필요합니다. 에는 다음 명령줄 옵션이 모두 필요합니다.

• --awsSecretAccessKey

• --keyVaultNamespace

--awsAccessKeyId가 생략된 경우 셸 세션 내에서 생성자를 사용하여 클라이언트 사이드 필드 수준 암호화 활성화 Mongo() .

액세스 키가 로그에 유출될 위험을 줄이려면 환경 변수를 로 지정하는 것이 --awsAccessKeyId 좋습니다.

--awsSecretAccessKey <string>

지정된 --awsAccessKeyId에 연결된 AWS 비밀 키입니다.

세션에 mongosh --awsSecretAccessKey 대해 클라이언트 측 --awsSecretAccessKey 필드 레벨 암호화 활성화 하려면 이(가) 필요합니다. 에는 다음 명령줄 옵션이 모두 필요합니다.

• --awsAccessKeyId

• --keyVaultNamespace

및 --awsSecretAccessKey 지원 옵션이 생략된 경우 셸 세션 내에서 를 사용하여 클라이언트 사이드 필드 수준 암호화 활성화 .Mongo()

액세스 키가 로그에 유출될 위험을 줄이려면 환경 변수를 로 지정하는 것이 --awsSecretAccessKey 좋습니다.

--awsSessionToken <string>

지정된 에 --awsAccessKeyId 연결된 AWS 세션 토큰입니다.

셸 세션에 mongosh 대해 클라이언트 측 --awsSessionToken --awsSessionToken 필드 레벨 암호화 활성화 하려면 이(가) 필요합니다. 에는 다음 명령줄 옵션이 모두 필요합니다.

• --awsAccessKeyId

• --awsSecretAccessKey

• --keyVaultNamespace

및 --awsSessionToken 지원 옵션이 생략된 경우 셸 세션 내에서 를 사용하여 클라이언트 사이드 필드 수준 암호화 활성화 .Mongo()

액세스 키가 로그에 유출될 위험을 줄이려면 환경 변수를 로 지정하는 것이 --awsSessionToken 좋습니다.

--keyVaultNamespace <string>

클라이언트 측 필드 레벨 암호화의 키 저장소로 사용되는 컬렉션의 전체 네임스페이스(<database>.<collection>)입니다. 셸--keyVaultNamespace mongosh 세션에 대해 클라이언트 측 필드 레벨 암호화를 활성화하려면 가 필요합니다. mongosh가 지정된 네임스페이스가 없는 경우 이를 생성합니다.

--keyVaultNamespace 에는 다음 명령줄 옵션이 모두 필요합니다.

• --awsAccessKeyId

• --awsSecretAccessKey

및 --keyVaultNamespace 지원 옵션이 생략된 경우 셸 세션 내에서 생성자를 사용하여 클라이언트 사이드 필드 수준 암호화 활성화 .Mongo()