/ /

MongoDB에 연결

개요

이 가이드 에서는 Django 프로젝트와 MongoDB 의 연결을 구성하는 방법을 학습 수 있습니다.

연결 구성

장고 MongoDB 백엔드를 설치하고 프로젝트 만든 후 프로젝트의 settings.py 파일 에서 DATABASES 설정을 수정하여 MongoDB 에 대한 연결을 구성할 수 있습니다.

팁

Django MongoDB 백엔드를 설치하고 Django 프로젝트 만드는 방법을 학습 Django MongoDB 백엔드 시작하기 튜토리얼을 참조하세요.

다음 코드에 표시된 대로 DATABASES 을 default 키가 포함된 딕셔너리로 설정합니다.

DATABASES = {
    "default": {
        # Specify nested dictionary keys here
    },
}

default 키를 구성하려면 중첩된 사전을 해당 값으로 할당합니다. 이 중첩 사전에는 다음과 같은 키가 있습니다.

키	설명
ENGINE	연결에 사용할 백엔드 운전자 . 이 키를 `"django_mongodb_backend"`(으)로 설정합니다.
호스트	호스트 이름입니다. 로컬 호스트 연결의 경우 이 키는 선택 사항입니다. SRV 연결의 경우 체계 접두사()를 포함해야`mongodb+srv://` 합니다. 이 키에 연결 URI를 지정할 수도 있습니다. 자세한 내용은 데이터베이스 설정 자동 구성을 참조하세요. 둘 이상의 호스팅하다 지정하려면 하나의 문자열에 모든 호스트 이름을 포함합니다. 쉼표를 사용하여 각 호스트 이름을 구분하세요. 예시: `"HOST": "mongodb://mongos0.example.com:27017,mongos1.example.com:27017"`
이름	사용하려는 데이터베이스 .
사용자	연결에 인증 필요한 경우 데이터베이스 인증을 위한 사용자 이름 .
PASSWORD	연결에 인증 필요한 경우 데이터베이스 사용자의 비밀번호입니다.
포트	데이터베이스 서버 수신 대기 중인 포트 번호입니다. 기본값 포트는 `27017` 입니다. MongoDB Atlas 연결의 경우 이 키는 선택 사항입니다.
옵션	데이터베이스 에 대한 추가 연결 옵션의 사전입니다. 이 키는 `OPTIONS` 선택 사항입니다. 키에서 설정하다 수 있는 연결 옵션의 전체 목록을 보려면 PyMongo API 문서에서 MongoClient에 대한 선택적 매개변수를 참조하세요.

이 섹션에서는 DATABASES 설정을 사용하여 다음과 같은 방법으로 연결을 구성하는 방법을 보여 줍니다.

데이터베이스 설정 자동 구성: 중첩된 HOST 키를 사용하여 연결 URI를 지정하고 연결 설정을 자동으로 구성합니다.
데이터베이스 설정 수동 구성: 여러 사전 키에 대한 연결 설정을 지정합니다.

데이터베이스 설정 자동 구성

중요

v5.2.1에 추가됨

장고 MongoDB 백엔드 v5.2.1 중첩된 HOST 키에 연결 URI를 지정하기 위한 지원 추가합니다. 이전 버전을 사용하는 경우에도 연결을 수동으로 구성 하거나 더 이상 사용되지 않는 parse_uri() 함수를 사용할 수 있습니다.

연결 URI에 연결 설정을 지정하려면 다음과 같은 중첩된 default 키를 설정하다 .

ENGINE: "django_mongodb_backend" 로 설정합니다.
HOST: 연결 URI로 설정합니다.
NAME: 사용하려는 데이터베이스 의 이름으로 설정합니다.

이전 섹션 에서 설명한 다른 모든 키는 선택 사항입니다.

예시

이 예시 ENGINE, HOST 및 NAME 키만 사용하여 MongoDB 에 대한 연결을 구성합니다. DATABASES 설정은 다음 조치를 수행합니다.

사용자 이름 my_user 이고 비밀번호가 my_password인 데이터베이스 사용자에 대한 인증 정보를 제공합니다.
retryWrites 연결 옵션을 true로 설정하여 특정 쓰기 (write) 작업이 실패할 경우 자동으로 재시도하도록 운전자 구성합니다.
w 연결 옵션을 majority로 설정하여 쓰기 (write) 작업을 수행하기 전에 대부분의 복제본 세트 멤버의 승인을 기다리도록 운전자 구성합니다.
데이터베이스 다음으로 설정합니다. my_database

DATABASES = {
    "default": {
        "ENGINE": "django_mongodb_backend",
        "HOST": "mongodb+srv://my_user:my_password@cluster0.example.mongodb.net/?retryWrites=true&w=majority",
        "NAME": "my_database",
}

참고

DATABASES 설정에서 추가 키를 지정하면 해당 키의 값이 연결 URI에서 구문 분석된 충돌하는 모든 값을 재정의합니다.

데이터베이스 설정 수동 구성

default 키 전체에 연결 정보를 지정하여 연결 설정을 수동으로 구성할 수 있습니다.

예시

이 예시 사전 키를 사용하여 이전 예시와 동일한 데이터베이스 연결을 구성합니다.

DATABASES = {
    "default": {
        "ENGINE": "django_mongodb_backend",
        "HOST": "mongodb+srv://cluster0.example.mongodb.net",
        "NAME": "my_database",
        "USER": "my_user",
        "PASSWORD": "my_password",
        "PORT": 27017,
        "OPTIONS": {
            "retryWrites": "true",
            "w": "majority",
        },
    },
}

추가 정보

MongoDB database 연결을 구성하는 샘플 프로젝트 보려면 시작하기 튜토리얼의 MongoDB 연결 구성 단계를 참조하세요.

장고 설정에 대해 자세히 학습 장고 문서에서 설정을 참조하세요.

돌아가기

시작하기

모델 데이터