연결 대상 선택

개요

이 가이드에서는 연결 string 과 MongoClient 객체를 사용하여 다양한 유형의 MongoDB deployment에 연결하는 방법을 배울 수 있습니다.

아틀라스

MongoDB 에서 deployment에 Atlas 연결하려면 연결 에 다음 요소를 string 포함하세요.

• Atlas cluster의 URL

• MongoDB 사용자 이름

• MongoDB 비밀번호

그런 다음 연결 string 을 MongoClient 생성자에 전달합니다.

Atlas에 연결할 때 Stable API 클라이언트 옵션을 사용하여 Atlas를 새 버전의 MongoDB Server로 업그레이드할 때 호환성이 손상되는 변경을 방지하는 것이 좋습니다. Stable API 기능에 대해 자세히 알아보려면 Stable API 페이지를 참조하세요.

다음 코드는 PyMongo를 사용하여 Atlas cluster에 연결하는 방법을 보여줍니다. 또한 이 코드는 server_api 옵션을 사용하여 stable API 버전을 지정합니다.

from pymongo import MongoClient
from pymongo.server_api import ServerApi
# Replace the placeholder with your Atlas connection string
uri = "<connection string>"
# Create a MongoClient with a MongoClientOptions object to set the Stable API version
client = MongoClient(uri, server_api=ServerApi(
    version='1', strict=True, deprecation_errors=True))
try:
    # Connect the client to the server (optional starting in v4.7)
    client.connect()
    # Send a ping to confirm a successful connection
    client.admin.command({'ping': 1})
    print("Pinged your deployment. You successfully connected to MongoDB!")
finally:
    # Ensures that the client will close when you finish/error
    client.close()

로컬 배포

로컬 MongoDB deployment에 연결하려면 localhost 을 호스트 이름으로 사용합니다. 기본적으로 mongod 프로세스는 포트 27017 에서 실행되지만, 배포서버에 맞게 사용자 지정할 수 있습니다.

다음 코드는 PyMongo를 사용하여 로컬 MongoDB deployment에 연결하는 방법을 보여줍니다.

from pymongo import MongoClient
uri = "mongodb://localhost:27017/"
client = MongoClient(uri)

복제본 세트

복제본 세트에 연결하려면 연결 에 IP 복제본 세트 멤버의 호스트 이름(또는 주소)과 포트 번호를 string 지정합니다.

복제본 세트에 있는 호스트의 전체 목록을 제공할 수 없는 경우, 복제본 세트에 있는 호스트 중 하나 이상을 지정하고 PyMongo가 자동 검색을 수행하여 다른 호스트를 찾도록 지시할 수 있습니다. 드라이버에 자동 검색을 수행하도록 지시하려면 다음 작업 중 하나를 수행합니다.

• 복제본 세트의 이름을 replicaSet 매개변수의 값으로 지정합니다.

• directConnection 매개 변수의 값으로 false를 지정합니다.

• 복제본 세트에 둘 이상의 호스트를 지정합니다.

다음 예제에서 드라이버는 샘플 연결 URI를 사용하여 host1를 포함하여 서로 다른 세 호스트의 27017 포트에서 실행 중인 MongoDB 복제본 세트 sampleRS에 연결합니다.

from pymongo import MongoClient
uri = "mongodb://host1:27017/?replicaSet=sampleRS"
client = MongoClient(uri)

from pymongo import MongoClient
client = MongoClient("mongodb://<hostname>:<port>",
                     directConnection=True)

from pymongo import MongoClient
uri = ("mongodb://<hostname>:<port>/?"
       "directConnection=true")
client = MongoClient(uri)

문제 해결

pymongo.errors.ConfigurationError: Server at localhost:27017 reports wire version 5, but this version of PyMongo requires at least 6 (MongoDB 3.6).

API 문서

PyMongo에서 MongoClient 객체를 만드는 방법에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.

• 몽고클라이언트