Azure Cosmos DB의 MongoDB용 API를 사용하여 읽기를 전역 배포하는 방법

아티클
08/15/2024

적용 대상: MongoDB

이 문서에서는 Azure Cosmos DB의 MongoDB용 API를 사용하여 MongoDB 읽기 기본 설정으로 읽기 작업을 전역 배포하는 방법을 보여 줍니다.

필수 조건

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

또는 Azure 구독, 요금 및 약정 없이 Azure Cosmos DB 평가판을 사용할 수 있습니다. 또는 다음 연결 문자열과 함께 이 자습서에 Azure Cosmos DB 에뮬레이터를 사용할 수 있습니다.

mongodb://localhost:C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==@localhost:10255/admin?ssl=true

Azure Portal을 사용하여 Azure Cosmos DB 계정을 글로벌 배포로 설정한 다음, 연결하는 방법에 대한 지침은 이 빠른 시작 문서를 참조하세요.

샘플 애플리케이션 복제

git bash와 같은 git 터미널 창을 열고 cd를 수행하여 작업 디렉터리로 이동합니다.

다음 명령을 실행하여 샘플 리포지토리를 복제합니다. 관심 있는 플랫폼에 따라 다음 샘플 리포지토리 중 하나를 사용합니다.

git clone <sample repo url>

애플리케이션 실행

사용된 플랫폼에 따라 필요한 패키지를 설치하고 애플리케이션을 시작합니다. 종속성을 설치하려면 샘플 애플리케이션 리포지토리에 포함된 추가 정보 파일을 따릅니다. 예를 들어 NodeJS 샘플 애플리케이션에서 다음 명령을 사용하여 필요한 패키지를 설치하고 애플리케이션을 시작합니다.

cd mean
npm install
node index.js

애플리케이션에서 MongoDB 원본에 대한 연결을 시도하지만 연결 문자열이 잘못되었기 때문에 실패합니다. 추가 정보 파일의 단계에 따라 url 연결 문자열을 업데이트합니다. 또한 Azure Cosmos DB 계정에서 readFromRegion을 읽기 지역으로 업데이트합니다. NodeJS 샘플에서 제공되는 지침은 다음과 같습니다.

* Next, substitute the `url`, `readFromRegion` in App.Config with your Azure Cosmos DB account's values.

이러한 단계를 수행하면 샘플 애플리케이션이 실행되고 다음 출력이 생성됩니다.

connected!
readDefaultfunc query completed!
readFromNearestfunc query completed!
readFromRegionfunc query completed!
readDefaultfunc query completed!
readFromNearestfunc query completed!
readFromRegionfunc query completed!
readDefaultfunc query completed!
readFromSecondaryfunc query completed!

읽기 기본 설정 모드를 사용하여 읽기

MongoDB 프로토콜은 클라이언트에서 사용할 수 있는 다음과 같은 읽기 기본 설정 모드를 제공합니다.

PRIMARY
PRIMARY_PREFERRED
SECONDARY
SECONDARY_PREFERRED
NEAREST

이러한 읽기 기본 설정 모드 각각의 동작에 대한 자세한 내용은 MongoDB 읽기 기본 설정 동작 설명서를 참조하세요. Azure Cosmos DB에서 PRIMARY 설정은 WRITE 지역으로, SECONDARY 설정은 READ 지역으로 매핑됩니다.

일반적인 시나리오에 따라 다음 설정을 사용하는 것이 좋습니다.

고가용성 및 대기 시간이 짧은 읽기가 필요한 경우 NEAREST 읽기 기본 설정 모드를 사용합니다. 이 설정은 읽기 작업을 사용 가능한 가장 가까운 지역으로 보냅니다. 가장 가까운 지역이 WRITE 지역이면, 이러한 작업은 해당 지역으로 보내집니다.
고가용성 및 읽기의 지리적 분포가 필요한 경우(대기 시간은 제약 조건이 아님), PRIMARY PREFERRED 또는 SECONDARY PREFERRED 읽기 기본 설정 모드를 사용합니다. 이 설정은 읽기 작업을 사용 가능한 WRITE 또는 READ 지역으로 각각 보냅니다. 지역을 사용할 수 없는 경우 읽기 기본 설정 동작에 따라 요청이 사용 가능한 다음 지역으로 전달됩니다.

