Mongo.startSession() (mongosh 메서드)

정의

Mongo.startSession(<options>)

연결을 위한 세션을 시작합니다. 는 세션과 연결된 명령에 세션 ID mongosh 할당합니다.

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 데이터베이스 명령이나 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령에 대해서는 startSession 명령을 참조하십시오.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

세션은 세션을 생성한 MongoClient 객체에만 사용할 수 있습니다. 단일 세션은 동시에 사용할 수 없습니다. 단일 세션을 사용하는 작업은 순차적으로 실행해야 합니다.

startSession() 메서드는 세션 옵션이 있는 문서 가져올 수 있습니다. 사용 가능한 옵션은 다음과 같습니다.

필드

설명

causalConsistency

부울. 세션의 인과적 Mongo.startSession() 일관성 활성화하거나 causalConsistency 비활성화합니다.snapshot 는 기본값 으로 를 활성화합니다. 와 상호 배타적입니다.

세션을 시작한 후에는 causalConsistency 설정을 수정할 수 없습니다.

Mongo() 연결 객체의 인과적 일관성이 비활성화되었거나 그 반대의 경우에도 세션에서는 인과적 일관성이 활성화되었을 수 있습니다. 연결 객체에 인과적 일관성을 설정하려면 Mongo.setCausalConsistency()를 참조하세요.

readConcern

문서입니다. 읽기 고려를 지정합니다.

세션을 시작한 후 설정을 수정하려면 Session.getOptions().setReadConcern()을 참조하세요.

읽기 설정

문서입니다. 읽기 설정을 지정합니다.

읽기 설정 문서에는 mode 필드와 선택 사항인 tags 필드가 포함되어 있습니다.

{ mode: <string>, tags: <array> }

세션을 시작한 후 설정을 수정하려면 Session.getOptions().setReadPreference()을 참조하세요.

retryWrites

부울입니다. 일시적인 네트워크 오류 발생 시 쓰기를 재시도하는 기능을 활성화하거나 비활성화합니다.

세션을 시작한 후에는 retryWrites 설정을 수정할 수 없습니다.

스냅샷

부울. MongoDB 5.0+ 배포를 위한 세션의 스냅샷 읽기 를 활성화합니다. causalConsistency 와 상호 배타적입니다.

쓰기 고려

문서입니다. 쓰기 고려를 지정합니다.

세션을 시작한 후 설정을 수정하려면 Session.getOptions().setWriteConcern()을 참조하세요.

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하세요.

다음 항목은 의 글로벌 mongosh 변수와 연결된 연결 객체 에서 인과적 일관성 및 재시도 가능 쓰기가 활성화된 세션을 Mongo() db 시작합니다.

db = db.getMongo().startSession({retryWrites: true, causalConsistency: true}).getDatabase(db.getName());