codestation/pgbouncer

PgBouncer Docker镜像

概述

此镜像基于PgBouncer构建，并应用了https://github.com/pgbouncer/pgbouncer/pull/315%E8%A1%A5%E4%B8%81%EF%BC%8C%E7%94%A8%E4%BA%8EPostgreSQL%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E6%B1%A0%E7%AE%A1%E7%90%86%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%89%E5%85%A8%E9%85%8D%E7%BD%AE%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%80%832ndquadrant%E5%8D%9A%E5%AE%A2%E6%96%87%E7%AB%A0%E3%80%82

核心功能与特性

• 提供PostgreSQL数据库连接池管理功能，优化连接资源利用
• 应用pgbouncer/pull/315补丁，增强功能或修复相关问题
• 通过数据库中的认证函数实现安全的用户认证机制

使用场景与适用范围

适用于需要管理PostgreSQL数据库连接的各类应用环境，尤其适合高并发访问场景，可有效减少数据库连接开销，提升访问效率，并增强连接安全性。

使用方法与配置说明

数据库准备

在使用此镜像前，需在目标PostgreSQL数据库中执行以下SQL命令，创建必要的用户、模式及认证函数：

1. 创建pgbouncer用户：

sql
CREATE USER pgbouncer WITH PASSWORD 'changeme';

2. 创建pgbouncer模式并授权：

sql
CREATE SCHEMA pgbouncer AUTHORIZATION pgbouncer;

3. 创建get_auth认证函数：

sql
CREATE OR REPLACE FUNCTION pgbouncer.get_auth(p_usename TEXT)
RETURNS TABLE(username TEXT, password TEXT) AS
$
BEGIN
    RAISE WARNING 'PgBouncer auth request: %', p_usename;
 
    RETURN QUERY
    SELECT usename::TEXT, passwd::TEXT FROM pg_catalog.pg_shadow
     WHERE usename = p_usename;
END;
$ LANGUAGE plpgsql SECURITY DEFINER;

4. 设置函数权限：

sql
REVOKE ALL ON FUNCTION pgbouncer.get_auth(p_usename TEXT) FROM PUBLIC;
GRANT EXECUTE ON FUNCTION pgbouncer.get_auth(p_usename TEXT) TO pgbouncer;

确认以上步骤完成后，即可部署并使用PgBouncer Docker镜像。