연결 대상 선택

개요

이 가이드 에서는 연결 문자열 과 MongoClient 객체 사용하여 고 (Go) 운전자 통해 다양한 유형의 MongoDB 배포에 연결하는 방법을 학습 수 있습니다.

Atlas에 연결

MongoDB 에서 deployment에 Atlas 연결하려면 연결 에 다음 요소를 string 포함하세요.

• Atlas cluster의 URL

• MongoDB 사용자 이름

• MongoDB 비밀번호

그런 다음 연결 string 을 MongoClient 생성자에 전달합니다.

Atlas 에 연결할 때 Stable API 클라이언트 옵션을 사용하여 Atlas 를 새 버전의 MongoDB Server 로 업그레이드할 때 호환성이 손상되는 변경을 방지하는 것이 좋습니다. Stable API 기능 에 학습 보려면 Stable API 가이드 를 참조하세요.

다음 코드는 Atlas 연결 문자열과 Stable API 버전을 사용하는 클라이언트를 만들고, MongoDB에 연결하고, 연결이 성공했는지 확인하는 방법을 보여 줍니다.

// Connects to MongoDB and sets a Stable API version
package main
import (
	"context"
	"fmt"
	"log"
	"os"
	"go.mongodb.org/mongo-driver/v2/bson"
	"go.mongodb.org/mongo-driver/v2/mongo"
	"go.mongodb.org/mongo-driver/v2/mongo/options"
)
func main() {
	var uri string
	if uri = os.Getenv("MONGODB_URI"); uri == "" {
		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://mongodb.com/ko-kr/docs/drivers/go/current/usage-examples/")
	}
	// Uses the SetServerAPIOptions() method to set the Stable API version to 1
	serverAPI := options.ServerAPI(options.ServerAPIVersion1)
	// Defines the options for the MongoDB client
	opts := options.Client().ApplyURI(uri).SetServerAPIOptions(serverAPI)
	// Creates a new client and connects to the server
	client, err := mongo.Connect(opts)
	if err != nil {
		panic(err)
	}
	defer func() {
		if err = client.Disconnect(context.TODO()); err != nil {
			panic(err)
		}
	}()
	// Sends a ping to confirm a successful connection
	var result bson.M
	if err := client.Database("admin").RunCommand(context.TODO(), bson.D{{"ping", 1}}).Decode(&result); err != nil {
		panic(err)
	}
	fmt.Println("Pinged your deployment. You successfully connected to MongoDB!")
}

로컬 배포에 연결

개발 목적으로 로컬 머신에서 MongoDB 서버를 실행해야 하는 경우 다음 단계를 완료하세요.

1. MongoDB Server의 Community 또는 Enterprise 버전을 다운로드하세요.

2. MongoDB 서버를 설치하고 구성합니다.

3. 서버를 시작합니다.

MongoDB Server를 성공적으로 시작한 후에는 드라이버 연결 코드에 연결 문자열을 지정하세요.

MongoDB Server가 로컬에서 실행되는 경우 연결 문자열("mongodb://localhost:<port>")을 사용할 수 있습니다. 여기서 <port>는 서버가 들어오는 연결을 수신하도록 구성한 포트 번호입니다.

다른 호스트 이름 또는 IP 주소 지정하는 방법에 대한 자세한 내용은 서버 매뉴얼의 연결 문자열 을 참조하세요.

서버에 연결할 수 있는지 테스트하려면 앞의 코드 예시에서 연결 문자열을 localhost 연결 문자열로 바꿉니다.

복제본 세트에 연결

MongoDB 복제본 세트 배포는 동일한 데이터 세트를 저장하는 연결된 인스턴스 그룹입니다. 이 구성은 데이터 중복성과 높은 데이터 가용성을 제공합니다.

복제본 세트 배포서버 에 연결하려면 각 인스턴스 의 호스트 이름과 포트 번호를 쉼표로 구분하고 연결 문자열 의 replicaSet 매개변수 값으로 복제본 세트 이름을 지정합니다. 다음 예시 연결 문자열 에서 호스트 이름은 host1, host2, host3이고 포트 번호는 모두 27017입니다. 복제본 세트 이름은 myRS입니다.

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

복제본 세트에 연결할 때 드라이버는 기본적으로 다음 작업을 수행합니다.

• 한 멤버의 주소가 제공되면 모든 복제본 세트 멤버를 검색합니다.

• 프라이머리 멤버에 대한 쓰기 명령과 같은 작업을 해당 멤버에 전달합니다.

복제본 세트에 대해 자세히 학습하려면 서버 매뉴얼의 복제 항목을 참조하세요.

DNS 서비스 검색

DNS 서비스 검색을 사용하여 연결하려는 서비스의 DNS SRV 기록 조회하려면 연결 문자열 에 SRV 연결 형식을 지정합니다. 이 형식을 지정하면 고 (Go) 운전자 새 호스트를 자동으로 다시 검색합니다. 배포서버 클라이언트 구성을 변경하지 않고도 토폴로지 에 호스트를 추가할 수 있습니다.

다음 코드는 SRV 연결 형식을 사용하는 연결 문자열 보여줍니다.

uri := "mongodb+srv://<hostname>/"

SRV 연결 형식에 대해 자세히 학습 MongoDB Server 매뉴얼의 SRV 연결 형식 항목을 참조하세요.

API 문서

MongoClient를 사용하여 다른 MongoDB 인스턴스에 연결하는 방법에 대해 자세히 학습 다음 API 설명서를 참조하세요.

• 몽고클라이언트

• 옵션

• 연결

• 읽기 설정