Mongo.startSession()

정의

Mongo.startSession(<options>)

버전 3.6에 새로 추가되었습니다.

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

중요

Mongo쉬 방법

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

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

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

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

Mongo 셸 V4.4

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

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

필드	설명
causalConsistency	부울. 세션의 인과적 일관성 을 활성화하거나 비활성화합니다. Mongo.startSession() 는 기본적으로 causalConsistency 를 활성화합니다. 세션을 시작한 후에는 causalConsistency 설정을 수정할 수 없습니다. 참고 Mongo() 연결 객체의 인과적 일관성이 비활성화되었거나 그 반대의 경우에도 세션에서는 인과적 일관성이 활성화되었을 수 있습니다. 연결 객체에 인과적 일관성을 설정하려면 Mongo.setCausalConsistency()를 참조하세요.
readConcern	문서입니다. 읽기 고려를 지정합니다. 세션을 시작한 후 설정을 수정하려면 Session.getOptions().setReadConcern()을 참조하세요.
읽기 설정	문서입니다. 읽기 설정을 지정합니다. 읽기 설정 문서에는 mode 필드와 선택 사항인 tags 필드가 포함되어 있습니다. { mode: <string>, tags: <array> } 세션을 시작한 후 설정을 수정하려면 Session.getOptions().setReadPreference()을 참조하세요.
쓰기 재시도	부울입니다. 일시적인 네트워크 오류 발생 시 쓰기를 재시도하는 기능을 활성화하거나 비활성화합니다. mongosh --retryWrites 옵션으로retryWrites 를 시작하면 에 대해 가 Mongo.startSession() 기본적으로 활성화됩니다 세션을 시작한 후에는 retryWrites 설정을 수정할 수 없습니다.
쓰기 고려	문서입니다. 쓰기 고려를 지정합니다. 세션을 시작한 후 설정을 수정하려면 Session.getOptions().setWriteConcern()을 참조하세요.

예제

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

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