Docs Menu

PyMongo 시작하기

PyMongo는 MongoDB에 연결하고 통신하는 데 사용할 수 있는 Python 패키지입니다. 이 가이드에서는 를 사용하여 에서 PyMongo 호스팅되는 에 연결하는 애플리케이션을 만드는 MongoDB cluster MongoDB Atlas방법을 보여줍니다.

MongoDB Atlas는 관리형 클라우드 데이터베이스 서비스로, MongoDB deployment를 호스팅합니다. 이 가이드의 단계에 따라 자체 무료(신용카드 필요 없음) MongoDB Atlas 배포서버를 생성할 수 있습니다.

이 가이드에 따라 샘플 Python 애플리케이션을 MongoDB Atlas 배포에 연결합니다. 다른 드라이버 또는 프로그래밍 언어를 사용하여 MongoDB에 연결하려는 경우 공식 드라이버 목록을 참조하세요.

참고

대체 설치 방법

다음 단계는 pip 을 사용하여 PyMongo 설치하는 방법을 보여줍니다. 소스에서 PyMongo 설치하려면 API 설명서의 소스에서 설치를 참조하세요.

1

개발 환경에 다음 종속성이 설치되어 있는지 확인합니다.

2

셸에서 다음 명령어를 실행하여 이 프로젝트에 대해 pymongo-quickstart라고 명명한 디렉토리를 만듭니다.

mkdir pymongo-quickstart

운영 체제에 해당하는 탭 을 선택하고 다음 명령을 실행 하여 pymongo-quickstart 디렉토리 에 quickstart.py 애플리케이션 파일 을 만듭니다.

cd pymongo-quickstart
touch quickstart.py
cd pymongo-quickstart
type nul > quickstart.py
3

운영 체제에 해당하는 탭 을 선택하고 다음 명령을 실행 하여 운전자 를 설치할 가상 환경을 만들고 활성화합니다.

python3 -m venv venv
source venv/bin/activate
python3 -m venv venv
. venv\Scripts\activate

가상 환경이 활성화된 상태에서 다음 명령을 실행하여 현재 버전의 PyMongo를 설치합니다.

python3 -m pip install pymongo

이 단계를 완료하면 새 프로젝트 디렉토리와 드라이버 종속성이 설치됩니다.

MongoDB Atlas 에서 무료 계층 MongoDB deployment 생성하여 데이터를 저장 하고 관리 수 있습니다. MongoDB Atlas cloud 에서 MongoDB database 호스팅하고 관리합니다.

1

Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 새로운 프리 계층 MongoDB 배포서버에 샘플 데이터를 로드하세요.

2

데이터베이스 사용자를 생성한 후 다음 단계에서 사용할 수 있도록 해당 사용자의 사용자 이름과 비밀번호를 안전한 위치에 저장하세요.

이 단계를 완료하면 Atlas에 새로운 무료 티어 MongoDB 배포, 데이터베이스 사용자 자격 증명, 샘플 데이터가 데이터베이스에 로드됩니다.

연결 문자열이라고도 하는 연결 URI을 제공하여 MongoDB 배포서버에 연결할 수 있으며, 이 연결 문자열은 드라이버에 MongoDB 배포서버로 연결하는 방법과 연결된 동안 동작하는 방법을 지시합니다.

연결 문자열에는 배포서버의 호스트 이름 또는 IP 주소와 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 연결 옵션 등이 포함됩니다.

Atlas 에서 호스팅되지 않는 인스턴스 또는 배포서버 에 연결하려면 연결 대상 선택을 참조하세요.

1

이전 단계에서 만든 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그 Database 섹션으로 이동한 다음 새 배포서버에 대한 Connect 버튼을 클릭합니다.

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

Connect your application 섹션으로 이동하여 Driver 선택 메뉴에서 'Python'을 선택하고 Version 선택 메뉴에서 설치한 버전과 가장 일치하는 버전을 선택합니다.

Password (SCRAM) 인증 메커니즘을 선택합니다.

연결 문자열을 보려면 Include full driver code example 옵션을 선택 취소합니다.

2

다음 스크린샷에 표시된 대로 연결 문자열 오른쪽에 있는 버튼을 클릭하여 클립보드에 복사합니다.

Atlas UI의 연결 문자열 복사 버튼
3

이 연결 문자열을 원하는 텍스트 편집기의 파일에 붙여넣고 <username><password> 자리 표시자를 데이터베이스 사용자의 사용자 이름 및 비밀번호로 바꿉니다.

다음 단계에서 사용할 수 있도록 이 파일을 안전한 위치에 저장합니다.

이 단계를 완료하면 데이터베이스 사용자 이름과 비밀번호가 포함된 연결 문자열이 생성됩니다.

1

다음 코드를 복사하여 애플리케이션의 quickstart.py 파일에 붙여넣습니다.

from pymongo import MongoClient
uri = "<connection string URI>"
client = MongoClient(uri)
try:
database = client.get_database("sample_mflix")
movies = database.get_collection("movies")
# Query for a movie that has the title 'Back to the Future'
query = { "title": "Back to the Future" }
movie = movies.find_one(query)
print(movie)
client.close()
except Exception as e:
raise Exception("Unable to find the document due to the following error: ", e)
2

<connection string URI> 자리 표시자를 이 가이드의 연결 문자열 만들기 단계에서 복사한 연결 문자열로 바꿉니다.

3

셸에서 다음 명령을 실행하여 애플리케이션을 시작합니다:

python3 quickstart.py

출력에는 조회된 영화 문서의 세부 정보가 포함됩니다.

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

오류가 발생하거나 출력이 표시되지 않는 경우 적절한 연결 string 을 지정했는지, 샘플 데이터를 로드했는지 확인합니다.

이 단계를 완료한 후에는 드라이버를 사용하여 MongoDB deployment에 연결하고, 샘플 데이터에 대해 쿼리를 실행하고, 결과를 출력하는 등 정상적으로 작동하는 애플리케이션을 갖게 될 것입니다.

튜토리얼을 완료한 것을 축하합니다!

이 튜토리얼에서는 MongoDB Atlas에서 호스팅되는 MongoDB 배포서버에 연결하고 쿼리와 일치하는 문서를 검색하는 Python 애플리케이션을 만들었습니다.

다음 리소스에서 PyMongo에 대해 자세히 알아보세요.

  • 문서 삽입 섹션에서 문서를 삽입하는 방법을 알아보세요.

  • 쿼리 섹션에서 문서를 찾는 방법을 알아보세요.

  • 문서 업데이트 섹션에서 문서를 업데이트 방법을 알아보세요.

  • 문서 삭제 섹션에서 문서를 삭제 방법을 알아보세요.

참고

이 단계에서 문제가 발생하면 MongoDB Community 포럼 에서 도움을 요청하거나 이 페이지의 오른쪽 또는 오른쪽 아래에 있는 Rate this page 탭을 사용하여 피드백을 제출하세요.