Goの利用開始

このガイドでは、MongoDB Go ドライバーを使用して MongoDB Atlas クラスターに接続するアプリケーションを作成する方法について説明します。別のドライバーまたはプログラミング言語を使用して MongoDB に接続する場合は、公式 MongoDB ドライバーのリストを参照してください。

Go ドライバーを使用すると、Go アプリケーションから MongoDB クラスターに接続して通信できます。

MongoDB Atlas は、MongoDB クラスターでデータをホストする完全管理クラウドデータベースサービスです。このガイドでは、独自の無料クラスター（クレジットカードは不要）を開始する方法を説明します。

Go アプリケーションを MongoDB Atlas クラスターに接続するには、以下の手順に従います。

プロジェクトを設定する

プロジェクトを作成して初期化

次のコマンドに示すように、新しいディレクトリを作成し、go mod を使用してプロジェクトを初期化します。

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

MongoDB Go ドライバーを依存関係として追加

Go ドライバーを依存関係として追加するには、次のコマンドに示すように、go get を使用します。

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

MongoDB クラスターを作成する

Atlasで無料階層クラスターをセットアップする

MongoDB Atlas に無料階層の MongoDB 配置を作成して、データを保存および管理することができます。MongoDB Atlas は、クラウドで MongoDB データベースをホストし、管理します。

無料階層クラスターを作成する

Atlas スタートガイドを完了して、新しい Atlas アカウントを設定し、無料階層の MongoDB クラスターを作成し、データセットをロードして、データをやり取りします。

認証情報を保存する

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

これらの手順を完了すると、Atlas に新しい MongoDB クラスターが配置され、新しいデータベースユーザーが作成され、クラスターにサンプルデータセットがロードされます。

クラスターへの接続

MongoDB配置に接続するには、 接続string とも呼ばれる 接続 URIMongoDB を提供します。これは、配置に接続する方法と接続中の動作をドライバーに指示します。

接続stringには、配置のホスト名またはIPアドレスとポート、認証メカニズム、ユーザー認証情報（該当する場合）、および接続オプションが含まれます。

MongoDB Atlas 接続文字列を検索する

前のセクションで作成したクラスターの接続文字列を取得するには、次の手順を実行します。

Atlas アカウントにログインします。
サイドバーの Database セクションに移動し、Clusters を選択します。
接続するクラスターを見つけ、Connect ボタンをクリックします。
の下で、Drivers オプションをクリックします。
Driver 選択メニューから [Go] を選択し、Version 選択メニューから適切なバージョンを選択します。
接続文字列クリップボードをコピーします。

プレースホルダーを更新します

この接続stringをテキストエディタのファイルに貼り付け、<db_username> と <db_password> のプレースホルダーをデータベースユーザーのユーザー名とパスワードに置き換えます。

このファイルを安全な場所に保存して、次の手順で使用します。

これらの手順を完了すると、Atlas クラスターに対応する接続文字列が得られます。

MongoDB Goドライバーを使用して接続オプションを適用して Atlas に接続する方法の詳細については、Atlas ドライバー接続ガイドを参照してください。

アプリケーションから MongoDB クラスターをクエリする

接続文字列を追加する

ターミナルで次のコマンドを実行し、MONGODB_URI という環境変数を作成して、Atlas 接続文字列をその値として設定します。

export MONGODB_URI='<your atlas connection string>'

注意

接続文字列の <db_password> セクションを、atlasAdmin 権限を持つユーザー用に作成したパスワードに置き換えてください。

新しいファイルを作成する

プロジェクトのベースディレクトリから次のコマンドを実行して、main.go という新しいファイルを作成します。

touch main.go

Go アプリケーションを作成する

以下のコードをコピーして、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/ja-jp/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)
}

アプリケーションを実行する

コマンドラインから次のコマンドを使用してサンプルコードを実行します。

go run main.go

main.go を実行すると、サンプルデータセットから次のような映画の詳細が出力されます。

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

Tip

出力がまったくないかエラーが表示される場合は、環境変数が正しく設定されているかどうか、およびクラスターにサンプルデータセットがロードされていることを確認してください。

これらの手順を完了すると、MongoDB Go ドライバーを使用して MongoDB クラスターに接続し、サンプルデータに対してクエリを実行し、結果を出力するアプリケーションが作成されます。

次のステップ

MongoDB Goドライバーを使用してデータを読み取って変更する方法については、「CRUD操作」セクションをご覧ください。また、一般的な操作を実行する方法については、「golang の使用例」を参照してください。

戻る

Overview

接続