샘플 애플리케이션의 다음 코드 조각에서는 NodeJS에서 NEAREST 읽기 기본 설정을 구성하는 방법을 보여 줍니다.

  var query = {};
  var readcoll = client.db('regionDB').collection('regionTest', {readPreference: ReadPreference.NEAREST});
  readcoll.find(query).toArray(function(err, data) {
    assert.equal(null, err);
    console.log("readFromNearestfunc query completed!");
  });

마찬가지로, 아래 코드 조각에서는 NodeJS에서 SECONDARY_PREFERRED 읽기 기본 설정을 구성하는 방법을 보여 줍니다.

  var query = {};
  var readcoll = client.db('regionDB').collection('regionTest', {readPreference: ReadPreference.SECONDARY_PREFERRED});
  readcoll.find(query).toArray(function(err, data) {
    assert.equal(null, err);
    console.log("readFromSecondaryPreferredfunc query completed!");
  });

읽기 기본 설정은 readPreference를 연결 문자열 URI 옵션의 매개 변수로 전달하여 설정할 수도 있습니다.

const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017?ssl=true&replicaSet=globaldb&readPreference=nearest';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the Server
MongoClient.connect(url, function(err, client) {
  console.log("Connected correctly to server");

  const db = client.db(dbName);

  client.close();
});

.NET 및 Java와 같은 다른 플랫폼의 경우 해당 샘플 애플리케이션 리포지토리를 참조하세요.

태그를 사용하여 읽기

읽기 기본 설정 모드 외에도, MongoDB 프로토콜은 태그를 사용하여 읽기 작업을 보낼 수 있도록 허용합니다. Azure Cosmos DB의 API for MongoDB에서 region 태그는 기본적으로 isMaster 응답의 일부로 포함되어 있습니다.

"tags": {
         "region": "West US"
      }

따라서 MongoClient에서 지역 이름과 함께 region 태그를 사용하여 특정 지역에 읽기 작업을 보낼 수 있습니다. Azure Cosmos DB 계정의 경우 지역 이름은 Azure Portal의 왼쪽에 있는 설정 -> 전역 복제본 데이터 아래에서 찾을 수 있습니다. 이 설정은 읽기 격리, 즉 클라이언트 애플리케이션에서 읽기 작업을 특정 지역에만 보내려는 경우에 유용합니다. 이 설정은 백그라운드에서 실행되지만 프로덕션에 중요한 서비스가 아닌 비프로덕션/분석 유형 시나리오에 적합합니다.

샘플 애플리케이션의 다음 코드 조각에서는 NodeJS에서 태그를 사용하여 읽기 기본 설정을 구성하는 방법을 보여 줍니다.

 var query = {};
  var readcoll = client.db('regionDB').collection('regionTest',{readPreference: new ReadPreference(ReadPreference.SECONDARY_PREFERRED, {"region": "West US"})});
  readcoll.find(query).toArray(function(err, data) {
    assert.equal(null, err);
    console.log("readFromRegionfunc query completed!");
  });

.NET 및 Java와 같은 다른 플랫폼의 경우 해당 샘플 애플리케이션 리포지토리를 참조하세요.

이 문서에서는 Azure Cosmos DB의 MongoDB용 API에서 읽기 기본 설정을 사용하여 읽기 작업을 전역으로 배포하는 방법을 알아보았습니다.

리소스 정리

이 응용 프로그램을 계속 사용하지 않으려면 Azure Portal에서 다음 단계에 따라 이 문서에서 만든 리소스를 모두 삭제합니다.

Azure Portal의 왼쪽 메뉴에서 리소스 그룹을 클릭한 다음 만든 리소스의 이름을 클릭합니다.
리소스 그룹 페이지에서 삭제를 클릭하고 텍스트 상자에서 삭제할 리소스의 이름을 입력한 다음 삭제를 클릭합니다.

다음을 통해 공유