GaussDB(DWS)集群通信：详解pooler连接池

本文分享自华为云社区《GaussDB(DWS) 集群通信系列一：pooler连接池》，作者：半岛里有个小铁盒。

1.前言

适用版本：【8.1.0(及以上)】

GaussDB(DWS) 为MPP型分布式数据库，使用Share Nothing架构，数据分散存储在各个DN节点，而CN不存储数据，作为接收查询的入口，生成的计划会尽量下推到DN并行执行以提升性能，此过程中会产生大量的建连操作，使得通信开销变得很大。因此在大数据时代，集群规模越来越大，业务并发越来越高，数据库集群各节点间的通信压力也越来越大。GaussDB(DWS)集群通信技术，在大规模集群中可以承载高并发业务，能够实现高性能分布式通信系统。

2.背景

GaussDB(DWS) 中客户端执行查询流程如上图所示，其中具体的如下：

客户端向CN的监听端口发起连接；
CN postmaster主线程accept连接，创建 postgres线程并将连接交给此线程处理；
客户端下发query到CN；
CN的postgres线程将查询计划下发给其他 CN/DN，查询结果沿原路径返回到客户端；
客户端查询结束，关闭连接；
CN上对应的postgres线程销毁退出；

CN与DN建连立流程，和客户端与CN建连立流程基本相同。因此为了减少CN与DN建立连接，以及DN进程中postgres线程创建、销毁的开销，CN端实现了Pooler连接池。

3.Pooler连接池

如上图所示，CN的pooler连接池中会保存与其他CN/DN的连接，每一个连接在对端会对应一个postgres工作线程。

postgres工作线程是带状态属性的，如database，所以可以认为pooler连接池中的连接也是带属性的。不同属性间的连接是不能复用的，如上图所示，按不同属性切分为pool A/B/C等连接池。每个连接池中会存有连接往不同节点的空闲连接的数组，提供接口给外部使用或放入连接。

CN上的postgres工作线程在需要连接其他节点时，会创建一个本地agent，尝试从pooler连接池取跟本线程相同属性的空闲连接，pooler如果没有空闲连接，就会新建一个连接。连接交给agent后，可以视为线程私有。在线程退出时，agent才会将连接还给pooler。

接下来，我们从数据结构上来看看Pooler连接池实现原理：

空闲连接池

DatabasePool

/* All pools for specified database */

typedef struct databasepool

{

    char    *database;

    char    *user_name;

    char    *pgoptions; /* Connection options */

    HTAB    *nodePools; /* Hashtable of PGXCNodePool, one entry for each node */

    MemoryContext mcxt;

    struct databasepool *next; /* Reference to next to organize linked list */

} DatabasePool;

DatabasePool *databasePools = NULL;

进程级别数据结构

DatabasePool用于存储空闲连接，根据database，user_name，pgoptions三者来确定
如果通过三者查找到了，那么就取其中对应的nodePools，找不到则新加

nodePools中对应的数据结构为PGXCNodePool，用于存储本节点与其他每个cn/dn的连接，具体的保存如下

cn1[0,1,2,3,4,…]

dn1[0,1,2,3,4,…]

NodePool

typedef struct NodePool

{

    Oid nodeoid; /* Hash key (must be first!) */

    bool valid;

    ArrayLockFreeQueue pool;

} PGXCNodePool;

进程级别数据结构

连接到某一节点的空闲连接的集合，通过无锁队列（数组）实现
从这里拿到对应的连接，直接复用

正在使用连接池

AgentPool

typedef struct

{

    ArrayLockFreeQueue pool;

    AgentSlot* slots;

}AgentPool;

进程级别的数据结构

存放一个进程中的所有的连接

其中slots为一个数组，表明一个槽位，与pool为一一对应的状态
用于保存所有线程持有的连接，即poolAgent数据结构

AgentSlot

typedef struct

{

    int index;

    volatile AgentStatus status;

    PoolAgent* agent;

}AgentSlot;

进程级别数据结构

存放进程中的某一个连接

index与AgentPool->pool相关联

status状态为，标识该连接是否正在使用/空闲/持有

agent中为某个线程的信息（也就是每个session），都是在全局数组poolAgents中保存的

