Go 드라이버 빠른 시작
이 페이지의 내용
이 가이드에서는 Go 드라이버를 사용하여 MongoDB Atlas 클러스터에 연결하는 애플리케이션을 만드는 방법을 설명합니다. 다른 드라이버 또는 프로그래밍 언어를 사용하여 MongoDB에 연결하려는 경우 공식 MongoDB 드라이버 목록을 참조하세요.
Go 드라이버를 사용하면 Go 애플리케이션에서 MongoDB cluster에 연결하고 통신할 수 있습니다.
MongoDB Atlas는 MongoDB 클러스터에서 데이터를 호스팅하는 완전 관리형 클라우드 데이터베이스 서비스입니다. 이 가이드에서는 무료(신용카드 필요 없음) 클러스터를 시작하는 방법을 보여줍니다.
아래 단계에 따라 Go 애플리케이션을 MongoDB Atlas 클러스터와 연결하세요.
프로젝트 설정
Go 모드를 사용하여 프로젝트 초기화
새 디렉토리를 생성하고 go mod로 프로젝트를 초기화합니다.
mkdir go-quickstart cd go-quickstart go mod init go-quickstart
종속성으로 MongoDB 추가하기
Go 드라이버를 종속 항목으로 추가하려면 go get을 사용하세요.
go get go.mongodb.org/mongo-driver/mongo
기타 종속성 추가
go get을 사용하여 추가 종속성을 추가합니다. 이 빠른 시작은 godotenv 패키지를 사용하여 환경 변수에서 MongoDB 연결 문자열을 읽음으로써 소스 코드에 자격 증명이 포함되지 않도록 합니다.
go get github.com/joho/godotenv
MongoDB 클러스터 생성
Atlas에서 프리 티어 클러스터 설정하기
Go 프로젝트 종속성을 설정한 후에는 데이터를 저장하고 관리할 수 있는 MongoDB 클러스터를 생성하세요. Atlas 시작하기 가이드를 완료하여 새 Atlas 계정과 프리 티어 MongoDB 클러스터를 설정하고, 데이터 세트를 로드하고, 데이터와 상호 작용하세요.
Atlas 가이드의 단계를 완료하고 나면, Atlas에 새 MongoDB 클러스터가 배포되고, 새 데이터베이스 사용자가 생성됩니다. 또한 클러스터에 샘플 데이터 세트가 로드됩니다.
클러스터 연결
이 단계에서는 Go 드라이버를 사용하여 MongoDB 클러스터에 연결하고 샘플 데이터에 대한 쿼리를 실행하는 애플리케이션을 만들고 실행합니다.
연결 문자열을 통해 드라이버에 MongoDB 클러스터에 연결할 위치와 방법에 대한 지침을 전달합니다. 이 문자열에는 클러스터의 호스트 이름 또는 IP 주소 및 포트, 인증 메커니즘, 해당하는 경우 사용자 자격 증명, 기타 연결 옵션 등에 대한 정보가 포함됩니다.
이전 단계에서 만든 cluster 및 사용자에 대한 연결 문자열을 조회하려면 Atlas 계정에 로그인하여 Database 섹션으로 이동한 후 아래와 같이 연결하려는 cluster의 Connect 버튼을 클릭하세요.
Connect Your Application 단계로 진행하여 Go 드라이버를 선택합니다. 그런 다음 Copy 버튼을 클릭하여 아래와 같이 연결 문자열을 클립보드에 복사합니다.
다음 단계를 위해 액세스할 수 있는 안전한 위치에 Atlas 연결 문자열을 저장합니다.
Atlas를 통해 Go 드라이버에 연결하는 방법에 대해 자세히 알아보려면 Atlas 드라이버 연결 가이드를 참조하고 언어 선택 드롭다운에서 Go를 선택하세요.
애플리케이션에서 MongoDB 클러스터 쿼리하기
다음으로, 프로젝트의 기본 디렉토리에 main.go로 명명한 파일을 만들고 여기에 애플리케이션을 보관합니다. 다음 샘플 코드를 사용하여 MongoDB Atlas에서 샘플 데이터 세트에 대한 쿼리를 실행하세요.
uri 변수의 값으로 MongoDB Atlas 연결 문자열을 지정하거나 MONGODB_URI라는 환경 변수를 만들고 Atlas 연결 문자열을 해당 값으로 설정합니다.
export MONGODB_URI='<your atlas connection string>'
참고
연결 문자열의 '<password>' 섹션을 atlasAdmin 권한이 있는 사용자를 위해 생성한 비밀번호로 바꿔야 합니다.
package main import ( "context" "encoding/json" "fmt" "log" "os" "github.com/joho/godotenv" "go.mongodb.org/mongo-driver/bson" "go.mongodb.org/mongo-driver/mongo" "go.mongodb.org/mongo-driver/mongo/options" ) func main() { if err := godotenv.Load(); err != nil { log.Println("No .env file found") } uri := os.Getenv("MONGODB_URI") if uri == "" { log.Fatal("Set your 'MONGODB_URI' environment variable. " + "See: " + "www.mongodb.com/ko-kr/docs/drivers/go/current/usage-examples/#environment-variable") } client, err := mongo.Connect(context.TODO(), 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) }
명령줄에서 다음 명령을 사용하여 샘플 코드를 실행합니다:
go run main.go
main.go를 실행하면 다음과 같은 샘플 데이터세트에서 영화의 세부정보가 출력됩니다.
{ "_id": "573a1398f29313caabce9682", ... "title": "Back to the Future", ... }
출력이 없거나 오류가 발생하는 경우 환경 변수를 올바르게 설정했는지, 그리고 MongoDB Atlas 클러스터에 샘플 데이터 세트를 로드했는지 확인하세요.
팁
출력이 비어 있으면 샘플 데이터 세트를 클러스터에 로드했는지 확인하세요.
이 단계를 완료하면 Go 드라이버를 사용하여 MongoDB 클러스터에 연결하고 샘플 데이터에 대해 쿼리를 실행하고 결과를 출력하는 등 정상적으로 작동하는 애플리케이션이 만들어져야 합니다.
다음 단계
기초 CRUD 가이드에서 Go 드라이버를 사용하여 데이터를 읽고 수정하는 방법을 알아보거나 사용 예시에서 일반적인 작업을 수행하는 방법을 알아보세요.