Docs Menu
Docs Home
/
MongoDB 드라이버

MongoDB Swift 드라이버

이 페이지의 내용

  • 서론
  • 설치
  • MongoDB Atlas에 연결
  • 로컬 기계에서 MongoDB Server에 연결하기
  • 호환성

공식 MongoDB Swift 드라이버의 설명서 사이트에 오신 것을 환영합니다. 애플리케이션에 드라이버를 추가하여 Swift에서 MongoDB를 사용할 수 있습니다. Swift Package Manager 를 사용하여 다운로드합니다. 또는 사용 가이드의 예제를 사용하여 실행 가능한 프로젝트를 설정하세요.

중요

Swift 드라이버는 2022년부터 더 이상 개발되지 않습니다.

설치를 참조하세요.

MongoDB Atlas 클러스터에 연결하려면 클러스터에 대한 Atlas 연결 문자열을 사용하세요.

import MongoSwiftSync
defer {
// free driver resources
cleanupMongoSwift()
}
// replace the following string with your connection uri
let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority"
let client = try MongoClient(uri)
// print a list of database names
print (try client.listDatabaseNames())
// your application logic
import MongoSwift
import NIO
let elg = MultiThreadedEventLoopGroup(numberOfThreads: 4)
// replace the following string with your connection uri
let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority"
let client = try MongoClient(
uri,
using: elg
)
defer {
// clean up driver resources
try? client.syncClose()
cleanupMongoSwift()
// shut down EventLoopGroup
try? elg.syncShutdownGracefully()
}
// print a list of database names
print(try client.listDatabaseNames().wait())
// your application logic

참고

Atlas Serverless에 연결하는 방법에 대한 자세한 내용은 서비스리스 인스턴스 제한 페이지에서 필요한 최소 드라이버 버전을 참조하세요.

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

  1. MongoDB Server의 Community 또는 Enterprise 버전을 다운로드하세요.

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

  3. 서버를 시작합니다.

중요

악의적인 공격으로부터 항상 MongoDB 서버를 보호하세요. 보안 체크리스트에서 보안 권장 사항 목록을 확인하세요.

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

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

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

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

이 섹션의 호환성 표에는 특정 버전의 MongoDB와 함께 사용하기 위해 권장되는 MongoDB Swift 드라이버 버전이 명시되어 있습니다.

첫 번째 열에는 드라이버 버전이 나열됩니다.

중요

MongoDB는 서버 버전의 수명 종료(EOL) 날짜 이후 3년 동안 MongoDB Server와 드라이버 간의 호환성을 보장합니다. MongoDB 릴리스 및 EOL 날짜에 대한 자세한 내용은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

Icon
설명

모든 기능이 지원됩니다.

드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.

표시 없음

드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.

Swift 드라이버 버전
MongoDB 7.0
MongoDB 6.0
MongoDB 5.0
MongoDB 4.4
MongoDB 4.2
MongoDB 4.0
MongoDB 3.6

1.3.0 [1]

1.2.0 [1]

1.1.0 [2]

1.0.0 [2]

Swift 드라이버는 현재 개발 중이 아니기 때문에 MongoDB Server 버전 7.0 이상에서 테스트되지 않았습니다.

Swift 드라이버는 3.6 이전의 MongoDB 서버 버전과 호환되지 않습니다.

[1](1, 2) 버전 1.2 및 1.3에는 클라이언트 사이드 필드 레벨 암호화, GridFS 및 AWS IAM 역할을 사용한 인증에 대한 지원이 포함되어 있지 않습니다.
[2](1, 2)) 버전 1.0 및 1.1에는 OCSP, 클라이언트 사이드 필드 레벨 암호화, GridFS 및 AWS IAM 역할을 사용한 인증에 대한 지원이 포함되어 있지 않습니다.

MongoDB Swift 드라이버는 Swift 5.1 이상이 필요합니다.

호환성 표를 읽는 방법에 대한 자세한 내용은 MongoDB 호환성 표에 대한 가이드를 참조하세요.

돌아가기

Ruby 드라이버