PoolAgent

typedef struct

{

    /* Agent members */

    ThreadId        pid;

    DatabasePool*   pool;

    int             index;

    /* param members */

    char*           user_name;

    char*           pgoptions;

    char*           paramsStr;

    char*           localParams;   /* params temporarily saved before commit */

    char*           tempNamespace; /* temp namespace name of session */

    List*           paramsList;    /* save session params, for build paramsStr */

    int             paramsReady;    /* param is set, need rebuild paramsStr */

    /* Connection members */

    int             dnNum;

    int             cnNum;

    PoolSlot**      dnConn;

    PoolSlot**      cnConn;

    NodeConnDef*    cnDef;

    NodeConnDef*    dnDef;

    /* handles members */

    NodeHandle** dnHandles;

    NodeHandle** cnHandles;

    int dnUsed;

    int cnUsed;

} PoolAgent;

对于每起一个线程session（即连接），都会有一个PoolAgent与之对应，即从DatabasePool->NodePool->pool取出来的连接

cnDef、dnDef：初始化时从pgxc_node中拿到，即cn定义、端口、ip
(session级别)dnConn、cnConn：从databasePools->nodePools-> pool拿真正对应的连接
(query级别)dnHandles、cnHandles：从dnConn、cnConn里边dop出来使用，确保两者是一一对应的状态，当query结束时，只需要close handles就行，cnConn不需要close

Pooler连接池具体的复用流程如下：

session需要连接时，通过DB+USER为key找到正确的pooler连接池，优先从中取走现有连接，如果连接池中没有连接的话，则新建连接；
query结束后，CN的postgres线程并不会归还连接，连接可以用于当前session的下一个查询；
session结束后，CN的postgres线程会将连接还到对应的pooler，连接对应的DN上的postgres线程并不会退出，处于ReadCommand中，等待复用后CN新的postgres线程发起任务；

4.Pooler连接池相关的视图

pg_pooler_status视图

pg_pooler_status视图记录了pooler连接池中的所有连接信息，每一行表示本CN发起的一个连接，对应对端进程的一个postgres线程

postgres=# select * from pg_pooler_status;

 database | user_name | tid |  node_oid  |  node_name   | in_use | node_port | fdsock |   remote_pid    | session_params

----------+-----------+-----+------------+--------------+--------+-----------+--------+-----------------+----------------

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |     94 | 140259241618584 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |    101 | 140259241619432 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |     91 | 140259241618160 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |     95 | 140259241619008 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |     59 | 140259241562192 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |    106 | 140259241619856 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |    108 | 140259241620280 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |    117 | 140259241621128 | none

 postgres |   user1   |     | 2147483650 | datanode1    | f      |     37110 |    114 | 140259241620704 | none

in_use为‘t’表示这个连接正在某线程使用，为‘f’表示空闲连接等待复用
tid列为本CN的持有此连接的线程号
node_name列为对端进程号，remote_pid列为对端线线程号
在query_id为0或CN/DN不一致时，通过pooler视图查找CN与DN连接关系

一般pooler连接池中的连接会非常多，可以按不同字段group by查看某个db pool池中的连接情况，或连往某个node的连接情况，如：

select database,user_name,node_name,in_use,count(*) from pg_pooler_status group by 1, 2, 3 ,4 order by 5 desc limit 50;

5.Pooler连接清理

清理Session持有的连接

cache_connection，是否使用pooler连接池缓存连接，默认开
session_timeout，客户端连接空闲超时后报错退出归还连接
enable_force_reuse_connections，事务结束后强制归还连接
conn_recycle_timeout（8.2.1），CN空闲session超时后归还连接

Pooler空闲连接池中的连接

pg_clean_free_conn视图/函数，清理1/4的空闲连接池连接，CM定期调用
CLEAN CONNECTION语法，清理对应DB或user的所有空闲连接 clean connection to all for database postgres to USER user1;

6.总结

本文详细介绍了Libcomm通信库及其原理，让我们更好的理解GaussDB(DWS)集群通信中的具体逻辑，对于GaussDB通信运维也具备一定的参考意义。

点击关注，第一时间了解华为云新鲜技术~