Session

Construct a Session by wrapping an existing Protocol, which we assume has already been started up.

Resource yielding a SessionPool managing up to max concurrent Sessions. Typically you will use this resource once on application startup and pass the resulting Resource[F, Session[F]] to the rest of your program.

The pool maintains a cache of queries and commands that have been checked against the schema, eliminating the need to check them more than once. If your program is changing the schema on the fly than you probably don't want this behavior; you can disable it by setting the commandCache and queryCache parameters to zero.

Note that calling .flatten on the nested Resource returned by this method may seem reasonable, but it will result in a resource that allocates a new pool for each session, which is probably not what you want.

Resource yielding a function from Trace to SessionPool managing up to max concurrent Sessions. Typically you will use this resource once on application startup and pass the resulting Resource[F, Session[F]] to the rest of your program.

The pool maintains a cache of queries and commands that have been checked against the schema, eliminating the need to check them more than once. If your program is changing the schema on the fly than you probably don't want this behavior; you can disable it by setting the commandCache and queryCache parameters to zero.

Abstract implementation that use the MonadCancelThrow constraint to implement prepared-if-needed API

Resource yielding logically unpooled sessions. This can be convenient for demonstrations and programs that only need a single session. In reality each session is managed by its own single-session pool. This method is shorthand for Session.pooled(..., max = 1, ...).flatten.

Resource yielding logically unpooled sessions given a Trace. This can be convenient for demonstrations and programs that only need a single session. In reality each session is managed by its own single-session pool.