트랜잭션

트랜잭션에서 컬렉션 및 인덱스 생성

트랜잭션이 교차 샤드 쓰기 트랜잭션(write transaction)이 아닌 경우 분산 트랜잭션에서 다음 작업을 수행할 수 있습니다.

• 컬렉션을 생성합니다.

• 동일한 트랜잭션에서 이전에 생성된 새로운 빈 컬렉션에 인덱스를 생성.

트랜잭션 내에서 컬렉션을 만들 때

• 다음과 같이 컬렉션을 암시적으로 만들 수 있습니다.

  • 존재하지 않는 컬렉션에 대한 삽입 작업 또는

  • 존재하지 않는 컬렉션에 대해 upsert: true을(를) 사용하여 업데이트/findAndModify 작업을 수행합니다.

• db.createCollection() 명령 또는 create 해당 도우미 을 사용하여 컬렉션을 명시적으로 만들 수 있습니다.

트랜잭션 내부에 인덱스를 생성 할 때 [1], 생성할 인덱스는 둘 중 하나에 있어야 합니다.

• 존재하지 않는 컬렉션입니다. 컬렉션은 작업의 일부로 생성됩니다.

• 동일한 트랜잭션에서 이전에 생성된 새 빈 컬렉션입니다.

카운트 연산

트랜잭션 내에서 카운트 연산을 수행하려면 $count 집계 단계 또는 $group($sum 표현식 포함) 집계 단계를 사용합니다.

MongoDB 드라이버는 $sum 표현식과 함께 $group를 사용하여 카운트를 수행하는 헬퍼 메서드로서 컬렉션 수준 API countDocuments(filter, options)을 제공합니다. count() API는 더 이상 사용되지 않습니다.

mongosh 는 db.collection.countDocuments() 표현식과 함께 를 사용하여 $group $sum 카운트를 수행하는 헬퍼 메서드를 제공합니다.

차별화된 운영

트랜잭션 내에서 고유한 작업을 수행합니다.

• 샤드되지 않은 컬렉션의 경우, db.collection.distinct() 메서드/distinct 명령과 $group 단계의 aggregation pipeline을 사용할 수 있습니다.리

• 샤드된 컬렉션의 경우 db.collection.distinct() 메서드 또는 distinct 명령을 사용할 수 없습니다.

  샤딩된 컬렉션의 고유 값을 찾으려면 대신 $group 단계의 집계 파이프라인을 사용합니다. 예를 들면 다음과 같습니다.

  • db.coll.distinct("x")0} 대신 다음을 사용합니다.

    db.coll.aggregate([
       { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
       { $project: { _id: 0 } }
    ])

  • db.coll.distinct("x", { status: "A" })0} 대신 다음을 사용합니다.

    db.coll.aggregate([
       { $match: { status: "A" } },
       { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
       { $project: { _id: 0 } }
    ])

  파이프라인은 문서에 커서를 반환합니다.

  { "distinctValues" : [ 2, 3, 1 ] }

  커서를 반복하여 결과 문서에 액세스합니다.

정보 운영

2} buildInfo,helloconnectionStatus , 과 같은 정보 명령(및 그 도우미 메서드) (및 해당 헬퍼 메서드)와 같은 정보 명령은 트랜잭션에서 허용되지만, 트랜잭션의 첫 번째 연산이 될 수는 없습니다.

제한된 작업

트랜잭션에서 허용되지 않는 작업은 다음과 같습니다.

• 다중 샤드 쓰기 트랜잭션에서 새로운 컬렉션을 생성하기. 예를 들어 하나의 샤드에서 기존 컬렉션에 쓰고 다른 샤드에 암시적으로 컬렉션을 생성하는 경우 MongoDB는 동일한 트랜잭션에서 두 작업을 모두 수행할 수 없습니다.

• 컬렉션(예: db.createCollection() 메서드) 및 인덱스(예: db.collection.createIndexes() 및 db.collection.createIndex() 메서드)의 생성을 "local" 이외의 읽기 고려 수준을 사용하는 경우 명시합니다.

• listCollections 2} 및 명령과 해당 도우미 메서드.listIndexes

• createUser, getParameter, count 등과 해당 헬퍼와 같은 기타 비 CRUD 및 비 정보 작업입니다.

트랜잭션 및 읽기 환경설정

트랜잭션의 작업에는 트랜잭션 수준 읽기 기본 설정이 사용됩니다.

드라이버를 사용하면 트랜잭션 시작 시 트랜잭션 수준 읽기 기본 설정을 지정할 수 있습니다.

• 트랜잭션 수준 읽기 설정이 지정되지 않은 경우 트랜잭션은 세션 수준 읽기 설정을 사용합니다.

• 트랜잭션 수준 및 세션 수준 읽기 설정이 설정되지 않은 경우 트랜잭션은 클라이언트 수준 읽기 설정을 사용합니다. 기본적으로 클라이언트 수준 읽기 설정은 primary입니다.

