Skip to content

Commit 6a21bd9

Browse files
authored
add maximum lifetime of connections (pingcap#21368) (pingcap#21369)
1 parent 848b7a1 commit 6a21bd9

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

develop/dev-guide-connection-parameters.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,38 @@ Java 的连接池实现很多 ([HikariCP](https://github.com/brettwooldridge/Hik
3232

3333
应用在使用连接池时,需要注意连接使用完成后归还连接,推荐应用使用对应的连接池相关监控(如 **metricRegistry**),通过监控能及时定位连接池问题。
3434

35+
### 配置连接的生命周期
36+
37+
TiDB Server 在关闭、因维护而重启,或发生异常(如硬件故障或网络问题)时,现有的客户端连接可能会被重置,导致应用程序出现中断或异常。为避免此类问题,对于长期保持的数据库连接,建议每天至少主动关闭并重新建立一次连接。
38+
39+
常见的连接池库通常提供参数,用于控制连接的最长存活时间。
40+
41+
<SimpleTab>
42+
<div label="HikariCP">
43+
44+
- **`maxLifetime`**:连接在连接池中的最长存活时间。
45+
46+
</div>
47+
48+
<div label="tomcat-jdbc">
49+
50+
- **`maxAge`**:连接在连接池中的最长存活时间。
51+
52+
</div>
53+
54+
<div label="c3p0">
55+
56+
- **`maxConnectionAge`**:连接在连接池中的最长存活时间。
57+
58+
</div>
59+
60+
<div label="dbcp">
61+
62+
- **`maxConnLifetimeMillis`**:连接在连接池中的最长存活时间(单位为毫秒)。
63+
64+
</div>
65+
</SimpleTab>
66+
3567
### 探活配置
3668

3769
连接池维护客户端到 TiDB 的长连接的方式如下:

0 commit comments

Comments
 (0)