연결 가이드

연결 URI

연결 URI는 드라이버가 MongoDB deployment에 연결하는 데 사용하는 지침 세트입니다. 드라이버에게 MongoDB에 연결하는 방법과 연결된 상태에서 동작하는 방법을 알려줍니다. 다음 예시에서는 연결 URI의 각 부분을 보여 줍니다.

이 예시에서는 DNS SRV 레코드가 있는 MongoDB deployment에 연결합니다. 자세한 내용은 DNS 시드 목록 연결 형식 문서를 참조하세요. 이 형식은 배포 유연성을 제공하고 클라이언트를 재구성하지 않고도 서버를 순환적으로 변경할 수 있는 기능을 제공합니다.

DNS SRV 주소가 없는 인스턴스 또는 복제본 세트에 연결하는 경우 프로토콜에 표준 연결 문자열 형식을 지정하는 mongodb를 사용해야 합니다.

암호 기반 인증을 사용하는 경우 프로토콜 다음에 연결 문자열의 다음 부분에 자격 증명이 포함됩니다. user 값을 사용자 이름으로 바꾸고 pass를 암호로 바꿉니다. 사용자 이름과 비밀번호가 필요하지 않은 인증 메커니즘을 사용하는 경우 연결 URI에서 이 부분을 생략합니다.

연결 문자열의 다음 부분에서는 MongoDB 인스턴스의 호스트 이름 또는 IP 주소와 포트 번호를 차례로 지정합니다. 위의 예시에서는 sample.host를 호스트 이름으로, 27017을 포트로 사용합니다. 이 값을 MongoDB 인스턴스의 포인트 정보로 바꿉니다.

연결 문자열의 마지막 부분에는 연결 및 인증 옵션이 매개변수로 포함되어 있습니다. 위의 예에서는 maxPoolSize=20 및 w=majority의 두 가지 연결 옵션을 설정했습니다. 연결 옵션에 대한 자세한 내용을 보려면 연결 옵션 섹션으로 건너뛰세요.

Atlas 연결 예시

Atlas의 MongoDB deployment에 연결하려면 클라이언트를 만들어야 합니다. 클라이언트를 생성하려면 MongoClient 인스턴스를 구축하고 URI와 MongoClientOptions 객체를 전달합니다.

MongoClientOptions 객체의 serverApi 옵션을 사용하여 서버가 지정된 API 버전과 호환되는 동작으로 작업을 실행하도록 하는 Stable API 기능을 허용합니다.

다음 코드는 Atlas의 MongoDB deployment에 연결할 때 연결 문자열과 Stable API 클라이언트 옵션을 지정하고 연결이 성공했는지 확인하는 방법을 보여줍니다.

const { MongoClient, ServerApiVersion } = require("mongodb");
// Replace the placeholder with your Atlas connection string
const uri = "<connection string>";
// Create a MongoClient with a MongoClientOptions object to set the Stable API version
const client = new MongoClient(uri,  {
        serverApi: {
            version: ServerApiVersion.v1,
            strict: true,
            deprecationErrors: true,
        }
    }
);
async function run() {
  try {
    // Connect the client to the server (optional starting in v4.7)
    await client.connect();
    // Send a ping to confirm a successful connection
    await client.db("admin").command({ ping: 1 });
    console.log("Pinged your deployment. You successfully connected to MongoDB!");
  } finally {
    // Ensures that the client will close when you finish/error
    await client.close();
  }
}
run().catch(console.dir);

Stable API 기능에 대해 자세히 알아보려면 Stable API 페이지를 참조하세요.

MongoDB에 연결하는 다른 방법

Atlas에서 호스팅되지 않는 단일 MongoDB 서버 인스턴스 또는 복제본 세트에 연결하는 경우, 다음 섹션을 참조하여 연결 방법을 알아보세요.

mongodb://localhost:<port>

mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myRs