ドキュメントの挿入

Overview

このガイドでは、MongoDB .NET/C# ドライバーを使用して挿入操作を実行し、MongoDB コレクションにドキュメントを追加する方法を学習できます。

挿入操作は、1 つ以上の ドキュメント をMongoDBコレクションに挿入します。.NET/ C#ドライバーは、挿入操作を実行するための次のメソッドを提供します。それぞれに同期バージョンと非同期バージョンがあります。

• InsertOne() or ``InsertOneAsync()

• InsertMany() or InsertManyAsync()

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    public string RestaurantId { get; set; }
    public string Cuisine { get; set; }
    public Address Address { get; set; }
    public string Borough { get; set; }
    public List<GradeEntry> Grades { get; set; }
}

public class Address
{
    public string Building { get; set; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    public string ZipCode { get; set; }
}

public class GradeEntry
{
    public DateTime Date { get; set; }
    public string Grade { get; set; }
    public float? Score { get; set; }
}

_id フィールド

MongoDB コレクションでは、各ドキュメントに一意のフィールド値を持つ_idフィールドが含まれている必要があります。

MongoDB では、このフィールドは次の 2 つの方法で管理できます。

• このフィールドは各ドキュメントに自分で設定することができ、各_idフィールド値が一意であることを確認します。

• ドライバーを使用して、各ドキュメント_idに対して一意のObjectId値を自動的に生成できます。 ドキュメントの_idフィールド値を手動で設定しない場合、ドライバーはフィールドにObjectIdを入力します。

一意性を保証できない限り、MongoDB ではドライバーに_id値を自動的に生成させることをお勧めします。

_idフィールドの詳細については、一意なインデックス に関するサーバー マニュアル エントリを参照してください。

ドキュメント構造とルールの詳細については、ドキュメント に関するサーバー マニュアル エントリを参照してください。

1つのドキュメントの挿入

次のコードは、同期 InsertOne() メソッドまたは非同期 InsertOneAsync() メソッドを使用して 1 つのドキュメントを挿入する方法を示しています。

_restaurantsCollection.InsertOne(document);

await _restaurantsCollection.InsertOneAsync(document);

複数のドキュメントの挿入

次のコードは、同期 InsertMany() メソッドまたは非同期 InsertManyAsync() メソッドを使用して複数のドキュメントを挿入する方法を示しています。

_restaurantsCollection.InsertMany(docs);

await _restaurantsCollection.InsertManyAsync(docs);

挿入動作の変更

InsertOne()メソッドは、挿入するドキュメントをパラメータとして受け取ります。 InsertMany()メソッドは、リストや配列などのドキュメントのIEnumerableコレクションをパラメータとして受け取ります。

オプションで、 InsertOne()メソッドは追加のパラメーターとしてInsertOneOptions型を受け取ります。これは、挿入操作を構成するために使用できるオプションを表します。 InsertOneOptionsプロパティを指定しない場合、ドライバーは挿入をカスタマイズしません。

InsertOneOptionsタイプでは、次のプロパティを持つオプションを構成できます。

InsertMany()メソッドはオプションとして、前述のBypassDocumentValidationとCommentプロパティと追加のIsOrderedプロパティを持つInsertManyOptions型を追加のパラメータとして取ることができます。

// Generates 5 new restaurants by using a helper method
var restaurants = GenerateDocuments();
// Creates an option object to bypass documentation validation on the documents
var options = new InsertManyOptions() { BypassDocumentValidation = true };
// Inserts the new documents into the restaurants collection with the specified options
_restaurantsCollection.InsertMany(restaurants, options);

順序付き動作の指定

たとえば、次のドキュメントを挿入するとします。

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 1, "name" : "Restaurant C" }
{ "_id" : 3, "name" : "Restaurant D" }

これらのドキュメントをデフォルトの InsertManyOptions で挿入しようとすると、_id 値が繰り返されているため、ドライバーは 3 番目のドキュメントで MongoBulkWriteException をスローします。この操作では、最初の 2 つのドキュメントのみがコレクションに追加されます。

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }

挿入操作で IsOrdered を false に設定すると、一部のドキュメントでエラーが発生しても、ドライバーはドキュメントの挿入を続行します。この変更された挿入動作では、ドライバーは例外をスローしますが、エラーを生成しないすべてのドキュメントが挿入されます。

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 3, "name" : "Restaurant D" }

詳細情報

挿入操作の実行可能な例については、次の使用例を参照してください。

• InsertOne()

• InsertOneAsync()

• InsertMany()

• InsertManyAsync()