/ /

빠른 참조

이 페이지에서는 여러 MongoDB 명령의 드라이버 구문과 관련 참조 및 API 문서에 대한 링크를 보여줍니다.

호환성

다음 환경에서 호스팅되는 배포에 Node.js 드라이버를 연결해 명령을 실행할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
MongoDB Enterprise: 구독 기반의 자체 관리형 MongoDB 버전입니다.
MongoDB Community: 소스 사용 가능하고, 무료로 사용할 수 있는 자체 관리형 MongoDB 버전

MongoDB Atlas에서 호스팅되는 배포를 위해 Atlas UI에서 일반적인 CRUD 작업을 수행하는 방법에 관한 자세한 내용은 문서 만들기, 보기, 업데이트 및 삭제하기 항목을 참조하세요.

명령

구문

문서 찾기

API 문서
문서 찾기 가이드

await coll.findOne({ title: 'Hamlet' });

{ title: 'Hamlet', type: 'movie', ... }

여러 문서 찾기

API 문서
문서 찾기 가이드

coll.find({ year: 2005 });

[
  { title: 'Christmas in Boston', year: 2005, ... },
  { title: 'Chicken Little', year: 2005, ... },
  ...
]

문서 삽입

API 문서
문서 삽입 가이드

await coll.insertOne({ title: 'Jackie Robinson' });

여러 문서를 삽입합니다.

API 문서
문서 삽입 가이드

await coll.insertMany([
  { title: 'Dangal', rating: 'Not Rated' },
  { title: 'The Boss Baby', rating: 'PG' }
 ]);

문서 업데이트

API 문서
문서 업데이트 가이드

await coll.updateOne(
  { title: 'Amadeus' },
  { $set: { 'imdb.rating': 9.5 } }
);

{ title: 'Amadeus', imdb: { rating: 9.5, ... } }

여러 문서 업데이트하기

API 문서
문서 업데이트 가이드

await coll.updateMany(
  { year: 2001 },
  { $inc: { 'imdb.votes': 100 } }
);

[
  { title: 'A Beautiful Mind', year: 2001, imdb: { votes: 826257, ... },
  { title: 'Shaolin Soccer', year: 2001, imdb: { votes: 65442, ... },
  ...
]

문서 배열 업데이트

API 문서
문서 가이드에서 배열 업데이트

await coll.updateOne(
  { title: 'Cosmos' },
  { $push: { genres: 'Educational' } }
):

{ title: 'Cosmos', genres: [ 'Documentary', 'Educational' ] }

문서 교체하기

API 문서
문서 교체 가이드

await coll.replaceOne(
  { name: 'Deli Llama', address: '2 Nassau St' },
  { name: 'Lord of the Wings', zipcode: 10001 }
);

{ name: 'Lord of the Wings', zipcode: 10001 }

문서 삭제

API 문서
문서 삭제 가이드

await coll.deleteOne({ title: 'Congo' });

여러 문서 삭제

API 문서
문서 삭제 가이드

await coll.deleteMany({ title: { $regex: /^Shark.*/ } });

대량 쓰기

API 문서
대량 작업 가이드

await coll.bulkWrite([
  {
    insertOne: {
      document: {
        title: 'A New Movie',
        year: 2022
      }
    }
  },
  {
    deleteMany: {
      filter: { year: { $lt: 1970 } }
    }
  }
]);

BulkWriteResult {
  result: {
    ...
  },
  ...
}

변화를 주시하세요

API 문서
Change Streams로 데이터 모니터링 가이드

coll.watch([ { $match: { year: { $gte: 2022 } } } ]);

커서에서 반복적으로 데이터에 액세스

커서 가이드 에서 데이터 액세스

const cursor = coll.find();
for await (const doc of cursor) {
   console.dir(doc);
}

[
  { title: '2001: A Space Odyssey', ... },
  { title: 'The Sound of Music', ... },
  ...
]

커서에서 배열로 데이터에 액세스

API 문서
커서 가이드 에서 데이터 액세스

const cursor = coll.find();
const results = await cursor.toArray();

[
  { title: '2001: A Space Odyssey', ... },
  { title: 'The Sound of Music', ... },
  ...
]

문서 수 계산

API 문서
문서 수 가이드

await coll.countDocuments({ year: 2000 });

고유 문서 또는 필드 값 나열
API 문서
Retrieve Distinct Values Guide

await coll.distinct('year');

[ 1891, 1893, 1894, 1896, 1903, ... ]

조회되는 문서 수 제한

API 문서
문서 참조 제한

coll.find().limit(2);

[
  { title: 'My Neighbor Totoro', ... },
  { title: 'Amélie', ... }
]

조회된 문서 건너뛰기

API 문서
문서 참조 건너뛰기

coll.find({ title: { $regex: /^Rocky/} }, { skip: 2 });

[
  { title: 'Rocky III', ... },
  { title: 'Rocky IV', ... },
  { title: 'Rocky V'}, ... }
]

조회 시 문서 정렬

API 문서
문서 정렬 참조

coll.find().sort({ year: 1});

[
  { title: 'Newark Athlete', year: 1891, ... },
  { title: 'Blacksmith Scene', year: 1893, ...},
  { title: 'Dickson Experimental Sound Film', year: 1894},
  ...
]

조회 시 문서 필드 프로젝트

API 문서
반환할 필드 지정 가이드

coll.find().project({ _id: 0, year: 1, imdb: 1 });

[
  { year: 2012, imdb: { rating: 5.8, votes: 230, id: 8256 }},
  { year: 1985, imdb: { rating: 7.0, votes: 447, id: 1654 }},
  ...
]

인덱스 만들기

API 문서
Indexes Guide

await coll.createIndex({ title: 1, year: -1 });

쿼리 텍스트

API 문서
쿼리 텍스트 가이드

// only searches fields with text indexes
coll.find({ $text: { $search: 'zissou' } });

[
  { title: 'The Life Aquatic with Steve Zissou', ... }
]

드라이버 종속성 설치하기

package.json

"dependencies": {
  "mongodb": "^7.6",
  ...
}

돌아가기

업그레이드 가이드

TypeScript