转载

 

pgbouncer 安装与管理配置参数介绍

 安装:
tar -xzvf  pgbouncer-1.5.2.tar.gz
cd pgbouncer-1.5.2
./configure --prefix=/usr/local --with-libevent=libevent-prefix
make
make install
做make install 的时候可以知道他的东西都安装到那些目录下
[root@test740_5 pgbouncer-1.5.2]# make install
     -->      doc
     INSTALL  pgbouncer.1 /usr/local/share/man/man1    ##man帮助手册
     INSTALL  pgbouncer.5 /usr/local/share/man/man5    ##
     <--      doc
     INSTALL  pgbouncer /usr/local/bin       ##启动程序存放的路径
     INSTALL  README /usr/local/share/doc/pgbouncer ##share 目录下存放了 配置文件 pgbouncer.ini 以及用户登录列表,只有该列表中存在的用户才能连接数据库
     INSTALL  NEWS /usr/local/share/doc/pgbouncer
     INSTALL  etc/pgbouncer.ini /usr/local/share/doc/pgbouncer  ## 配置文件
     INSTALL  etc/userlist.txt /usr/local/share/doc/pgbouncer    ##用户列表
启动命令
pgbouncer [-d][-R][-v][-u user] <pgbouncer.ini>
-d 后台运行
-R 在线重启
-v 增加冗余信息,会消耗比较多的时间
-u 切换到指定的用户启动
-q 静默方式,不记录到stdout。请注意这并不影响记录详细,只是stdout是不被使用。在init.d脚本使用
-V 展示版本
-h 展示帮助命令
pgbouncer -V|-h
pgbouncer -d pgbouncer.ini -v ##加-v 可以打印出很多检查信息,对初使用者,是个不错的选择
关闭命令
用管理员用户登录pgbouncer 数据库 ,这个是一个虚拟库,然后执行shutdown 命令
psql -h 127.0.0.1 -p 6432 -u pgbouncer pgbouncer (-u 后面接管理员用户)
详细设置看 pgbouncer.ini 里面设置
pgbouncer 的三种连接方式:
session pooling:  默认方式。连接保持至客户端断开链接后,服务器会将连接放回连接池
transaction pooling:这种连接保持只有在事务的发起跟结束之间
statement pooling:最积极的方式,当一个查询结束后连接将会被回收放回连接池
管理命令:
首先是登录了pgbouncer 的数据库,其次具有执行这些命令的权限
show stats;   #查看连接池的状态信息
     database :数据库名称
     total_requests: pgbouncer汇聚SQL请求的总数
     total_received: pgbouncer 接收网络请求总字节数
     total_sent: pgbouncer 发送到网络的总字节数
     total_query_time:pgbouncer 连接到PG数据库所使用的总时间数,单位微秒
     avg_req:上一个时刻,每秒请求平均数
     avg_recv:平均每秒钟在客户端那接收到的字节数
     avg_sent:平均每秒发送到客户端的字节数
     avg_query:每微秒平均查询数
show servers;
     type: S 表示服务器
     user: pgbouncer 连接数据库服务器的用户名
     database: 所连接的数据库名
     state: pgbouncer 连接服务器的连接状态 (active ,used , idle )
     addr:postgresql 服务器的地址
     port : postgresql监听的端口
     local_addr :当前pgboucer 所在服务器的ip
     local_port :连接在本地机器开启的端口
     connect_time : 连接创建的时间
     request_time: 最后一个请求发出的时间
     ptr: 本连接的一个内部对象地址,作为唯一的ID标示
     link:客户端连接服务器的配对地址
show clients; 客户端连接pgbouncer 的状态信息
     type :C ,表示客户端
show pools; 查看连接池中连接的状态信息
show lists ;
show users;
show databases;
show fds;
show config;查看所有的配置信息
show dns_hosts;
show dns_zones;
---进程控制命令
PAUSE[db];:这个命令尝试终止所有的到服务器端连接,首先会等待所有的查询都完成后,这个命令只有等到所有的查询都结束时才会返回,用于数据库重启。如果有指定[db] 则是
终止指定的数据库
KILL db; 马上终止指定数据库的客户端跟服务器端的连接。
suspend;刷新所有的套接字缓冲区,pgbouncer 将停止对其的监听,这个命令只有将所有的缓冲区都清空后才会返回。用于pgbouncer 在线重启
resume [db];这个命令配合 pause 跟 suspend 使用的,解除pgbouncer 的终止状态
shutdown; 关闭pgbouncer
reload;重载配置文件,并更新所有的已更改的设置
----配置文件详解 pgbouncer.ini
配置文件主要分2部分
一部分是 数据库的相关设置,一部分是 pgbouncer 的相关设置
[databases]
...
[pgbouncer]
....
数据库方面的设置:
数据库连接字符串:database name = connect string
                                连接字符串参数有: dbname=  要连接的数据库名,默认跟 客户端相同的名字 。(这种指定的的数据库名为真实的数据库名 前面的 database name 应该与其
一致,试过 bazdb = host=127.0.0.1 port=5432 dbname=sheen,结果在pgadmin 端进行连接时,可以连接到pgbouncer,也能看到 连接的服务器端数据库集群中所有的数据库
,但是却不能连接,会报找不到指定数据库,连 数据库名是 sheen 的也不能连接,改为 sheen = ... dbname=sheen  才可连接到 sheen 这个数据库上)
                                                                 host= 要连接的数据库的主机IP
                                                                 port= 要连接的数据库的监听端口(默认5432)
                                                                 user= 如果指定了用户名,所有的连接到该设置的数据库连接都会以指定的用户名进行连接,那么也意味着所有的连接在连接该数据库时都
