MongoDB Server 실행 시간 제한

허용되는 시간 초과 값

다음 표에서는 timeoutMS에 허용되는 값에 해당하는 시간 초과 동작을 설명합니다.

timeoutMS 옵션을 지정하면 운전자 각 서버 작업에 지정된 시간 제한을 자동으로 적용합니다. 다음 코드 예시 클라이언트 수준에서 200 밀리초의 시간 제한을 지정한 다음 MongoCollection.insertOne() 메서드를 호출합니다.

MongoClientSettings settings = MongoClientSettings.builder()
        .applyConnectionString(new ConnectionString("<connection string>"))
        .timeout(200L, MILLISECONDS)
        .build();
try (MongoClient mongoClient = MongoClients.create(settings)) {
    MongoDatabase database = mongoClient.getDatabase("db");
    MongoCollection<Document> collection = database.getCollection("people");
    collection.insertOne(new Document("name", "Francine Loews"));
}

시간 초과 상속

timeoutMS 옵션을 지정하면 운전자 다른 Java 운전자 옵션과 동일한 상속 동작에 따라 시간 초과를 적용합니다. 다음 표에서는 각 수준에서 시간 초과 값이 상속되는 방식에 대해 설명합니다.

재정의 및 특정 옵션에 대한 자세한 내용은 다음 재정의 섹션을 참조하세요.

트랜잭션

트랜잭션 구현 defaultTimeout() 위해 새 ClientSession 인스턴스 만드는 경우 인스턴스 빌드할 때 ClientSessionOptions 메서드를 사용합니다. 이 옵션을 사용하여 다음 메서드에 대한 시간 제한을 지정할 수 있습니다.

• commitTransaction()

• abortTransaction()

• withTransaction()

• close()

다음 코드는 ClientSession을 인스턴스화할 때 defaultTimeout 를 설정하다 방법을 보여줍니다.

ClientSessionOptions opts = ClientSessionOptions.builder()
        .defaultTimeout(200L, MILLISECONDS)
        .build();
ClientSession session = mongoClient.startSession(opts);
// ... perform operations on ClientSession

defaultTimeout를 지정하지 않으면 운전자 상위 MongoClient에 설정하다 시간 초과 값을 사용합니다.

TransactionOptions 인스턴스 빌드할 때 timeout() 메서드를 호출하여 트랜잭션 수준 시간 제한을 설정하다 수도 있습니다. 이 옵션을 설정하면 트랜잭션 범위에서 수행되는 모든 작업에 시간 초과가 적용됩니다.

TransactionOptions transactionOptions = TransactionOptions.builder()
        .timeout(200L, MILLISECONDS)
        .build();

트랜잭션에 대해 자세히 학습 트랜잭션 가이드 참조하세요.

클라이언트 암호화

클라이언트 측 필드 레벨 암호화 (CSFLE)를 사용하는 경우 운전자 timeoutMS 옵션을 사용하여 암호화 및 암호 해독 작업에 허용되는 시간을 제한합니다. ClientEncryptionSettings 인스턴스 빌드할 때 timeout() 메서드를 호출하여 ClientEncryption 인스턴스 에 대한 시간 초과 옵션을 설정하다 수 있습니다.

ClientEncryption 인스턴스 구성할 때 제한 시간을 지정하면 제한 시간이 해당 인스턴스 에서 수행되는 모든 작업의 수명을 제어합니다. ClientEncryption을(를) 인스턴스화할 때 시간 초과를 제공하지 않으면 인스턴스 는 ClientEncryption 생성자에 사용된 MongoClient 의 시간 초과 설정을 상속합니다.

클라이언트 와 ClientEncryption에서 모두 timeoutMS 을 설정하다 ClientEncryption 에 제공된 값이 우선합니다.

커서 수명 모드

커서 수명 모드 시간 초과 설정을 사용하여 커서 의 전체 수명을 제한합니다. 이 모드 에서는 애플리케이션 커서 초기화하고, 커서 메서드에 대한 모든 호출을 완료하고, 지정된 시간 제한 내에 모든 문서를 반환해야 합니다. 그렇지 않으면 커서의 수명이 만료되고 운전자 시간 초과 오류가 발생합니다.

close() 메서드를 호출하여 커서 닫으면 서버 측 리소스가 정리되도록 killCursors 명령에 대한 시간 제한이 재설정됩니다.

다음 예시 커서 초기화되고 상속된 제한 시간 내에 모든 문서가 검색되도록 커서 시간 제한을 설정하다 방법을 보여 줍니다.

FindIterable<Document> cursorWithLifetimeTimeout = collection
        .find(gte("age", 40))
        .timeoutMode(TimeoutMode.CURSOR_LIFETIME);

커서 반복 모드

커서 반복 모드 시간 초과를 설정하여 각 호출을 next(), hasNext() 및 tryNext() 메서드로 제한합니다. 시간 초과는 각 호출이 완료될 때 새로 고침됩니다. 이는 고정 사이즈 컬렉션 또는 변경 스트림에서 find() 메서드가 반환하는 테일 커서(tailable cursor)와 같은 모든 테일 커서(tailable cursor)의 기본값 모드 입니다.

다음 코드 예시 ITERATION 시간 제한 모드 가 있는 커서 사용하여 db.people 컬렉션 의 문서를 반복한 다음 각 문서 의 name 필드 값을 검색하고 인쇄합니다.

try (MongoCursor<Document> cursorWithIterationTimeout = collection
        .find(gte("age", 40))
        .timeoutMode(TimeoutMode.ITERATION)
        .cursor()
) {
    while (cursorWithIterationTimeout.hasNext()) {
        System.out.println(cursorWithIterationTimeout.next().toJson());
    }
}