package caqti

You can search for identifiers within the package.

in-package search v0.2.0

Unified interface to relational database libraries

Install

dune-project

Dependency

github.com Readme Changelog Edit opam file Versions (24)

Authors

Maintainers

P

Petter A. Urkedal <paurkedal@gmail.com>

Sources

caqti-v3.0.0.tbz

sha256=3ceea06ba0e8e8bcab0386b5817b68cb30fce457eaa25ada0182891d66f6a0b9

sha512=e01f546a45b04cafd5fa262e9228e5a1aabd5e0942059c073a4181c928450baf3d990cc59ffb1a33dff445b46a0e218224a23dca96e8d24cdd0ab793d08e4538

doc/caqti.classic/Caqti_pool_config/index.html

Module `Caqti_pool_config`Source

include module type of struct include Caqti.Pool.Config end

Sourcetype _ key = _ Caqti.Pool.Config.key

Sourcetype t = Caqti.Pool.Config.t

Construction and Generic Operations

Source

val create : 
  ?max_size:int ->
  ?max_idle_size:int ->
  ?max_idle_age:Mtime.Span.t option ->
  ?max_use_count:int option ->
  unit ->
  t

Creates a configuration for the implementation of Caqti.Pool.S. The main arguments populate the configuration with the corresponding settings, which are explaind in Configuration Keys.

Sourceval default : t

The configuration object with no setting, which gives the built-in defaults. Alternatively, use default_from_env for a configuration based on environment variables.

Sourceval default_from_env : unit -> t

default_from_env () is a configuration constructed from environment variables of the form CAQTI_POOL_<suffix>, with the upper-cased names of the configuration keys substituted for <suffix>.

Sourceval merge_left : t -> t -> t

merge_left cL cR is the configuration cL with missing settings populated by the corresponding present settings from cR.

Sourceval get : 'a key -> t -> 'a option

get key config is the value of key in config or None if unset.

Sourceval set : 'a key -> 'a -> t -> t

set key value config is config with key set to value regardless of any previous mapping.

Sourceval unset : 'a key -> t -> t

unset key config is config without its mapping for key if any.

Configuration Keys

Sourceval max_size : int key

The maximum number of open connections associated with the pool. When this limit is hit, an attempt to use the pool will block until a connection becomes available. The value must be at least one. If the selected driver does not support concurrent connections, the value 1 is assumed.

Sourceval max_idle_size : int key

The maximum number of idle connections to put into the pool for reuse. Must be between 0 and max_size. If you set this, you must also ensure max_size is set so that the combination is valid. Defaults to max_size. For drivers which does not support concurrent connections, the value will clipped to a maximum of 1.

Sourceval max_idle_age : Mtime.Span.t option key

The maximum age of idle connections before they are scheduled to be disconnected and removed from the pool, or None for no limit. Where possible, a timer will be used to trigger the cleanup. For the caqti.blocking library, the cleanup will only be done opportunistically when the pool is used.

Sourceval max_use_count : int option key

The maximum number of times a pooled connection is reused, or None for no limit. The default is currently 100, but may be changed in the future based on real-world experience. The reason this setting was introduced is that we have seen state being retained on the server side.