クイック スタート
項目一覧
このガイドでは、.NET/C# ドライバー を使用して MongoDB Atlas クラスターに接続するアプリケーションを作成する方法について説明します。別のドライバーまたはプログラミング言語を使用して MongoDB に接続する場合は、公式 MongoDB ドライバーのリスト を参照してください。
.NET/C# ドライバーを使用すると、.NET アプリケーションから MongoDB クラスターに接続して通信できます。
MongoDB Atlas は、MongoDB クラスターでデータをホストする完全管理クラウドデータベース サービスです。このガイドでは、独自の無料クラスター（クレジットカードは不要）を開始する方法を説明します。
.NET アプリケーションを MongoDB Atlas クラスターに接続するには、以下の手順に従います。
MongoDB クラスターを作成する
Atlas での無料階層クラスターを設定する
このガイドに必要な Atlas 無料階層クラスターをセットアップするには、 MongoDB Atlas セットアップのガイドを完了させてください。
Atlas ガイドの手順を完了すると、Atlas に新しい MongoDB クラスターが配置され、新しいデータベースユーザーが作成され、クラスターにサンプル データセットがロードされます。また、コピー バッファには次のような接続文字列があります。
"mongodb+srv://<db_username>:<db_password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"
接続文字列を設定する
コマンドプロンプトで次のコードを実行して、 MongoDB 接続stringを環境変数に保存します。 この方法は、ソースコードに認証情報を含めるよりも安全です。
export MONGODB_URI="<your MongoDB URI>"
注意
PowerShell 環境変数
Microsoft PowerShell を使用している場合は、次のコマンドを実行して接続文字列を環境変数に保存します。
set MONGODB_URI="<your MongoDB URI>"
重要
接続 <db_username>の {0<db_password>string セクションと セクションを、Atlas データベースユーザーのユーザー名とパスワードに置き換えてください。
接続文字列の詳細については、「接続文字列」を参照してください。
プロジェクトを設定する
プロジェクトを作成する
次のように、新しいディレクトリを作成し、dotnet new コマンドを使用してプロジェクトを初期化します。
mkdir csharp-quickstart cd csharp-quickstart dotnet new console
MongoDB を依存関係として追加する
dotnet add コマンドを使用して、.NET/C# ドライバーを依存関係としてプロジェクトに追加します。
dotnet add package MongoDB.Driver
アプリケーションから MongoDB クラスターをクエリする
この手順では、.NET/C# ドライバーを使用して MongoDB クラスターに接続し、サンプル データに対してクエリを実行します。お好みのテキストエディタまたは 統合開発環境（IDE） をインストールし、実行することが必要です。
プロジェクトのベース ディレクトリにある Program.cs という名前のファイルを開きます。次のサンプル コードを Program.cs にコピーします
using MongoDB.Driver; using MongoDB.Bson; var connectionString = Environment.GetEnvironmentVariable("MONGODB_URI"); if (connectionString == null) { Console.WriteLine("You must set your 'MONGODB_URI' environment variable. To learn how to set it, see https://www.mongodb.com/ja-jp/docs/drivers/csharp/current/quick-start/#set-your-connection-string"); Environment.Exit(0); } var client = new MongoClient(connectionString); var collection = client.GetDatabase("sample_mflix").GetCollection<BsonDocument>("movies"); var filter = Builders<BsonDocument>.Filter.Eq("title", "Back to the Future"); var document = collection.Find(filter).First(); Console.WriteLine(document);
このサンプル コードは、MongoDB Atlas のサンプル データセットに対してクエリを実行します。 次のコマンドを使用して、コマンドラインから実行します。
dotnet run csharp-quickstart.csproj
Program.cs を実行すると、サンプル データセットから次の映画の詳細が出力されます。
{ "_id": "573a1398f29313caabce9682", ... "title": "Back to the Future", ... }
Tip
出力が空の場合は、サンプル データセットがクラスターにロードされていることを確認してください。
この手順を完了すると、.NET/C# ドライバーを使用して MongoDB クラスターに接続し、サンプル データに対してクエリを実行し、結果を出力する動作するアプリケーションが作成されます。
.NET/C# ドライバーを使用して Atlas に接続する方法について詳しくは、Atlas ドライバー接続ガイドを参照し、Select your language ドロップダウンから C# を選択してください。
次のステップ
CRUD 操作ガイドでは、.NET/C# ドライバーを使用してデータを読み取って変更する方法、または使用例では、一般的な操作を実行する方法を学習します。