Hasql.Pool

Documentation

data Pool

A pool of connections to DB.

Instances

Show Pool

Defined in Hasql.Pool

Methods

showsPrec :: Int -> Pool -> ShowS

show :: Pool -> String

showList :: [Pool] -> ShowS

type Settings = (PoolSize, ResidenceTimeout, Settings)

Settings of the connection pool. Consist of:

• Pool-size.
• Timeout. An amount of time for which an unused resource is kept open. The smallest acceptable value is 0.5 seconds.
• Connection settings.

data UsageError

A union over the connection establishment error and the session error.

Constructors

ConnectionError ConnectionError

SessionError QueryError

Instances

Eq UsageError

Defined in Hasql.Pool

Methods

(==) :: UsageError -> UsageError -> Bool

(/=) :: UsageError -> UsageError -> Bool

Show UsageError

Defined in Hasql.Pool

Methods

showsPrec :: Int -> UsageError -> ShowS

show :: UsageError -> String

showList :: [UsageError] -> ShowS

acquire :: Settings -> IO Pool

Given the pool-size, timeout and connection settings create a connection-pool.

acquireWith :: PoolStripes -> ConnectionGetter -> Settings -> IO Pool

Similar to acquire, allows for finer configuration.

release :: Pool -> IO ()

Release the connection-pool.

use :: Pool -> Session a -> IO (Either UsageError a)

Use a connection from the pool to run a session and return the connection to the pool, when finished.

useWithObserver :: Maybe ObserverAction -> Pool -> Session a -> IO (Either UsageError a)

Same as use but allows for a custom observer action. You can use it for gathering latency metrics.

getPoolUsageStat :: Pool -> IO PoolSize