읽기 작업이 포함된 분산 트랜잭션 은 읽기 설정 primary 을 사용해야 합니다. 특정 트랜잭션의 모든 작업은 동일한 멤버로 라우팅되어야 합니다.

트랜잭션 및 읽기 우려

트랜잭션의 작업은 트랜잭션 수준 읽기 고려 (read concern)를 사용합니다. 즉, 컬렉션 및 데이터베이스 수준에서 설정된 읽기 고려 (read concern)는 트랜잭션 내부에서 무시됩니다.

트랜잭션 시작 시 트랜잭션 수준의 읽기 문제를 설정할 수 있습니다.

• 트랜잭션 수준 읽기 고려 (read concern)가 설정되지 않은 경우 트랜잭션 수준 읽기 고려는 기본적으로 세션 수준 읽기 고려로 설정됩니다.

• 트랜잭션 수준 및 세션 수준 읽기 고려 (read concern)가 설정되지 않은 경우, 트랜잭션 수준 읽기 고려 (read concern)는 기본적으로 클라이언트 수준 읽기 고려 (read concern)로 설정됩니다. 기본적으로 클라이언트 수준 읽기 고려 (read concern)는 프라이머리 읽기에서 "local"입니다. 다음도 참조하세요.

  • 트랜잭션 및 읽기 환경설정

  • 기본 MongoDB 읽기 고려/쓰기 고려

트랜잭션은 다음과 같은 읽기 고려 수준을 지원합니다.

트랜잭션 및 쓰기 고려

트랜잭션은 트랜잭션 수준 쓰기 고려 (write concern)를 사용하여 쓰기 (write) 작업을 커밋합니다. 트랜잭션 내부의 쓰기 (write) 작업은 명시적인 쓰기 고려 (write concern) 지정 없이 실행되어야 하며 기본값 쓰기 고려 (write concern)를 사용해야 합니다. 커밋 시 트랜잭션 수준 쓰기 고려 (write concern)를 사용하여 쓰기 (write)가 커밋됩니다.

트랜잭션 시작 시 트랜잭션 수준 쓰기 문제를 설정할 수 있습니다.

• 트랜잭션 수준 쓰기 고려 (write concern)가 설정되지 않은 경우, 트랜잭션 수준 쓰기 고려는 커밋에 대한 세션 수준 쓰기 고려를 기본값으로 사용합니다.

• 트랜잭션 수준 쓰기 고려 (write concern)와 세션 수준 쓰기 고려가 설정되지 않은 경우 트랜잭션 수준 쓰기 고려는 기클라이언트 수준 쓰기 고려를 기본값으로 사용합니다.

  • MongoDB 5.0의w: "majority" 및 그 이상에서는 중재자가 포함된 배포의 경우 차이가 있습니다. 암시적 기본 쓰기 문제를 참조하세요.

  • w: 1

트랜잭션은 다음을 포함한 모든 쓰기 고려 w 값을 지원합니다.

프로덕션 고려 사항

프로덕션 환경에서의 트랜잭션에 대해서는 프로덕션 고려 사항을 참조하세요. 또한 샤드 클러스터의 경우 프로덕션 고려 사항(샤드 클러스터)을 참조하세요.

중재자

쓰기 작업이 여러 샤드에 걸쳐 있는 트랜잭션은 트랜잭션 작업 중 어떤 것이든 중재자가 포함된 샤드에서 읽거나 쓰는 경우 오류를 발생시키고 중단됩니다.

샤드 구성 제한

writeConcernMajorityJournalDefault가 false로 설정된 샤드가 있는 샤딩된 클러스터에서는 트랜잭션을 실행할 수 없습니다. (예: 인메모리 스토리지 엔진을 사용하는 투표 멤버가 있는 샤드)

진단

트랜잭션 상태 및 지표를 얻으려면 다음 메서드를 사용하세요.

기능 호환 버전(fCV)

트랜잭션을 사용하려면 디플로이먼트의 모든 멤버에 대한 FeatureCompatibilityVersion이 최소한 다음과 같아야 합니다.

멤버의 fCV를 확인하려면 해당 멤버에 연결하고 다음 명령을 실행하세요.

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

자세한 내용은 setFeatureCompatibilityVersion 도움말 페이지를 참조하세요.

스토리지 엔진

분산 트랜잭션 은 복제본 세트 및 샤드 클러스터에서 지원됩니다.

• 프라이머리는 WiredTiger 스토리지 엔진을 사용합니다.

• 보조 멤버는 와이어드타이거 스토리지 엔진 또는 인메모리 스토리지 엔진을 사용합니다.

중요 구간 대기 시간 제한

MongoDB 5.2(및 5.0.4)부터 시작됩니다.

• 쿼리가 분할된 데이터베이스에 액세스할 때 청크 마이그레이션 또는 DDL 작업은 컬렉션에 대한 중요한 섹션을 보유할 수 있습니다.

• 샤드가 트랜잭션 내 중요 섹션까지 대기하는 시간을 제한하려면 metadataRefreshInTransactionMaxWaitBehindCritSecMS 매개변수를 사용하세요.