ドキュメントの挿入

Overview

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

挿入操作は 、1 つ以上の ドキュメント をMongoDBコレクションに挿入します。 次の方法を使用して、挿入操作を実行できます。

• insert_one : 単一のドキュメントを挿入する

• insert_many : 1 つ以上のドキュメントを挿入する

database = client.use('sample_restaurants')
collection = database[:restaurants]

_id フィールド

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

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

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

• ドライバーがドキュメント_idフィールドごとに一意のBSON::ObjectId値を自動的に生成できるようにします。

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

_idフィールドの詳細については、 マニュアルの 「 一意なインデックス 」MongoDB Server のガイドを参照してください。

ドキュメント構造とルールの詳細については、MongoDB Server マニュアルのドキュメントガイド を参照してください。

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

MongoDBコレクションに単一のドキュメントを追加するには、insert_one メソッドを呼び出し、挿入するドキュメントを渡します。

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

document = { name: 'Neighborhood Bar & Grill', borough: 'Queens' }
collection.insert_one(document)

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

MongoDBコレクションに複数のドキュメントを追加するには 、insert_many メソッドを呼び出して、挿入するドキュメントのリストを渡します。

次の例では、 restaurantsコレクションに 2 つのドキュメントを挿入しています。

documents = [
  { name: 'Metropolitan Cafe', borough: 'Queens' },
  { name: 'Yankee Bistro', borough: 'Bronx' }
]
collection.insert_many(documents)

挿入動作の変更

挿入操作を構成するオプションを設定するには、Hashオブジェクトをinsert_one メソッドのパラメーターとして渡します。オプションを指定しない場合、ドライバーはデフォルト設定で挿入操作を実行します。

次の表では、 insert_one操作を構成するために設定できるオプションについて説明します。

メソッド呼び出しのパラメーターとして Hash を渡すことで、insert_many メソッドで上記の設定を設定できます。ordered オプションを使用して、ドライバーがMongoDBにドキュメントを挿入する順序を指定することもできます。

documents = [
  { name: 'Cloudy Day', borough: 'Brooklyn' },
  { name: 'Squall or Shine', borough: 'Staten Island' }
  { name: 'Rose Field', borough: 'Queens' }
]
options = { bypass_document_validation: true }
collection.insert_many(documents, options)

API ドキュメント

このガイドで説明されているメソッドの詳細については、次の API ドキュメントを参照してください。

• insert_one

• insert_many