MongoDB Swift 驱动程序
简介
欢迎使用官方 MongoDB Swift 驱动程序的文档网站。您可以将此驱动程序添加到您的应用程序中,以便在 Swift 中使用 MongoDB。使用Swift 包管理器 或通过我们的使用指南中的示例设置可运行的工程来下载。
重要
自 2022 年起,Swift 驱动程序不再处于积极开发状态。
提示
如果您想了解有关使用 Swift 与 MongoDB Realm 的信息,请参阅 MongoDB Realm iOS SDK 文档。
安装
请参阅安装
连接到MongoDB Atlas
要连接到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服务器
如果您需要在本地计算机上运行MongoDB服务器进行开发,而不是使用Atlas集群,则需要完成以下步骤
重要
始终确保您的MongoDB服务器免受恶意攻击。请参阅我们的安全清单,了解安全建议列表。
在成功启动您的MongoDB服务器后,在驱动程序连接代码中指定您的连接字符串。
如果您的MongoDB服务器在本地运行,您可以使用以下连接字符串"mongodb://localhost:<端口号>"
其中 <端口号>
是您配置服务器监听传入连接的端口号。
如果您需要指定不同的主机名或IP地址,请参阅我们关于连接字符串的服务器手册条目。
为了测试您是否可以连接到服务器,将连接字符串替换为连接到MongoDB Atlas代码示例,并运行它。
兼容性
mongodb 兼容性
本节中的兼容性表格指定了与特定版本的 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兼容性表格.
如何获取帮助
在我们的MongoDB社区论坛提问。
访问我们的支持渠道。
查看我们的SWIFT JIRA项目提出问题或请求功能。