문서 삽입
collection.insertOne() 를 사용하여 컬렉션에 문서를 삽입할 수 있습니다. 메서드를 사용하여 컬렉션의 여러 문서를 한 번에 삭제할 수 있습니다. 문서를 삽입하려면 저장하려는 필드와 값이 포함된 객체를 정의하세요. 지정한 컬렉션이 존재하지 않으면 insertOne()
메서드가 컬렉션을 생성합니다.
options
매개 변수를 사용하여 더 많은 쿼리 옵션을 지정할 수 있습니다. 메서드 매개 변수에 대한 자세한 내용은 insertOne() API 설명서를 참조하세요. 이 메서드에 대한 자세한 내용은 insertOne() API 설명서를 참조하세요.
작업이 성공적으로 문서를 삽입하면 메서드 호출에서 전달된 객체에 insertedId
필드를 추가하고 필드 값을 삽입된 문서의 _id
로 설정합니다.
호환성
insertOne()
메서드를 사용하여 다음 환경에서 호스팅되는 배포서버에 Node.js 드라이버를 연결하고 사용할 수 있습니다.
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 // Create a new client and connect to MongoDB 7 const client = new MongoClient(uri); 8 9 async function run() { 10 try { 11 // Connect to the "insertDB" database and access its "haiku" collection 12 const database = client.db("insertDB"); 13 const haiku = database.collection("haiku"); 14 15 // Create a document to insert 16 const doc = { 17 title: "Record of a Shriveled Datum", 18 content: "No bytes, no problem. Just insert a document, in MongoDB", 19 } 20 // Insert the defined document into the "haiku" collection 21 const result = await haiku.insertOne(doc); 22 23 // Print the ID of the inserted document 24 console.log(`A document was inserted with the _id: ${result.insertedId}`); 25 } finally { 26 // Close the MongoDB client connection 27 await client.close(); 28 } 29 } 30 // Run the function and handle any errors 31 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>