CRUD 작업 구성

클라이언트 구성

이 예시 에서는 생성자에 배열 을 전달하여 MongoDB\Client 인스턴스 의 읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 를 설정하다 하는 방법을 보여 줍니다. 이 코드는 다음 설정을 구성합니다.

• secondary 읽기 설정 (read preference) : 읽기 작업은 세컨더리 복제본 세트 멤버에서 데이터를 조회 합니다.

• local 읽기 고려 (read concern): 읽기 작업은 데이터가 대부분의 복제본 세트 멤버에 기록되었음을 보장하지 않고 인스턴스의 가장 최근 데이터를 반환합니다.

• 2 쓰기 고려 (write concern): 프라이머리 및 세컨더리 복제본 세트 멤버 중 하나가 쓰기 (write) 작업을 확인해야 합니다.

$clientOptions = [
    'readPreference' => 'secondary',
    'readConcernLevel' => 'local',
    'w' => '2',
];
$client = new Client('mongodb://localhost:27017', $clientOptions);

또는 MongoDB\Client 생성자에 매개 변수로 전달되는 연결 URI에 읽기 및 쓰기 (write) 설정을 지정할 수 있습니다.

$uri = 'mongodb://localhost:27017/?readPreference=secondary&readConcernLevel=local&w=2';
$client = new Client($uri);

세션 구성

이 예시 에서는 startSession() 메서드에 배열 을 전달하여 세션의 읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 를 설정하다 하는 방법을 보여줍니다. 이 코드는 다음 설정을 구성합니다.

• PRIMARY_PREFERRED 읽기 설정 (read preference) : 읽기 작업은 프라이머리 복제본 세트 멤버에서 데이터를 조회 하거나, 프라이머리 멤버를 사용할 수 없는 경우 세컨더리 멤버에서 데이터를 검색합니다.

• LOCAL 읽기 고려 (read concern): 읽기 작업은 데이터가 대부분의 복제본 세트 멤버에 기록되었음을 보장하지 않고 인스턴스의 가장 최근 데이터를 반환합니다.

• MAJORITY 쓰기 고려 (write concern): 모든 복제본 세트 멤버의 대다수가 쓰기 (write) 작업을 승인해야 합니다.

$sessionOptions = [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::LOCAL),
    'writeConcern' => new WriteConcern(WriteConcern::MAJORITY),
];
$session = $client->startSession($sessionOptions);

트랜잭션 구성

이 예시 에서는 startTransaction() 메서드에 배열 을 전달하여 트랜잭션 의 읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 를 설정하다 하는 방법을 보여줍니다. 이 코드는 다음 설정을 구성합니다.

• PRIMARY 읽기 설정 (read preference) : 읽기 작업은 프라이머리 복제본 세트 멤버에서 데이터를 조회 합니다.

• MAJORITY 읽기 고려 (read concern): 읽기 작업은 대부분의 복제본 세트 멤버에 기록된 인스턴스의 가장 최근 데이터를 반환합니다.

• 1 쓰기 고려 (write concern): 프라이머리 복제본 세트 멤버가 쓰기 (write) 작업을 확인해야 합니다.

$transactionOptions = [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY),
    'readConcern' => new ReadConcern(ReadConcern::MAJORITY),
    'writeConcern' => new WriteConcern(1),
];
$session->startTransaction($transactionOptions);

데이터베이스 구성

이 예시 에서는 selectDatabase() 메서드에 옵션 배열 을 전달하여 test_database 데이터베이스 의 읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 를 설정하다 하는 방법을 보여 줍니다. 이 코드는 다음 설정을 구성합니다.

• PRIMARY_PREFERRED 읽기 설정 (read preference) : 읽기 작업은 프라이머리 복제본 세트 멤버에서 데이터를 조회 하거나, 프라이머리 멤버를 사용할 수 없는 경우 세컨더리 멤버에서 데이터를 검색합니다.

• AVAILABLE 읽기 고려 (read concern): 읽기 작업은 데이터가 대부분의 복제본 세트 멤버에 기록되었음을 보장하지 않고 인스턴스의 가장 최근 데이터를 반환합니다.

• MAJORITY 쓰기 고려 (write concern): 모든 복제본 세트 멤버의 대다수가 쓰기 (write) 작업을 승인해야 합니다.

$db = $client->selectDatabase('test_database', [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::AVAILABLE),
    'writeConcern' => new WriteConcern(WriteConcern::MAJORITY),
]);

