mirror of
https://github.com/postgresml/pgcat.git
synced 2026-03-23 01:16:30 +00:00
99247f7c88
In postgres, you can specify an `idle_session_timeout` which will close sessions idling for that amount of time. If a session is closed because of a timeout, PgCat will erroneously mark the server as unhealthy as the next health check will return an error because the connection was drop, if no health check is to be executed, it will simply fail trying to send the query to the server for the same reason, the conn was drop. Given that bb8 allows configuring an idle_timeout for pools, it would be nice to allow setting this parameter in the config file, this way you can set it to something shorter than the server one. Also, server pool will be kept smaller in moments of less traffic. Actually, currently this value is set as its default in bb8, which is 10 minutes. This changes allows setting the parameter using the config file. It can be set both globally and per pool. When creating the pool, if the pool don't have it defined, global value is used.
163 lines
4.7 KiB
TOML
163 lines
4.7 KiB
TOML
#
|
|
# PgCat config example.
|
|
#
|
|
|
|
#
|
|
# General pooler settings
|
|
[general]
|
|
# What IP to run on, 0.0.0.0 means accessible from everywhere.
|
|
host = "0.0.0.0"
|
|
|
|
# Port to run on, same as PgBouncer used in this example.
|
|
port = 6432
|
|
|
|
# Whether to enable prometheus exporter or not.
|
|
enable_prometheus_exporter = true
|
|
|
|
# Port at which prometheus exporter listens on.
|
|
prometheus_exporter_port = 9930
|
|
|
|
# How long to wait before aborting a server connection (ms).
|
|
connect_timeout = 5000
|
|
|
|
# How long an idle connection with a server is left open (ms).
|
|
idle_timeout = 30000
|
|
|
|
# How much time to give the health check query to return with a result (ms).
|
|
healthcheck_timeout = 1000
|
|
|
|
# How long to keep connection available for immediate re-use, without running a healthcheck query on it
|
|
healthcheck_delay = 30000
|
|
|
|
# How much time to give clients during shutdown before forcibly killing client connections (ms).
|
|
shutdown_timeout = 60000
|
|
|
|
# For how long to ban a server if it fails a health check (seconds).
|
|
ban_time = 60 # seconds
|
|
|
|
# If we should log client connections
|
|
log_client_connections = false
|
|
|
|
# If we should log client disconnections
|
|
log_client_disconnections = false
|
|
|
|
# Reload config automatically if it changes.
|
|
autoreload = false
|
|
|
|
# TLS
|
|
# tls_certificate = "server.cert"
|
|
# tls_private_key = "server.key"
|
|
|
|
# Credentials to access the virtual administrative database (pgbouncer or pgcat)
|
|
# Connecting to that database allows running commands like `SHOW POOLS`, `SHOW DATABASES`, etc..
|
|
admin_username = "admin_user"
|
|
admin_password = "admin_pass"
|
|
|
|
# pool
|
|
# configs are structured as pool.<pool_name>
|
|
# the pool_name is what clients use as database name when connecting
|
|
# For the example below a client can connect using "postgres://sharding_user:sharding_user@pgcat_host:pgcat_port/sharded_db"
|
|
[pools.sharded_db]
|
|
# Pool mode (see PgBouncer docs for more).
|
|
# session: one server connection per connected client
|
|
# transaction: one server connection per client transaction
|
|
pool_mode = "transaction"
|
|
|
|
# If the client doesn't specify, route traffic to
|
|
# this role by default.
|
|
#
|
|
# any: round-robin between primary and replicas,
|
|
# replica: round-robin between replicas only without touching the primary,
|
|
# primary: all queries go to the primary unless otherwise specified.
|
|
default_role = "any"
|
|
|
|
# Query parser. If enabled, we'll attempt to parse
|
|
# every incoming query to determine if it's a read or a write.
|
|
# If it's a read query, we'll direct it to a replica. Otherwise, if it's a write,
|
|
# we'll direct it to the primary.
|
|
query_parser_enabled = true
|
|
|
|
# If the query parser is enabled and this setting is enabled, the primary will be part of the pool of databases used for
|
|
# load balancing of read queries. Otherwise, the primary will only be used for write
|
|
# queries. The primary can always be explicitly selected with our custom protocol.
|
|
primary_reads_enabled = true
|
|
|
|
# So what if you wanted to implement a different hashing function,
|
|
# or you've already built one and you want this pooler to use it?
|
|
#
|
|
# Current options:
|
|
#
|
|
# pg_bigint_hash: PARTITION BY HASH (Postgres hashing function)
|
|
# sha1: A hashing function based on SHA1
|
|
#
|
|
sharding_function = "pg_bigint_hash"
|
|
|
|
# Automatically parse this from queries and route queries to the right shard!
|
|
automatic_sharding_key = "id"
|
|
|
|
# Idle timeout can be overwritten in the pool
|
|
idle_timeout = 40000
|
|
|
|
# Credentials for users that may connect to this cluster
|
|
[pools.sharded_db.users.0]
|
|
username = "sharding_user"
|
|
password = "sharding_user"
|
|
# Maximum number of server connections that can be established for this user
|
|
# The maximum number of connection from a single Pgcat process to any database in the cluster
|
|
# is the sum of pool_size across all users.
|
|
pool_size = 9
|
|
|
|
# Maximum query duration. Dangerous, but protects against DBs that died in a non-obvious way.
|
|
statement_timeout = 0
|
|
|
|
[pools.sharded_db.users.1]
|
|
username = "other_user"
|
|
password = "other_user"
|
|
pool_size = 21
|
|
statement_timeout = 15000
|
|
|
|
# Shard 0
|
|
[pools.sharded_db.shards.0]
|
|
# [ host, port, role ]
|
|
servers = [
|
|
[ "127.0.0.1", 5432, "primary" ],
|
|
[ "localhost", 5432, "replica" ]
|
|
]
|
|
# Database name (e.g. "postgres")
|
|
database = "shard0"
|
|
|
|
[pools.sharded_db.shards.1]
|
|
servers = [
|
|
[ "127.0.0.1", 5432, "primary" ],
|
|
[ "localhost", 5432, "replica" ],
|
|
]
|
|
database = "shard1"
|
|
|
|
[pools.sharded_db.shards.2]
|
|
servers = [
|
|
[ "127.0.0.1", 5432, "primary" ],
|
|
[ "localhost", 5432, "replica" ],
|
|
]
|
|
database = "shard2"
|
|
|
|
|
|
[pools.simple_db]
|
|
pool_mode = "session"
|
|
default_role = "primary"
|
|
query_parser_enabled = true
|
|
primary_reads_enabled = true
|
|
sharding_function = "pg_bigint_hash"
|
|
|
|
[pools.simple_db.users.0]
|
|
username = "simple_user"
|
|
password = "simple_user"
|
|
pool_size = 5
|
|
statement_timeout = 0
|
|
|
|
[pools.simple_db.shards.0]
|
|
servers = [
|
|
[ "127.0.0.1", 5432, "primary" ],
|
|
[ "localhost", 5432, "replica" ]
|
|
]
|
|
database = "some_db"
|