PyMongo

서론

동기식 Python 애플리케이션을 위한 공식 MongoDB 드라이버인 PyMongo의 설명서 사이트에 오신 것을 환영합니다.pip 을(를) 사용하여 다운로드합니다. 또는 튜토리얼에 따라 실행 가능한 프로젝트를 설정하세요.

• 튜토리얼 MongoDB에 연결하고 일반적인 작업을 실행하는 방법을 설명합니다.

• API 참조

• ChangeLog

• 소스 코드

다음은 PyMongo 드라이버를 사용하여 배포서버에 연결할 수 있는 환경입니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: 구독 기반의 자체 관리형 MongoDB 버전

• MongoDB Community: 무료로 사용할 수 있는 소스 제공의 자체 관리형 MongoDB 버전입니다.

MongoDB에서 제공하는 무료 온라인 강좌 수강하기

	Python과 함께 MongoDB 사용 MongoDB로 Python 애플리케이션 개발의 필수 사항을 알아보세요.

설치

Python 애플리케이션에서 사용할 수 있도록 하려면 PyMongo 드라이버 모듈을 설치해야 합니다.pip 사용을 권장합니다. PyMongo를 설치합니다.

PyMongo에는 dnspython 이 mongodb+srv:// 필요합니다. 연결 문자열 및 MongoDB Atlasdnspython 를 지원합니다. 는 최신 PyMongo 버전을 설치하거나 업그레이드할 때 자동으로 설치됩니다.

다음 명령은 명령줄을 사용하여 최신 버전 모듈을 설치하는 방법을 보여줍니다.

$ python -m pip install pymongo

특정 버전의 PyMongo를 설치해야 하는 경우 명령에 버전을 명시하세요. 다음 명령은 pip를 사용하여 PyMongo 버전 3.11을 설치하는 방법을 보여줍니다.

$ python -m pip install pymongo==3.11

PyMongo가 이미 설치되어 있고 최신 버전으로 업그레이드해야 하는 경우 다음 pip 명령을 사용합니다.

$ python -m pip install --upgrade pymongo

설치 참조 PyMongo를 설치하는 더 많은 방법을 확인하세요.

MongoDB Atlas에 연결

다음 연결 스니펫을 사용하여 Atlas에서 MongoDB deployment에 대한 연결을 테스트할 수 있습니다.

from pymongo.mongo_client import MongoClient
from pymongo.server_api import ServerApi
# Replace the placeholder with your Atlas connection string
uri = "<connection string>"
# Set the Stable API version when creating a new client
client = MongoClient(uri, server_api=ServerApi('1'))
                          
# Send a ping to confirm a successful connection
try:
    client.admin.command('ping')
    print("Pinged your deployment. You successfully connected to MongoDB!")
except Exception as e:
    print(e)

연결 스니펫은 스테이블 API(Stable API) 기능을 사용합니다. 이 기능은 PyMongo 드라이버 v3.12 이상 사용 시 활성화할 수 있으며 추후 MongoDB Server v5.0 이상에 연결할 때에도 사용됩니다. 이 기능을 사용하면 스테이블 API에서 다루는 모든 명령의 하위 호환성 문제에 대한 걱정 없이 드라이버나 서버를 업데이트할 수 있습니다.

Stable API 기능에 대해 자세히 알아보려면 서버 매뉴얼의 Stable API 를 참조하세요.

스테이블 API 없이 MongoDB Atlas에 연결하기

Stable API 기능에 대한 지원이 없는 MongoDB 버전 또는 드라이버를 사용하는 경우, 다음 코드 스니펫을 사용하여 Atlas에서 MongoDB 배포에 대한 연결을 테스트할 수 있습니다.

from pymongo.mongo_client import MongoClient
# Replace the placeholder with your Atlas connection string
uri = "<connection string>"
# Create a new client and connect to the server
client = MongoClient(uri)
# Send a ping to confirm a successful connection
try:
    client.admin.command('ping')
    print("Pinged your deployment. You successfully connected to MongoDB!")
except Exception as e:
    print(e)

AWS 람다에서 MongoDB 아틀라스에 연결하기

AWS Lambda에서 Atlas에 연결하는 방법을 알아보려면 AWS Lambda로 연결 관리 문서를 참조하세요.

로컬 기계에서 MongoDB Server에 연결하기

Atlas cluster를 사용하는 대신 개발 목적으로 로컬 컴퓨터에서 MongoDB 서버를 실행해야 하는 경우, 다음을 완료해야 합니다:

1. MongoDB Server의 Community 또는 Enterprise 버전을 다운로드합니다.

2. MongoDB Server 를 설치하고 구성합니다 .

3. 서버를 시작합니다.

MongoDB Server를 성공적으로 시작한 후에는 드라이버 연결 코드에 연결 문자열을 지정하세요.

MongoDB Server가 로컬에서 실행되는 경우 연결 문자열("mongodb://localhost:<port>")을 사용할 수 있습니다. 여기서 <port>는 서버가 들어오는 연결을 수신하도록 구성한 포트 번호입니다.

다른 호스트 이름이나 IP 주소를 지정해야 하는 경우 연결 문자열에 대한 서버 매뉴얼 항목을 참조하세요.

서버에 연결할 수 있는지 테스트하려면 MongoDB Atlas 에 연결 코드 예제에서 연결 문자열을 바꾸고 실행하세요.

호환성