只能共用一个连接池,如果没有设置,那么pgbouncer 在连接该数据库时,将会使用客户端的用户名。这种情况下是一个用户独自使用一个连接池
                                                                 password= 指定用户登录数据库的密码
                                                                 client_encoding=指定客户端的编码格式
                                                                 datestyle= 指定日期格式
                                                                 timezone=指定时区
                                                                 pool_size= 这个数据库连接每个连接池最大的连接数
                                                                 connect_query=建立连接后执行的sql 查询,如果查询失败将会被记录在日志中,没有设置将会被忽略
一个简易的连接设置例子
sheen = host=127.0.0.1 port=5432 dbname=sheen
pgbouncer 的相关设置:
logfile=/dir/of/logfile/pgbouncer.log 日志文件的存放位置
pidfile=/dir/of/pidfile/pgbouncer.pid pid 文件的存放目录
listen_addr = 指定监听的IP 如不做对指定客户端监听 使用 * 监听所有
listen_port = pgbouncer 的监听端口
使用unix 套接字的话,使用如下参数设置
unix_socket_dir=
unix_socket_mode=
unix_socket_group=
授权设置
auth_type = trunst 授权方式 (any ,trust , plain , crypt , md5)
auth_file = /etc/pgbouncer/userlist.txt 授权文件,到指定的文件中读取用户及密码,也只有文件中存在的用户才能登录
                   userlist.txt 的格式: "username" "password"
允许登录pgbouncer 的用户
admin_users= 管理用户名,随便设置一个名字,用于登录pgbouncer 数据库用,这里设置的用户具有更改设置的权限
stats_users = 只允许使用show 命令的用户名    
连接池设置
pool_mode = (session ,transaction , statement 上面已经有说过3种连接方式)
server_reset_query = DISCARD ALL   pg 8.3 后使用该参数,清空server_reset_query。当上一个查询连接释放后,确保可以给下一个客户端使用前连接中没有任何事物,也不能包
含 ABORT 或者ROLLBACK
max_client_conn = 允许客户端的最大链接数
                                如果连接串中没有指定用户名的 max_client_conn + (max_pool_size * total_databases * total_users)
                                如果连接串中指定了用户名的 max_client_conn + (max_pool_size * total_databases)
default_pool_size 链接池的大小(per user/database)
reserve_pool_size 当发生问题时,额外的链接数
reserve_pool_timeout 额外链接超时
log_pooler_errors 记录从连接池发送到客户端的错误信息
超时设置
server_lifetime 默认值 1200 秒  连接到服务器端超过这个时间自动关闭连接
server_idle_timeout = 60 空闲连接超过60秒关闭连接
server_connect_timeout = 15 连接超时,链接服务器超15秒没响应取消
server_login_retry = 15 登录服务器失败后重连的时间间隔 默认15秒
client_login_timeout=60
autodb_idle_timeout = 3600
危险的超时设置
query_timeout 默认0 关闭,当查询超过设置的时间关闭
query_wait_timeout默认0 关闭,当查询等待服务器端响应超过设置时间关闭
client_idle_timeout默认0 关闭,当客户端在设置实际内没有活动,连接关闭
底层参数调节
pkt_buf = 2048 流包缓冲区大小
listen_backlog =128 确定队列中保存多少新的未答复的连接尝试。当队列已满,进一步新的连接将被丢弃
网络层参数调节 tcp
tcp_defer_accept (linux 默认45 其他OS 为0)
tcp_socket_buffer (linux 默认4096)
tcp_keepalive (0/1)
   下面的参数只有在linux 中可以设置,同样需要设置tcp_keepalive =1
tcp_keepcnt=
tcp_keepidle=
tcp_keepintvl=
dns_max_ttl
dns_zone_check_period=
---简易版的pgbouncer 连接配置
[databases]
sheen = host=127.0.0.1 port=5432 dbname=sheen
[pgbouncer]
logfile=/dir/of/logfile/pgbouncer.log
pidfile=/dir/of/pidfile/pgbouncer.pid
listen_addr =*
listen_port =6432
auth_type = trunst
auth_file = /etc/pgbouncer/userlist.txt
adminuser=pgbouncer
配置pgbouncer.ini 的时候,在原来自带的那份 pgbouncer.ini 上面进行修改就好了,要启用哪个参数 前面的;去掉,设上相应的值即可

 

One Response


    还没有评论!
1  

Leave your comment

请留下您的姓名(*)

请输入正确的邮箱地址(*)

请输入你的评论(*)


感谢开源 © 2016. All rights reserved.&3Q Open Source&^_^赣ICP备15012863^_^
乐于分享共同进步 KreativeThemes