ドキュメントの挿入

➤ 右上の [言語選択] ドロップダウンメニューを使用して、以下の例の言語を設定するか、MongoDB Compass を選択します。

このページでは、MongoDB の挿入操作の例を取り上げます。

次の方法を使用して、MongoDB にドキュメントを挿入できます。

プログラミング言語のドライバー。
MongoDB Atlas UI 。詳しくは、「MongoDB Atlas UI にドキュメントを挿入する」を参照してください。
MongoDB Compass

注意

コレクションの作成

現在コレクションが存在しない場合は、挿入操作によってコレクションが作成されます。

MongoDB Atlas UI でのドキュメントの挿入

MongoDB Atlas UI にドキュメントを挿入するには、次の手順を実行します。MongoDB Atlas UI 内でドキュメントを操作する方法について詳しくは、「ドキュメントの作成、表示、更新、削除」を参照してください。

MongoDB Atlas UI で、プロジェクトの Clusters ページに移動します。

まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Database見出しの下のClustersをクリックします。
[ Clusters （クラスター） ] ページが表示されます。

コレクションへ移動する

ドキュメントを追加するクラスターで、[ Browse Collections ] をクリックします。
左のナビゲーションペインでデータベースをクリックします。
左のナビゲーションペインでコレクションをクリックします。

ドキュメントを追加します

[Insert Document] をクリックします。
{} アイコンをクリックすると、JSON ビューが開きます。

ドキュメント配列をテキスト入力フィールドに貼り付けます。たとえば、次のエントリでは 4 つのドキュメントが作成され、それぞれに 3 つのフィールドが含まれます。

[
   { "prodId": 100, "price": 20, "quantity": 125 },
   { "prodId": 101, "price": 10, "quantity": 234 },
   { "prodId": 102, "price": 15, "quantity": 432 },
   { "prodId": 103, "price": 17, "quantity": 320 }
]

[Insert] をクリックします。

MongoDB Atlas はドキュメントをコレクションに追加します。

単一ドキュメントのインサート

db.collection.insertOne() は、コレクションに単一のドキュメントを挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、MongoDB は ObjectId 値を持つ_idフィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

MongoDB Compass を使用して単一のドキュメントを挿入するには、次の手順に従います。

ドキュメントを挿入するコレクションに移動します。
1. 左側の MongoDB Compass ナビゲーションウィンドウで、ターゲットコレクションが属するデータベースをクリックします。
2. データベースビューから、ターゲットコレクション名をクリックします。
Add Data ボタンをクリックしてから、Insert document をクリックします。
ドキュメントに貼り付けます。例として、次のコードを Compass に貼り付けて、canvas ドキュメントを inventory コレクションに挿入できます。
```
{
  "item": "canvas",
  "qty": 100,
  "tags": ["cotton"],
  "size": {
    "h": 28,
    "w": 35.5,
    "uom": "cm"
  }
}
```
[Insert] をクリックします。

次の例では、新しいドキュメントを test.inventory コレクションに挿入します。

次の例では、新しいドキュメントをinventoryコレクションに挿入します。ドキュメントに_idフィールドが指定されていない場合、C ドライバーは ObjectId 値を持つ_idフィールドを新しいドキュメントに追加します。詳細については、「挿入動作」を参照してください。

IMongoCollection.InsertOne() は、 1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、C# ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

Collection.InsertOne は、 1 つ のドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

com.mongodb.reactivestreams.client.MongoCollection.insertOne は、次の Java Reactive Streams ドライバーを使用して、 1 つの ドキュメントをコレクションに挿入します。

{ item: "canvas", qty: 100, tags: ["cotton"], size: { h: 28, w: 35.5, uom: "cm" } }

次の例では、上記のドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

com.mongodb.client.MongoCollection.insertOne は、1 つのドキュメントをコレクションに挿入します。

MongoCollection.insertOne は、 1 つ のドキュメントをコレクションに挿入します。

motor.motor_asyncio.AsyncIOMotorCollection.insert_one は、1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、Motor ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

Collection.insertOne() は、1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、Node.js ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

MongoDB\\Collection::insertOne() は、1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、PHP ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

pymongo.collection.Collection.insert_one は、1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントをinventoryコレクションに挿入します。ドキュメントに_idフィールドが指定されていない場合、PyMongo ドライバーは ObjectId 値を持つ_idフィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

Mongo::Collection#insert_one() は、コレクションに単一のドキュメントを挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、Ruby ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

collection.insertOne() は、1 つのドキュメントをコレクションに挿入します。

次の例では、新しいドキュメントを inventory コレクションに挿入します。ドキュメントに _id フィールドが指定されていない場合、Scala ドライバーは ObjectId 値を持つ _id フィールドを新しいドキュメントに追加します。「挿入動作」を参照してください。

