ドキュメントの挿入
collection.insertOne() メソッドを使用して、コレクションにドキュメントを挿入できます使用して複数のドキュメントを挿入できます。 ドキュメントを挿入するには、保存するフィールドと値を含む オブジェクトを定義します。 指定されたコレクションが存在しない場合は、 insertOne()
メソッドによってコレクションが作成されます。
options
パラメータを使用して、追加のクエリ オプションを指定できます。 メソッド パラメーターの詳細については、 insertOne() API ドキュメント を参照してください 。このメソッドの詳細については、 insertOne() API ドキュメント を参照してください。
この操作でドキュメントが正常に挿入されると、メソッド呼び出しで渡されたオブジェクトに insertedId
フィールドが追加され、フィールドの値が挿入されたドキュメントの _id
に設定されます。
互換性
Node.js ドライバーを使用して接続し、次の環境でホストされている配置にinsertOne()
メソッドを使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる、MongoDB の自己管理型バージョン
MongoDB Atlas でホストされている配置の Atlas UI にドキュメントを挿入する方法の詳細については、「 ドキュメントの作成、表示、更新、および削除 」を参照してください。
例
注意
この例を使用して、MongoDB のインスタンスに接続し、サンプルデータを含むデータベースと交流できます。MongoDB インスタンスへの接続とサンプルデータセットの読み込みの詳細については、 使用例ガイドを参照してください。
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 async function run() { 9 try { 10 const database = client.db("insertDB"); 11 const haiku = database.collection("haiku"); 12 // create a document to insert 13 const doc = { 14 title: "Record of a Shriveled Datum", 15 content: "No bytes, no problem. Just insert a document, in MongoDB", 16 } 17 const result = await haiku.insertOne(doc); 18 19 console.log(`A document was inserted with the _id: ${result.insertedId}`); 20 } finally { 21 await client.close(); 22 } 23 } 24 run().catch(console.dir);
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 interface Haiku { 9 title: string; 10 content: string; 11 } 12 13 async function run() { 14 try { 15 const database = client.db("insertDB"); 16 // Specifying a Schema is optional, but it enables type hints on 17 // finds and inserts 18 const haiku = database.collection<Haiku>("haiku"); 19 const result = await haiku.insertOne({ 20 title: "Record of a Shriveled Datum", 21 content: "No bytes, no problem. Just insert a document, in MongoDB", 22 }); 23 console.log(`A document was inserted with the _id: ${result.insertedId}`); 24 } finally { 25 await client.close(); 26 } 27 } 28 run().catch(console.dir);
上記の例を実行すると、次の出力が表示されます。
A document was inserted with the _id: <your _id value>