collection 구성

이 예시 에서는 selectCollection() 메서드에 옵션 배열 을 전달하여 test_collection 컬렉션 의 읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 를 설정하다 하는 방법을 보여 줍니다. 이 코드는 다음 설정을 구성합니다.

• SECONDARY_PREFERRED 읽기 설정 (read preference) : 읽기 작업은 세컨더리 복제본 세트 멤버에서 데이터를 조회 하거나, 사용 가능한 세컨더리 멤버가 없는 경우 프라이머리 멤버에서 데이터를 검색합니다.

• AVAILABLE 읽기 고려 (read concern): 읽기 작업은 데이터가 대부분의 복제본 세트 멤버에 기록되었음을 보장하지 않고 인스턴스의 가장 최근 데이터를 반환합니다.

• 0 쓰기 고려 (write concern): 쓰기 (write) 작업에 대한 승인을 요청하지 않습니다.

$collection = $client->selectCollection('test_database', 'test_collection', [
    'readPreference' => new ReadPreference(ReadPreference::SECONDARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::AVAILABLE),
    'writeConcern' => new WriteConcern(0),
]);

태그 세트

MongoDB Server 를 사용하면 선택한 기준에 따라 복제본 세트 멤버에 키-값 태그 를 적용 할 수 있습니다. 그런 다음 해당 태그를 사용하여 읽기 작업의 멤버를 한 명 이상 대상으로 지정할 수 있습니다.

기본값 MongoDB PHP 라이브러리는 읽을 멤버를 선택할 때 태그를 무시합니다. MongoDB PHP 라이브러리가 특정 태그를 선호하도록 지시하려면 해당 태그를 MongoDB\Driver\ReadPreference 클래스 생성자에 매개변수로 전달합니다. 그런 다음 MongoDB\Driver\ReadPreference 객체 를 readPreference 데이터베이스 옵션의 값으로 설정하다 합니다.

미국 전역의 여러 데이터 센터에서 호스팅되는 멤버가 포함된 복제본 세트 에 연결되어 있다고 가정해 보겠습니다. 이 코드 예시 에서는 readPreference 옵션을 태그 세트 에 설정하여 test_database 가 다음 순서로 세컨더리 복제본 세트 멤버로부터 읽기를 선호하도록 지시합니다.

1. 뉴욕 데이터 센터 (['dc' => 'ny'])의 멤버

2. 샌프란시스코 데이터 센터 (['dc' => 'sf'])의 멤버

3. 모든 세컨더리 멤버([])

$readPreference = new ReadPreference(
    ReadPreference::RP_SECONDARY,
    [
        ['dc' => 'ny'],
        ['dc' => 'sf'],
        [],
    ],
);
$db = $client->selectDatabase(
    'test_database',
    ['readPreference' => $readPreference],
);

부하 분산

샤딩된 클러스터 또는 복제본 세트에 연결할 때 PHP 라이브러리는 로드 밸런싱 을 사용하여 읽기 및 쓰기 (write) 요청을 처리하다. 로드 밸런싱을 통해 라이브러리는 이러한 요청을 여러 서버에 분산하여 하나의 서버 에 과부하가 걸리는 것을 방지하고 최적의 성능을 보장할 수 있습니다.

When connecting to a sharded cluster, the PHP library determines the closest mongos instance by calculating which one has the lowest network round-trip time. Then, the library determines the latency window by adding this mongos's average round-trip time to the localThresholdMS value. The library load balances requests across up to two random mongos instances that fall within the latency window. For each request, the library chooses the server with the lower operation load by determining its operationCount value.

복제본 세트 에 연결할 때 PHP 라이브러리는 먼저 읽기 설정 (read preference) 에 따라 복제본 세트 멤버를 선택합니다. 그런 다음 라이브러리는 이전 단락에서 설명한 것과 동일한 프로세스 따릅니다. 지연 시간 창 계산한 후 라이브러리는 이 창 에 속하는 무작위 복제본 세트 멤버를 최대 두 개 선택하고 operationCount 값이 더 낮은 멤버를 선택하여 요청 받습니다.

$options = [
    'replicaSet' => 'repl0',
    'readPreference' => new ReadPreference(ReadPreference::RP_SECONDARY_PREFERRED),
    'localThresholdMS' => 35,
];
$client = new Client('mongodb://localhost:27017', [], $options);