1.  
  2.  
  3. https://pgbouncer.github.io/config.html
  4.  
  5. 参考 《PostgreSQL修炼之道》之pgbouncer
  6.  
  7. 配置文件分为[databases] 和 [pgbouncer]两部分，这个前面说过。现在我们来详细讲解一下里面的配置。
  8.  
  9. 在上面的部分我们已经看到了一部分的[databases]部分的参数配置，都是以键值对的形式出现的，例如dbname、host、port、user、password，这几个参数都比较好理解。还有几个额外的配置我们接着看一下：
  10.  
  11. （1） pool_size 用来配置连接池的大小。连接池的含义上面说过，如果没有这个值则使用[pgbouncer]部分的default_pool_size的值。
  12.  
  13. （2）connect_query ：后面跟一个SQL语句字符串，用于探测这个连接是否正常，如果执行SQL语句出错，则换一个连接。
  14.  
  15. （3）client_encoding：指定连接的客户端使用的字符集编码
  16.  
  17. （4）datestyle：指定日期类型
  18.  
  19. （5）timezone：指定时区。
  20.  
  21. [pgbouncer]部分的配置
  22.  
  23. 这个部分的配置项比较多，主要分为下面几类：
  24.  
  25.  
  26.  
  27. 通用配置项
  28.  
  29. 日志配置项
  30.  
  31. 控制界面访问控制配置项
  32.  
  33. 连接健康检查和超时配置项
  34.  
  35. 危险的超时配置项
  36.  
  37. 底层网络配置项
  38.  
  39.  
  40.  
  41. 通用配置
  42.  
  43.  
  44.  
  45. logfile 指定日志文件，默认值是/var/log/pgbouncer/pgbouncer.log
  46.  
  47. pidfile 指定pid文件位置，默认值是/var/run/pgbouncer/pgbouncer.pid
  48.  
  49. listen_addr  监听的地址，默认值是127.0.0.1，可以使用*号表示监听所有IP地址。
  50.  
  51. listen_port 监听的端口，默认值是6432
  52.  
  53. unix_socket_dir 指定unix socket文件的目录，默认为/tmp目录
  54.  
  55. unix_socket_mode 指定unix socket文件的权限，默认值为0777
  56.  
  57. unix_socket_group 指定unix socket文件的组，默认无
  58.  
  59. user  指定启动PgBouncer的用户名，windows系统不支持此设置
  60.  
  61. auth_type 认证的类型，默认是trust，其他值包括md5，crypt，plain，any，hba。用的较多的是md5
  62.  
  63. auth_file 认证文件的位置，默认值是/etc/pgbouncer/userlist.txt
  64.  
  65. pool_mode 指定池的模式，默认是session模式，还可以是transaction和statement
  66.  
  67. max_client_conn  允许的最大连接数
  68.  
  69. default_pool_size  默认的池大小，默认值20
  70.  
  71. min_pool_size  最小的池大小，每个连接池至少会向后端数据库保持多少个连接
  72.  
  73. reserve_pool_size  连接池的保留连接数
  74.  
  75. reserve_pool_timeout  保留连接的超时时间
  76.  
  77. server_round_robin  负载均衡的方式是否设置为“round robin”，默认为关闭，即后进先出
  78.  
  79. ignore_startup_parameters 默认情况PgBouncer只会跟踪一些默认参数，并且能检测这些参数的变化，保持这些参数和客户端的一致。在这个配置后面跟的配置后被PgBouncer忽略，不会被检查。
  80.  
  81. disable_pqexec  是否禁止简单查询协议，默认值为0。简单查询协议允许一个请求发送多个SQL，容易导致SQL注入攻击。
  82.  
  83. max_db_connections 此数据库允许的最大连接数，全局或每个数据库
  84.  
  85.  
  86.  
  87. 日志配置项：
  88.  
  89.  
  90.  
  91. syslog  是否打开syslog，windows下打开eventlog，默认值为0，表示不打开。
  92.  
  93. syslog_ident  默认为PgBouncer
  94.  
  95. syslog_facility
  96.  
  97. log_connections  是否记录连接成功的日志，默认值为1，表示记录
  98.  
  99. log_disconnections 是否记录断开连接的日志，默认值为1，表示记录
  100.  
  101. log_pooler_errors 连接池法网客户端的错误是否记录在日志中，默认值为1，表示记录
  102.  
  103. stats_period 把汇总的统计信息写入日志的时间周期，默认是60s
  104.  
  105.  
  106.  
  107. 控制界面访问控制配置项：
  108.  
  109.  
  110.  
  111. admin_users  管理用户名，默认值是postgres
  112.  
  113. stats_users  允许连接到控制界面，查看连接池只读信息的用户列表。可以执行除“SHOW FDS”以外的其他“SHOW”命令
  114.  
  115. server_reset_query
  116.  
  117. server_check_delay 空闲的连接多长时间进行一次健康检测，判断连接是否可用。如果设置为0，则立即检测，默认值为30s
  118.  
  119. server_check_query，进行健康检查的SQL语句，如果为0，表示不检测，默认值为“select 1;”
  120.  
  121. server_lifetime  连接的存活时间，连接超过这个时间就会被关闭，默认为3600，设置为0表示只使用一次。
  122.  
  123. server_idle_timeout  连接的idle时间，超过此时间，连接会被关闭。默认为600
  124.  
  125. server_connect_timeout  后端数据库的login时间超过这个值就会被关闭。默认为15s
  126.  
  127. server_login_retry  传教到后端数据库的连接失败后，等多长时间后重试，默认为15s
  128.  
  129. client_login_timeout  客户端与PgBouncer建立连接后，如果无法在这段时间内完成登录，那么连接会断开，默认为60s
  130.  
  131.  
  132.  
  133. 危险超时配置项
  134.  
  135. 指的是为防止一些未知错误或者原因导致系统卡住的针对性配置。
  136.  
  137.  
  138.  
  139. query_timeout  允许超过该时间值的SQL会被断开，应该比SQL实际的执行时间稍长，也需要比数据库的statement_timeout参数值更大。为了应付一些未知的网络问题。默认为0.0，禁止使用
  140.  
  141. query_wait_timeout  请求在队列中等待被执行的最长时间，如果超过该时间还没有分配到连接，就会断开。默认为0，禁止使用。
  142.  
  143. client_idle_timeout  客户端连接空闲超过该时间，则断开连接。默认值为0，禁止使用
  144.  
  145. idle_transaction_timeout 客户端启动事务后，超过这个时间没有结束事务，则关闭这个客户端连接。默认值为0，禁止使用
  146.  
  147.  
  148.  
  149. 底层网络连接配置
  150.  
  151. pkt_buf  用于网络包的内部缓冲区大小，会影响发出的TCP包的大小即内存的使用，默认值为2048，一般保持默认值
  152.  
  153. max_packet_size  通过PgBouncer最大的包大小，包可以是一个SQL，也可以是返回的结果，默认值是2147483647
  154.  
  155. listen_backlog  TCP监听函数listen的Backlog参数，默认值为128
  156.  
  157. sbuf_loopcnt   处理过程中，每个连接处理多少数据就切换到下一个连接。默认为5，如果设置为0，表示不限制。不限制时，一个连接发送大量数据，另外的连接可能就会空闲，导致被结束掉。
  158.  
  159. tcp_defer_accept linux下，默认为45，其他平台为0。详细解释用man 7 tcp来查看
  160.  
  161. tcp_socket_buffer  默认没有设置
  162.  
  163. tcp_keepalive 是否以操作系统的默认值打开基本的keepalive 设置，在linux下，操作系统的keepalive里，默认值时tcp_keepidle=7200, tcp_keepintvl-75,tcp_keepcnt=9，其他操作系统类型，默认值为1
  164.  
  165. tcp_keepcnt  默认未设置
  166.  
  167. tcp_keepidle 默认未设置
  168.  
  169. tcp_keepintvl 默认未设置
  170. 　　
  171.  
  172. 来源：https://blog.csdn.net/zhaowenzhong/article/details/89308593
  173. https://blog.csdn.net/zhaowenzhong/article/details/89308412

　　

版权声明：本文为caidingyu原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/caidingyu/p/12047379.html