ANNOUNCEMENT: Voyage AI joins MongoDB to power more accurate and trustworthy AI applications on Atlas.
Learn more
Docs Menu

Go 드라이버 빠른 시작

이 가이드에서는 MongoDB Go Driver를 사용하여 MongoDB Atlas 클러스터에 연결하는 애플리케이션을 만드는 방법을 보여줍니다. 다른 드라이버 또는 프로그래밍 언어를 사용하여 MongoDB에 연결하려면 공식 MongoDB 드라이버 목록을 참조하세요.

Go 드라이버를 사용하면 Go 애플리케이션에서 MongoDB cluster에 연결하고 통신할 수 있습니다.

MongoDB Atlas는 MongoDB 클러스터에서 데이터를 호스팅하는 완전 관리형 클라우드 데이터베이스 서비스입니다. 이 가이드에서는 무료(신용카드 필요 없음) 클러스터를 시작하는 방법을 보여줍니다.

아래 단계에 따라 Go 애플리케이션을 MongoDB Atlas 클러스터와 연결하세요.

1

새로운 디렉토리를 만들고 다음 명령어와 같이 go mod을(를) 사용하여 프로젝트를 초기화합니다.

mkdir go-quickstart
cd go-quickstart
go mod init go-quickstart
2

다음 명령어에 표시된 대로 go get을 사용하여 Go 드라이버를 종속 항목으로 추가합니다.

go get go.mongodb.org/mongo-driver/v2/mongo

MongoDB Atlas에서 프리 티어 MongoDB 배포를 생성하여 데이터를 저장하고 관리할 수 있습니다. MongoDB Altas는 클라우드에서 MongoDB 데이터베이스를 호스팅하고 관리합니다.

1

Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 프리 티어 MongoDB 클러스터를 생성하세요. 데이터 세트를 로드하고 해당 데이터를 활용할 수 있습니다.

2

데이터베이스 사용자를 생성한 후 다음 단계에서 사용할 수 있도록 해당 사용자의 사용자 이름과 비밀번호를 안전한 위치에 저장하세요.

이러한 단계를 완료하면 Atlas에 새로운 MongoDB 클러스터가 배포되고 새로운 데이터베이스 사용자가 생성되며, 샘플 데이터 세트가 클러스터에 로드됩니다.

연결 문자열이라고도 하는 연결 URI을 제공하여 MongoDB 배포서버에 연결할 수 있으며, 이 연결 문자열은 드라이버에 MongoDB 배포서버로 연결하는 방법과 연결된 동안 동작하는 방법을 지시합니다.

연결 문자열에는 배포서버의 호스트 이름 또는 IP 주소와 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 연결 옵션 등이 포함됩니다.

1

이전 섹션에서 생성한 Atlas 클러스터의 연결 문자열을 조회하려면 Atlas 계정에 로그인하세요. Database 섹션으로 이동하여 Clusters을(를) 클릭합니다. 아래에 표시된 대로 연결하려는 클러스터의 Connect 버튼을 클릭합니다.

Atlas Connection GUI cluster selection screen

그런 다음 Connect to your application 헤더 아래에 있는 Drivers 옵션을 선택합니다. Driver 선택 메뉴에서 'Go'를 선택하고 Version 선택 메뉴에서 설치한 버전과 가장 일치하는 버전을 선택하세요.

2

다음 스크린샷에 표시된 대로 연결 문자열 오른쪽에 있는 버튼을 클릭하여 클립보드에 복사합니다.

Atlas Connection GUI connection string screen
3

이 연결 문자열을 원하는 텍스트 편집기의 파일에 붙여넣고 <db_username><db_password> 자리 표시자를 데이터베이스 사용자의 사용자 이름 및 비밀번호로 바꿉니다.

다음 단계에서 사용할 수 있도록 이 파일을 안전한 위치에 저장합니다.

이 단계를 완료하면 Atlas 클러스터에 해당하는 연결 문자열이 생성됩니다.

Atlas를 통해 MongoDB Go 드라이버에 연결하는 방법에 대해 더 알아보려면 Atlas 드라이버 연결 가이드를 참조하고 Select your language 드롭다운에서 Go를 선택하세요.

1

터미널에서 다음 명령을 실행하여 MONGODB_URI라는 환경 변수를 생성하고 Atlas 연결 문자열을 값으로 설정합니다.

export MONGODB_URI='<your atlas connection string>'

참고

연결 문자열의 <db_password> 섹션을 atlasAdmin 권한을 가진 사용자를 위해 생성한 비밀번호로 교체해야 합니다.

2

프로젝트의 기본 디렉토리에서 다음 명령을 실행하여 main.go라는 새 파일을 생성합니다.

touch main.go
3

다음 코드를 복사하여 main.go 파일에 붙여넣습니다. 이 코드는 MongoDB Atlas의 샘플 데이터 세트에서 쿼리를 실행합니다.

package main
import (
"context"
"encoding/json"
"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() {
uri := os.Getenv("MONGODB_URI")
docs := "www.mongodb.com/docs/drivers/go/current/"
if uri == "" {
log.Fatal("Set your 'MONGODB_URI' environment variable. " +
"See: " + docs +
"usage-examples/#environment-variable")
}
client, err := mongo.Connect(options.Client().
ApplyURI(uri))
if err != nil {
panic(err)
}
defer func() {
if err := client.Disconnect(context.TODO()); err != nil {
panic(err)
}
}()
coll := client.Database("sample_mflix").Collection("movies")
title := "Back to the Future"
var result bson.M
err = coll.FindOne(context.TODO(), bson.D{{"title", title}}).
Decode(&result)
if err == mongo.ErrNoDocuments {
fmt.Printf("No document was found with the title %s\n", title)
return
}
if err != nil {
panic(err)
}
jsonData, err := json.MarshalIndent(result, "", " ")
if err != nil {
panic(err)
}
fmt.Printf("%s\n", jsonData)
}
4

명령줄에서 다음 명령을 사용하여 샘플 코드를 실행합니다:

go run main.go

main.go를 실행하면 샘플 데이터 세트에서 다음과 유사한 영화 세부 정보가 출력됩니다.

{
"_id": "573a1398f29313caabce9682",
...
"title": "Back to the Future",
...
}

출력이 없거나 오류가 발생하는 경우 환경 변수를 올바르게 설정했는지 확인하고 샘플 데이터 세트가 클러스터에 로드되었는지 확인하세요.

이 단계를 완료하면 MongoDB Go 드라이버를 사용하여 MongoDB 클러스터에 연결하고 샘플 데이터에 쿼리를 실행하며 결과를 출력하는 등 정상적으로 작동하는 애플리케이션이 생성됩니다.

CRUD 작업 섹션에서 MongoDB Go 드라이버를 사용하여 데이터를 읽고 수정하는 방법 또는 사용 예시에서 일반적인 작업을 수행하는 방법을 알아보세요.