文档菜单
文档首页
/
MongoDB 驱动程序

MongoDB Swift 驱动程序

本页内容

  • 简介
  • 安装
  • 连接到 MongoDB Atlas
  • 连接到您本地机器上的 MongoDB 服务器
  • 兼容性

欢迎使用官方 MongoDB Swift 驱动程序的文档网站。您可以将此驱动程序添加到您的应用程序中,以便在 Swift 中使用 MongoDB。使用Swift 包管理器 或通过我们的使用指南中的示例设置可运行的工程来下载。

重要

自 2022 年起,Swift 驱动程序不再处于积极开发状态。

提示

如果您想了解有关使用 Swift 与 MongoDB Realm 的信息,请参阅 MongoDB Realm iOS SDK 文档。

请参阅安装

要连接到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的信息,请参阅无服务器实例限制页面,了解您所需的最低驱动程序版本。

如果您需要在本地计算机上运行MongoDB服务器进行开发,而不是使用Atlas集群,则需要完成以下步骤

  1. 下载MongoDB服务器的社区版企业版

  2. 安装和配置 MongoDB服务器。

  3. 启动服务器。

重要

始终确保您的MongoDB服务器免受恶意攻击。请参阅我们的安全清单,了解安全建议列表。

在成功启动您的MongoDB服务器后,在驱动程序连接代码中指定您的连接字符串。

如果您的MongoDB服务器在本地运行,您可以使用以下连接字符串"mongodb://localhost:<端口号>" 其中 <端口号> 是您配置服务器监听传入连接的端口号。

如果您需要指定不同的主机名或IP地址,请参阅我们关于连接字符串的服务器手册条目。

为了测试您是否可以连接到服务器,将连接字符串替换为连接到MongoDB Atlas代码示例,并运行它。

本节中的兼容性表格指定了与特定版本的 MongoDB 一起使用的 MongoDB Swift 驱动的推荐版本或版本。

第一列列出了驱动程序版本。

重要

MongoDB 在服务器版本的生命周期结束日期(EOL)后三年确保 MongoDB 服务器与驱动程序的兼容性。有关 MongoDB 发布和 EOL 日期的更多信息,请参阅 MongoDB 软件生命周期计划。

图标
说明
所有功能都受支持。
驱动程序版本将与 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 服务器版本 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 驱动程序