.NET/ C#ドライバーを使い始める

プロジェクト ディレクトリの作成

シェルで次のコマンドを実行して csharp-quickstart というディレクトリを作成し、新しい コンソールアプリケーションの.NETフレームワークプロジェクトを初期化します。

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

.NET/ C#ドライバーをインストール

次のコマンドを実行して、 .NET/ C#ドライバーの現在のバージョンをプロジェクトの依存関係 としてインストールします。

dotnet add package MongoDB.Driver

Atlas で無料のMongoDB配置を作成

Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプル データを新しい無料階層 MongoDB 配置にロードします。

認証情報の保存

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

MongoDB Atlas 接続文字列を見つける

前のステップ で作成した配置の接続文字列を取得するには、Atlas アカウントにログて「Database Connect」セクションに移動し、新しい配置の [] ボタンをクリックします。

Connect your application セクションに進み、Driver 選択メニューから「C# / .NET」を選択し、Version 選択メニューからインストールしたバージョンに最も一致するバージョンを選択します。

Password (SCRAM)認証メカニズムを選択します。

接続stringを表示するには、Include full driver code example オプションの選択を解除します。

接続stringのコピー

次のスクリーンショットに示すように、接続stringの右側にある ボタンをクリックして、クリップボードにコピーします。

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

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

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

環境変数を設定する

シェルで次のコードを実行して、MongoDB接続文字列を環境変数に保存します。<your MongoDB URI> を、前の手順でファイルに保存した接続文字列に置き換えます。

export MONGODB_URI="<your MongoDB URI>"

set MONGODB_URI="<your MongoDB URI>"

認証情報を環境変数に保存するのは、 ソースコードで認証情報をハードコーディングするよりも安全です。

.NET/ C#アプリケーションの作成

次のコードをコピーして、アプリケーション内の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/get-started/create-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);

アプリケーションの実行

このアプリケーションを起動するには、shell で次のコマンドを実行します。

dotnet run csharp-quickstart.csproj

出力には、検索された映画ドキュメントの詳細が含まれます。

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}