对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

创建 MongoClient

要连接到 MongoDB 部署,您需要满足两个条件:

  • A 连接 URI,也称为连接字符串,它告诉Kotlin驱动程序要连接到哪个MongoDB 部署。

  • 一个MongoClient对象,用于创建与 MongoDB 部署的连接并允许您对其执行操作。

您还可以使用这些组件来自定义Kotlin驱动程序在连接到MongoDB时的行为方式。

本指南向您介绍如何创建连接string并使用 MongoClient 对象连接到MongoDB 。

连接 URI提供驱动程序用于连接到 MongoDB 部署的指令集。该指令集指示驱动程序应如何连接到 MongoDB,以及在连接时应如何运行。下图解释了示例连接 URI 的各个部分:

连接字符串部件图

This figure uses the Standard Connection String Format, mongodb for the protocol. You can also use the DNS Seed List Connection Format, mongodb+srv, if you want more flexibility of deployment and the ability to change the servers in rotation without reconfiguring clients.

注意

If your deployment is on MongoDB Atlas, see the Atlas driver connection guide and select Kotlin from the language dropdown to retrieve your connection string.

如果您使用基于密码的身份验证机制,则连接 URI 的下一部分将包含您的凭证。 将user的值替换为数据库用户名,并将pass的值替换为数据库用户的密码。 如果您的身份验证机制不需要凭证,请忽略连接 URI 的这一部分。

连接 URI 的下一部分指定主机名或 IP 地址,后跟 MongoDB 实例的端口。在示例中,sample.host 代表主机名,27017 是端口号。替换这些值以参考您的 MongoDB 实例。

连接 URI 的最后一部分包含作为参数的连接选项。在示例中,我们设立了两个连接选项:maxPoolSize=20w=majority。有关连接选项的更多信息,请参阅 连接选项指南。

您可以使用 MongoClient 类连接到MongoDB并与之通信。

使用 MongoClient.create() 方法构造 MongoClient

以下代码展示了如何创建连接到本地MongoDB 部署的MongoClient

import com.mongodb.kotlin.client.coroutine.MongoClient
val uri = "mongodb://localhost:27017/"
val client = MongoClient.create(uri)

重要

客户端重用

由于每个 MongoClient 代表一个具有线程安全性的数据库连接池,因此大多数应用程序只需要一个 MongoClient实例,甚至跨多个线程也是如此。所有资源使用限制(例如最大连接数)应用于单个 MongoClient 实例。

要学习;了解可用于控制 MongoClient 行为的不同设置,请参阅 MongoClient 设置指南

提示

当不再需要实例时,始终调用 MongoClient.close() 清理资源。

有关本节中提到的方法和类的详情,请参阅以下 API 文档:

给本页内容打分