连接池

Overview

在本指南中，您可以学习；了解.NET/ C#驱动程序如何使用连接池来管理与MongoDB 部署的连接，以及如何在应用程序中配置连接池设置。

连接池是由.NET/ C#驱动程序维护的打开数据库连接的缓存。当应用程序请求连接到MongoDB时， .NET/ C#驱动程序会无缝地从池中获取连接，执行操作，然后将连接返回到池中以供重用。

连接池有助于减少应用程序延迟和.NET/ C#驱动程序创建新连接的次数。下图概括地说明了 MongoClient 如何管理连接池：

配置连接池

您可以在 MongoClient对象或连接 URI 中指定以下连接池设置：

设置	说明
`ConnectTimeout`	建立新连接时.NET/ C#驱动程序在超时之前等待的最长时间。数据类型： `TimeSpan` 默认值：30 秒连接 URI 示例：`connectTimeoutMS=0`
`MaxConnecting`	每个池可以同时建立的最大连接数。如果达到此限制，则进一步的请求将等待，直到建立连接或将另一个正在使用的连接检回池中。数据类型： `integer` 默认值：`2` 连接 URI 示例：`maxConnecting=3`
`MaxConnectionIdleTime`	连接在池中保持空闲状态的最长时间。当连接超过此限制时， .NET/ C#驱动程序将关闭该连接并将其从池中删除。数据类型： `TimeSpan` 默认值：10 分钟连接 URI 示例：`maxIdleTimeMS=60000`
`MaxConnectionLifeTime`	连接可以池化的最长时间。当连接超过此限制时， .NET/ C#驱动程序将关闭该连接并将其从池中删除。数据类型： `TimeSpan` 默认值：30 分钟连接 URI 示例：`maxLifeTimeMS=50000`
`MaxConnectionPoolSize`	池维护的最大并发连接数。如果达到最大池大小，则后续请求将等待，直到连接可用。数据类型： `integer` 默认值：`100` 连接 URI 示例：`maxPoolSize=150`
`MinConnectionPoolSize`	池维护的最小并发连接数。如果由于网络错误导致打开的连接数低于此值， .NET/ C#驱动程序会尝试创建新连接以维持此最小值。数据类型： `integer` 默认值：`0` 连接 URI 示例：`minPoolSize=3`
`SocketTimeout`	.NET/ C#驱动程序在超时之前等待服务器响应的时间长度。数据类型：默认值：操作系统默认连接`TimeSpan` URI 示例：`socketTimeoutMS=100000`
`WaitQueueTimeout`	线程在超时之前等待连接在连接池变为可用状态的时间。数据类型：`TimeSpan` 默认值：2 分钟连接 URI 示例：`waitQueueTimeoutMS=100000`

以下代码使用 MaxConnectionPoolSize 参数创建最大连接池大小为 50 的客户端：

var settings = MongoClientSettings.FromConnectionString("<connection URI>");
settings.MaxConnectionPoolSize = 50;
var client = new MongoClient(settings);

以下代码创建一个配置与前面的示例相同的客户端，但使用了连接 URI：

var settings = MongoClientSettings.FromConnectionString("<hostname>?maxPoolSize=50");
var client = new MongoClient(settings);

连接池

Overview

配置连接池

更多信息

API 文档