diff --git a/CHANGELOG.md b/CHANGELOG.md index a83e6f861..6bc24d407 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Remove global NewBatch function (CASSGO-15) +- Detailed description for NumConns (CASSGO-3) + ### Fixed - Retry policy now takes into account query idempotency (CASSGO-27) diff --git a/cluster.go b/cluster.go index 13e62f3b0..413695ca4 100644 --- a/cluster.go +++ b/cluster.go @@ -102,7 +102,13 @@ type ClusterConfig struct { // Initial keyspace. Optional. Keyspace string - // Number of connections per host. + // The size of the connection pool for each host. + // The pool filling runs in separate gourutine during the session initialization phase. + // gocql will always try to get 1 connection on each host pool + // during session initialization AND it will attempt + // to fill each pool afterward asynchronously if NumConns > 1. + // Notice: There is no guarantee that pool filling will be finished in the initialization phase. + // Also, it describes a maximum number of connections at the same time. // Default: 2 NumConns int