Skip to content

Managing database connectionsλ︎

A Clojure application / REPL can connect to a database source and request a new connection. This connection can be used to send SQL statements to the database and receive the results.

In a single threaded application, then only one connection to each database would be created. In a multi-threaded application then multiple connections to the database may be created. If multiple instances of an application are deployed, then multiple database connections will be created.

As the number of simultaneous connections to the database grows, the more need for a connection pool service to maximize the performance of the database.


When a client connects to PostgreSQL database the parent process spawns a worker process which listens to the newly created connection. Spawning a work process each time can support a small number of database connections. As the number of simultaneous connections increases, CPU and memory resources also increase.

Without a connection pool a new database connection is created for each client.

Clojure WebApps - PostgreSQL database connection pool

Hint::Limits via PostgreSQL configurationλ︎

The max_connections configuration for PostgreSQL limits the number of client connections allowed, so additional connections are refused or dropped.

Connection pool with PostgreSQLλ︎

A connection pool shares a fixed set of recyclable connections which can manage a large numbers of simultaneous connections due to the reduced CPU and memory usage.

The fixed set of connections is called the pool size and it is recommended to test the size of the pool used during integration tests.

A connection pool can efficiently deal with idle or stagnant client connections, as well as queue up client requests during traffic spikes instead of rejecting them.

Clojure WebApps - PostgreSQL database connection pool

Connection pool implementationsλ︎

A connection pool can be implemented either on the application side or as middleware between the database and your application.