연결 풀로 연결 관리

maxPoolSize

애플리케이션의 요청을 지원 데 필요한 소켓 외에도 각 MongoClient 인스턴스 서버 상태 모니터링 위해 MongoDB 토폴로지 에서 서버 당 최대 두 개의 연결을 엽니다.

예시 들어, 3노드 복제본 세트 에 연결된 클라이언트 6개의 모니터링 소켓을 엽니다. 애플리케이션 maxPoolSize 기본값 설정을 사용하고 프라이머리 (기본값) 노드 만 쿼리하는 경우 연결 풀 에는 최대 106 개의 열린 소켓과 100 개의 연결이 있을 수 있습니다. 애플리케이션 읽기 설정 (read preference) 사용하여 세컨더리 노드를 쿼리 경우 이러한 연결 풀이 커지고 개방형 모니터링 소켓을 포함하여 총 연결 수가 306 개가 될 수 있습니다.

하나의 프로세스 내에서 많은 수의 동시 MongoDB 요청을 지원하려면 maxPoolSize를 늘리면 됩니다.

다음 코드는 options 객체 에 maxPoolSize 옵션을 지정하여 최대 연결 풀 크기가 200 인 MongoClient 인스턴스 를 생성합니다.

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxPoolSize: 200
});

maxConnecting

연결 풀 속도 제한 연결 설정. maxConnecting 옵션은 풀이 언제든지 병렬로 생성할 수 있는 연결 수를 결정합니다. 예시 를 들어 maxConnecting 값이 2인 경우 연결을 동시에 체크아웃하려는 세 번째 요청 다음 경우 중 하나가 발생할 때만 성공합니다.

• 연결 풀에서 연결 생성이 완료되었으며 풀에 연결 수가 maxPoolSize 미만입니다.

• 기존 연결이 풀로 다시 확인됩니다.

다음 코드는 options 객체 에 maxConnecting 옵션을 지정하여 풀당 동시에 설정할 수 있는 최대 2 연결을 가진 MongoClient 인스턴스 만듭니다.

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
   maxConnecting: 2
});

minPoolSize

minPoolSize 옵션을 사용하여 각 서버 에 대한 최소 연결 수를 설정하다 수 있습니다. 운전자 연결 풀 에 minPoolSize 옵션으로 설정하다 연결 수가 항상 최소한 있는지 확인합니다. 소켓이 닫혀 총 소켓 수(사용 중인 소켓과 유휴 상태 모두)가 최소값 아래로 떨어지면 최소값에 도달할 때까지 더 많은 소켓이 열립니다.

다음 코드는 options 객체 에 minPoolSize 옵션을 지정하여 최소 연결 풀 크기가 10 인 MongoClient 인스턴스 생성합니다.

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  minPoolSize: 10
});

maxIdleTimeMS

maxIdleTimeMS 옵션을 설정하여 연결이 풀에서 유휴 상태로 유지될 수 있는 최대 시간(밀리초)을 설정할 수 있습니다. 연결이 maxIdleTimeMS 동안 유휴 상태이면 연결 풀이 이를 제거하고 교체합니다. 이 옵션의 기본값은 0(제한 없음)입니다.

다음 코드는 options 객체 에 maxIdleTimeMS 설정을 지정하여 최대 유휴 시간이 10000 밀리초(10 초)인 MongoClient 인스턴스 생성합니다.

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxIdleTimeMS: 10000
});

waitQueueTimeoutMS

MongoClient 여러 개의 동시 요청을 지원합니다. 각 프로세스에 대해 클라이언트를 만들어 프로세스의 모든 작업에 재사용합니다. 이 방법은 각 요청에 대해 클라이언트를 만드는 것보다 더 효율적입니다.

드라이버는 소켓이 사용 가능해질 때까지 기다릴 수 있는 요청 수를 제한하지 않으며, 부하 급증 시 해당 풀의 크기를 대기 중인 제한으로 제한하는 것은 애플리케이션의 책임입니다. 요청은 waitQueueTimeoutMS 옵션에 지정된 시간 동안 대기하며 기본값은 0(제한 없음)입니다.

소켓에 대해 waitQueueTimeoutMS에 정의된 시간보다 오래 기다리는 요청은 연결 오류를 발생시킵니다. 모든 작업을 완료하는 것보다 부하가 급증하는 동안 작업 기간을 제한하는 것이 더 중요한 경우 이 옵션을 사용합니다.

다음 코드는 options 객체 에서 선언하여 최대 대기열 시간 제한이 10000 밀리초(10 초)인 MongoClient 인스턴스 생성합니다.

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  waitQueueTimeoutMS: 10000
});