/ /

클라이언트 수준 CRUD 설정 구성

개요

이 가이드 에서는 Java 운전자 사용하여 MongoClient 인스턴스에 대한 CRUD 작업을 구성하는 방법에 대해 학습 수 있습니다.

읽기 설정, 읽기 고려, 쓰기 고려는 드라이버가 읽기 작업을 라우팅하고 MongoDB 복제본 세트에 연결될 때 읽기 및 쓰기 작업에 대한 승인을 기다리는 방법을 제어합니다. 읽기 설정 및 읽기 고려는 모든 읽기 작업에 적용되고 쓰기 고려는 모든 쓰기 작업에 적용됩니다.

자세한 내용은 읽기 설정, 읽기 고려 및 쓰기 고려에 대한 서버 설명서를 참조하세요.

MongoDatabase MongoCollection 및 MongoClient 인스턴스는 액세스하는 로부터 기본 설정과 고려 사항을 상속합니다. 그러나 데이터베이스와 컬렉션에 사용자 지정 설정을 적용 할 수 있습니다. 자세한 내용은 사용자 지정 CRUD 설정 구성 페이지를 참조하세요.

연결 문자열 사용 하거나 MongoClientSettings 객체를 MongoClients 생성자에 전달하여 클라이언트 수준 CRUD 설정을 지정할 수 있습니다. Connection String 또는 MongoClientSettings 탭 선택하여 사용 가능한 옵션을 확인합니다.

드라이버의 읽기 또는 쓰기 (write) 동작을 수정하려면 연결 문자열 에 다음 매개 변수를 포함하세요.

옵션 이름	유형	설명
`journal`	부울	연결된 MongoDB 인스턴스가 모든 쓰기에 대해 디스크의 저널 파일을 그룹 커밋할 때까지 드라이버가 기다리도록 지정합니다. 기본값: `false`
`w`	문자열 또는 정수	쓰기 고려 (write concern) 지정합니다. 값에 대한 자세한 내용은 w 옵션에 대한 MongoDB Server 설명서를 참조하세요. 기본값: `1`
`wtimeoutMS`	integer	쓰기 고려 (write concern) 대한 시간 제한(밀리초)을 지정합니다. 자세한 내용은 wtimeoutMS 옵션에 대한 MongoDB Server 설명서를 참조하세요. `0` 값은 운전자 쓰기 (write) 작업의 시간을 초과하지 않도록 합니다. 기본값: `0`
`readPreference`	문자열	읽기 설정 (read preference) 지정합니다. 값에 대한 자세한 내용은 readPreference 옵션에 대한 MongoDB Server 설명서를 참조하세요. 기본값: `primary`
`readPreferenceTags`	문자열	읽기 설정 (read preference) 태그를 지정합니다. 값에 대한 자세한 내용은 readPreferenceTags 옵션에 대한 MongoDB Server 설명서를 참조하세요. 기본값: `null`
`maxStalenessSeconds`	integer	운전자 세컨더리 와의 통신을 중지하기 전에 세컨더리 부실한 상태가 될 수 있는 시간(초)을 지정합니다. 최소값은 90 초 또는 하트비트 빈도에 10 초를 더한 값 중 더 큰 값입니다. 자세한 내용은 maxStalenessSeconds 옵션에 대한 MongoDB Server 설명서를 참조하세요. 매개 변수를 제공하지 않거나 `-1` 를 명시적으로 지정하지 않으면 세컨더리에 대한 부실 상태 검사가 없어야 합니다. 기본값: `-1`
`uuidRepresentation`	문자열	읽기 및 쓰기 (write) 작업에 사용할 UUID 표현을 지정합니다. 자세한 내용은 MongoClientSettings.getUuidRepresentation() 메서드에 대한 운전자 설명서를 참조하세요. 기본값: `unspecified`
`retryWrites`	부울	지원되는 쓰기 작업을 네트워크 오류로 인해 완료할 수 없는 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: `true`
`retryReads`	부울	지원되는 읽기 작업을 네트워크 오류로 인해 완료할 수 없는 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: `true`

다음 예시 가장 가까운 복제본 세트 멤버에서 읽도록 읽기 설정 (read preference) 설정합니다.

ConnectionString connectionString = "mongodb://<host>:<port>/?readPreference=nearest"
MongoClient mongoClient = MongoClients.create(connectionString)

이러한 매개변수에 대한 자세한 내용은 ConnectionString API 설명서를 참조하세요.

드라이버의 읽기/ 쓰기 (write) 동작을 수정하려면 다음 메서드를 MongoClientSettings 생성자에 연결합니다.

`readConcern()`	읽기 고려 (read concern) 설정합니다. 서버 매뉴얼 페이지 API 문서
`readPreference()`	읽기 설정 (read preference)설정합니다. 기본값: `primary`
`retryReads()`	네트워크 오류 발생 시 드라이버가 읽기 재시도를 수행할지 여부입니다. 기본값: `true`
`retryWrites()`	네트워크 오류 발생 시 드라이버가 쓰기 재시도를 수행할지 여부입니다. 기본값: `true`
`uuidRepresentation()`	UUID 인스턴스를 인코딩하고 서브타입이 3인 BSON 바이너리 값을 디코딩할 때 사용할 UUID 표현을 설정합니다.
`writeConcern()`	쓰기 고려를 설정합니다. 기본값: `WriteConcern#ACKNOWLEDGED`. \| 기본값에 대한 자세한 내용은 암시적 기본 쓰기 고려를 참조하세요.

다음 예시 가장 가까운 복제본 세트 멤버에서 읽도록 읽기 설정 (read preference) 설정합니다.

MongoClient mongoClient = MongoClients.create(
        MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
                .readPreference(ReadPreference.nearest())
                .build());

이러한 메서드에 대한 자세한 내용은 MongoClientSettings.Builder API 문서를 참조하세요.

돌아가기

소켓 설정

네트워크 압축