连接池

您可以使用连接池扩展 Timescale 连接并提高数据库性能。Timescale 使用 pgBouncer 进行连接池。

如果您的数据库需要大量的短生命周期连接，连接池是一个提高性能的好方法。例如，Web、无服务器和 IoT 应用程序通常使用基于事件的架构，其中数据在很短的时间内从数据库中读取或写入。

您的应用程序会快速打开和关闭连接，而池则维护一组与数据库的长期运行连接。这会提高性能，因为池会提前打开连接，允许应用程序打开许多短生命周期的连接，而数据库只打开少数长期运行的连接。

用户身份验证

默认情况下，池具有对数据库的身份验证，因此您可以使用已经设置的任何自定义用户，无需进一步配置。如果这是您首选的方法，您可以继续使用 tsdbadmin 用户。但是，对于某些情况，您可能需要添加自定义配置，例如池用户statement_timeout。

创建具有自定义设置的新用户

以 tsdbadmin 用户身份登录到您的数据库，并创建一个名为 <MY_APP> 的新角色，密码为 <PASSWORD>
```
CREATE ROLE <MY_APP> LOGIN PASSWORD '<PASSWORD>';
```
将此用户的 statement_timeout 设置更改为 2 秒
```
ALTER ROLE my_app SET statement_timeout TO '2s';
```

在新终端窗口中，使用新用户 <MY_APP> 连接到池


❯ PGPASSWORD=<NEW_PASSWORD> psql 'postgres://[email protected]:30477/tsdb?sslmode=require'

输出类似于以下内容


psql (15.3 (Homebrew), server 15.4 (Ubuntu 15.4-1.pgdg22.04+1))
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.

以 <MY_APP> 用户身份登录，检查设置是否正确


SELECT current_user;

┌──────────────┐
│ current_user │
├──────────────┤
│ my_app       │
└──────────────┘
(1 row)

检查 <MY_APP> 用户的 statement_timeout 设置是否正确


tsdb=> show statement_timeout;
┌───────────────────┐
│ statement_timeout │
├───────────────────┤
│ 2s                │
└───────────────────┘
(1 row)

池类型

创建连接池时，可以选择两种池类型：会话或事务。每种池类型使用不同的模式来处理连接。

会话池会分配一个来自池的连接，直到它们被应用程序关闭，类似于常规的 PostgreSQL 连接。当应用程序关闭连接时，它会返回到池中。

事务池连接仅在事务持续时间内分配，并在事务结束时将连接释放回池。如果您的应用程序频繁打开和关闭连接，请选择事务池类型。

默认情况下，池同时支持两种模式。但是，您用于连接应用程序的连接字符串不同，具体取决于您想要使用会话池类型还是事务池类型。在 Timescale 控制台中创建连接池时，会为您选择的模式提供正确的连接字符串。

例如，连接到您数据库的连接字符串看起来像这样

postgres://<USERNAME>:<PASSWORD>@service.example.cloud.timescale.com:30133/tsdb?sslmode=require

会话池连接字符串相同，但使用不同的端口号，如下所示

postgres://<USERNAME>:<PASSWORD>@service.example.cloud.timescale.com:29303/tsdb?sslmode=require

事务池连接字符串使用与会话池连接相同的端口号，但使用不同的数据库名称，如下所示

postgres://<USERNAME>:<PASSWORD>@service.example.cloud.timescale.com:29303/tsdb_transaction?sslmode=require

请务必检查 Timescale 控制台输出，以获取在您的应用程序中使用的正确连接字符串。

连接池大小

连接池管理与数据库本身和客户端应用程序的连接。它会保持与数据库的固定数量的连接处于打开状态，同时允许客户端打开和关闭连接。客户端可以从会话池或事务池请求连接。然后，连接池将在有空闲连接时分配连接。

允许每个池建立的客户端连接数量与为数据库设置的 max_connections 参数成正比。会话池最多可以有 max_connections - 17 个客户端连接，而事务池最多可以有 (max_connections - 17) * 20 个客户端连接。

在 17 个未分配给任何池的保留连接中，默认情况下 12 个保留用于超级用户，另外 5 个保留用于 Timescale 操作。

例如，如果 max_connections 设置为 500，会话池的客户端连接数最大为 483 (500 - 17)，事务池的客户端连接数最大为 9,660 (483 * 20)。max_connections 的默认值会根据您服务的计算大小而有所不同。

添加连接池

创建新服务时，您也可以创建连接池。或者，您可以在 Timescale 门户中将连接池添加到现有服务中。

添加连接池

登录 Timescale 门户，然后单击要添加连接池的服务。
在 连接信息 部分中，导航到 连接池 选项卡，然后单击 添加连接池。
添加池后，您的池连接详细信息将显示在 连接池 选项卡中。使用此信息连接到您的池。
默认情况下，会显示会话池的连接字符串。您可以从下拉菜单中选择事务池，以查看事务池的详细信息。有关不同池类型的更多信息，请参阅池类型部分。

删除连接池

如果不再需要连接池，可以在 Timescale 门户中将其删除。删除连接池后，请确保更新您的应用程序以调整它用于连接到服务的端口。

删除连接池

登录 Timescale 门户，然后单击要删除连接池的服务。
在 连接信息 部分中，导航到 连接池 选项卡，然后单击 删除连接池。
确认您要删除连接池。
注意
删除池后，如果将来将其添加回来，它将使用之前使用的相同连接字符串和端口。

pgBouncer 统计命令

连接到您的数据库。
切换到 pgbouncer 数据库：\c pgbouncer
运行 pgBouncer cli 的任何只读命令（例如：SHOW STATS;）。
有关所有选项，请参阅 pgBouncer 此处文档。

VPC 和连接池

VPC 支持连接池。添加池或连接到 VPC 的顺序无关紧要。您的连接字符串将自动更新以使用 VPC 连接字符串。

注意

相关内容