db.inventory.insertOne(
   { item: "canvas", qty: 100, tags: ["cotton"], size: { h: 28, w: 35.5, uom: "cm" } }
)

mongoc_collection_t *collection;
bson_t *doc;
bool r;
bson_error_t error;
collection = mongoc_database_get_collection (db, "inventory");
doc = BCON_NEW (
   "item", BCON_UTF8 ("canvas"),
   "qty", BCON_INT64 (100),
   "tags", "[",
   BCON_UTF8 ("cotton"),
   "]",
   "size", "{",
   "h", BCON_DOUBLE (28),
   "w", BCON_DOUBLE (35.5),
   "uom", BCON_UTF8 ("cm"),
   "}");
r = mongoc_collection_insert_one (collection, doc, NULL, NULL, &error);
bson_destroy (doc);
if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}

var document = new BsonDocument
{
    { "item", "canvas" },
    { "qty", 100 },
    { "tags", new BsonArray { "cotton" } },
    { "size", new BsonDocument { { "h", 28 }, { "w", 35.5 }, { "uom", "cm" } } }
};
collection.InsertOne(document);

result, err := coll.InsertOne(
	context.TODO(),
	bson.D{
		{"item", "canvas"},
		{"qty", 100},
		{"tags", bson.A{"cotton"}},
		{"size", bson.D{
			{"h", 28},
			{"w", 35.5},
			{"uom", "cm"},
		}},
	})

Document canvas = new Document("item", "canvas")
        .append("qty", 100)
        .append("tags", singletonList("cotton"));
Document size = new Document("h", 28)
        .append("w", 35.5)
        .append("uom", "cm");
canvas.put("size", size);
Publisher<Success> insertOnePublisher = collection.insertOne(canvas);

Document canvas = new Document("item", "canvas")
        .append("qty", 100)
        .append("tags", singletonList("cotton"));
Document size = new Document("h", 28)
        .append("w", 35.5)
        .append("uom", "cm");
canvas.put("size", size);
collection.insertOne(canvas);

result = collection.insertOne(
Document("item", "canvas")
    .append("qty", 100)
    .append("tags", listOf("cotton"))
    .append("size", Document("h", 28)
        .append("w", 35.5)
        .append("uom", "cm")
    )

await db.inventory.insert_one(
    {
        "item": "canvas",
        "qty": 100,
        "tags": ["cotton"],
        "size": {"h": 28, "w": 35.5, "uom": "cm"},
    }
)

await db.collection('inventory').insertOne({
  item: 'canvas',
  qty: 100,
  tags: ['cotton'],
  size: { h: 28, w: 35.5, uom: 'cm' }
});

$insertOneResult = $db->inventory->insertOne([
    'item' => 'canvas',
    'qty' => 100,
    'tags' => ['cotton'],
    'size' => ['h' => 28, 'w' => 35.5, 'uom' => 'cm'],
]);

db.inventory.insert_one(
    {
        "item": "canvas",
        "qty": 100,
        "tags": ["cotton"],
        "size": {"h": 28, "w": 35.5, "uom": "cm"},
    }
)

client[:inventory].insert_one({ item: 'canvas',
                                qty: 100,
                                tags: [ 'cotton' ],
                                size: { h: 28, w: 35.5, uom: 'cm' } })

collection.insertOne(
  Document("item" -> "canvas", "qty" -> 100, "tags" -> Seq("cotton"), "size" -> Document("h" -> 28, "w" -> 35.5, "uom" -> "cm"))
).execute()

insertOne()は、新しく挿入されたドキュメントの _id フィールド値を含むドキュメントを返します。返されたドキュメントの例については、「db.collection.insertOne() リファレンス」を参照してください。

注意

MongoDB Compass は、_id フィールドとその値を自動的に生成します。生成された ObjectId は、ランダムに生成された一意の 16 進値で構成されます。

この値は、ドキュメントが一意であり、有効なObjectIdである限り、ドキュメントを挿入する前に変更できます。 _idフィールドの詳細については、「 _id フィールド」を参照してください。

挿入したばかりのドキュメントを検索するには、コレクションをクエリします。MongoDB Compass のクエリバーでフィルターを指定し、Find をクリックしてクエリを実行します。

次のフィルターは、MongoDB Compass が item フィールドが canvas に等しいドキュメントのみを返すように指定します。MongoDB Compass クエリバーの詳細については、「クエリバー」を参照してください。

mongoc_collection_insert_one は、成功した場合は true を返します。無効な引数またはサーバーまたはネットワークエラーがある場合は false を返し、エラーを設定します。