Docs Menu
Docs Home
/ / /
Node.js

빠른 시작

이 페이지의 내용

  • 프로젝트 설정
  • Node 및 npm 설치
  • 프로젝트 만들기
  • 종속성으로 MongoDB 추가하기
  • MongoDB 클러스터 생성
  • 애플리케이션에 연결
  • 다음 단계

이 가이드에서는 MongoDB Node.js 드라이버를 사용하여 MongoDB Atlas에서 호스팅되는 MongoDB 클러스터에 연결하는 애플리케이션 생성 방법을 설명합니다. 다른 드라이버나 프로그래밍 언어를 사용하여 MongoDB에 연결하려면 공식 드라이버 목록을 참조하세요.

Node.js 드라이버는 MongoDB에 연결하고 MongoDB와 통신하는 데 사용할 수 있는 라이브러리입니다.

MongoDB Atlas는 MongoDB 서버를 호스팅하는 완전 관리형 클라우드 데이터베이스 서비스입니다. 이 가이드를 통해 무료(신용카드 필요 없음) MongoDB 인스턴스를 시작할 수 있습니다.

아래 단계에 따라 샘플 Node.js 애플리케이션을 MongoDB Atlas의 MongoDB 인스턴스에 연결합니다.

개발 환경에 Node.js v12 이상 및 npm(노드 패키지 관리자)이 설치되어 있는지 확인합니다.

Node.js 및 npm 설치 방법에 대한 자세한 내용은 Node.js 및 npm 다운로드 및 설치를 참조하십시오.

먼저 shell 에서 프로젝트 디렉토리 를 만듭니다.

mkdir node_quickstart

그런 다음 해당 디렉토리로 이동합니다.

cd node_quickstart

다음으로 프로젝트를 초기화합니다.

npm init -y

Node.js 드라이버를 설치합니다.

npm install mongodb@4.17

이 명령은 다음 조치를 수행합니다.

  • mongodb 패키지 및 필요한 종속성을 다운로드합니다.

  • 패키지를 node_modules 디렉토리에 저장합니다.

  • 종속성 정보를 package.json 파일에 기록합니다.

이제 애플리케이션 점 Node.js 운전자 를 사용할 준비가 되었습니다.

1

에서 무료 계층 를 생성하여 MongoDB cluster MongoDB Atlas 데이터를 저장하고 관리하세요. MongoDB Atlas 는 클라우드에서 MongoDB database 를 호스팅하고 관리합니다. Atlas 시작하기 가이드를 완료하여 새 Atlas 계정과 무료 계층 클러스터(공유 MongoDB 인스턴스)를 설정하고 샘플 데이터를 클러스터에 로드하세요.

2

드라이버에 연결 string 위치와 방법을 지시하는 연결 을 제공하여 에 연결할 수 있습니다.MongoDB cluster 연결 string 에는 클러스터의 호스트 이름 또는 IP 주소 및 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 기타 연결 옵션에 대한 정보가 포함됩니다.

Atlas 에서 호스팅되지 않는 인스턴스 또는 클러스터 에 연결하려면 MongoDB 에 연결하는 다른 방법을 참조하세요.

이전 단계에서 만든 클러스터의 연결 string 을 검색하려면 Atlas 계정에 로그인하여 Database 섹션으로 이동한 후 아래와 같이 연결하려는 클러스터의 Connect 버튼을 클릭하세요. .

Atlas UI의 클러스터 섹션에 있는 연결 버튼

Connect Your Application 섹션으로 이동하여 Node.js 드라이버를 선택합니다. 아래와 같이 Connection String Only 탭을 선택하고 Copy 버튼을 클릭하여 연결 string 을 클립보드에 복사합니다.

UI의 연결 전용 탭에 있는 연결 string 복사 버튼 string Atlas

연결 string 을 안전한 위치 에 저장합니다.

1

프로젝트 디렉토리에 index.js (이)라는 애플리케이션을 포함할 파일을 만듭니다. 다음 코드를 추가하여 uri 변수에 연결 string 값을 할당합니다.

const { MongoClient } = require("mongodb");
// Replace the uri string with your connection string.
const uri =
"mongodb+srv://<user>:<password>@<cluster-url>?retryWrites=true&w=majority";
const client = new MongoClient(uri);
async function run() {
try {
const database = client.db('sample_mflix');
const movies = database.collection('movies');
// Query for a movie that has the title 'Back to the Future'
const query = { title: 'Back to the Future' };
const movie = await movies.findOne(query);
console.log(movie);
} finally {
// Ensures that the client will close when you finish/error
await client.close();
}
}
run().catch(console.dir);

앞의 코드 예시 에서는 MongoClient 객체 디스트럭처링 을 사용하여 변수를 할당합니다. , Node.js v 에 도입되었습니다.6 다음 코드와 같이 객체 디스트럭처링을 사용하지 않고 MongoClient 의 인스턴스 를 만들 수 있습니다.

const MongoClient = require("mongodb").MongoClient;
2

명령줄에서 이전 단계에서 만든 애플리케이션을 실행합니다.

node index.js

출력에서 검색된 영화 문서의 세부 정보를 볼 수 있습니다.

{
_id: ...,
plot: 'A young man is accidentally sent 30 years into the past...',
genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
...
title: 'Back to the Future',
...
}

오류가 발생하거나 출력이 없는 경우 애플리케이션 코드에 적절한 연결 string 을 지정했는지, 그리고 Atlas 클러스터에 샘플 데이터 세트를 로드했는지 확인하세요.

이 점 에서 Node.js 운전자 를 사용하여 MongoDB 인스턴스 에 연결하고, 샘플 데이터에 대해 쿼리 를 실행하고, 결과를 출력하는 작동하는 애플리케이션 이 있어야 합니다.

CRUD 작업 가이드에서 Node.js 드라이버를 사용하여 데이터를 읽고 수정하는 방법을 알아보거나 사용 예제에서 일반적인 작업을 수행하는 방법을 알아보세요.

← MongoDB 노드 드라이버