diff --git a/reference/mysqlnd_ms/changes.xml b/reference/mysqlnd_ms/changes.xml index c5c779af89..4660e0d8fa 100644 --- a/reference/mysqlnd_ms/changes.xml +++ b/reference/mysqlnd_ms/changes.xml @@ -87,6 +87,28 @@ Feature changes + + + Introduced an internal connection pool. When using Fabric and switching + from shard group A to shard group B, we are replacing the entire list of + masters and slaves. This troubles the connections state alignment logic and + some filters. Some filters cache information on the master and slave lists. + The new internal connection pool abstraction allows us to inform the filters + of changes, hence they can update their caches. + + + Later on, the pool can also be used to reduce connection overhead. Assume + you are switching from a shard group to another and back again. Whenever + the switch is done, the pool's active server (and connection) lists are + replaced. However, no longer used connections are not necessarily closed + immediately but can be kept in the pool for later reuse. + + + Please note, the connection pool is internalat this point. There are some + new statistics to monitor it. However, you cannot yet configure pool size + of behaviour. + + Added a basic distributed transaction abstraction. diff --git a/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml b/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml index 171419c069..f420496666 100755 --- a/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml +++ b/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml @@ -594,6 +594,74 @@ Since 1.6.0. + + + pool_masters_total + + + Number of master servers (connections) in the internal connection pool. + + Since 1.6.0. + + + + pool_slaves_total + + + Number of slave servers (connections) in the internal connection pool. + + Since 1.6.0. + + + + pool_masters_active + + + Number of master servers (connections) from the internal connection pool + which are currently used for picking a connection. + + Since 1.6.0. + + + + pool_slaves_active + + + Number of slave servers (connections) from the internal connection pool + which are currently used for picking a connection. + + Since 1.6.0. + + + + pool_updates + + + Number of slave servers (connections) from the internal connection pool + which are currently used for picking a connection. + + Since 1.6.0. + + + + pool_master_reactivated + + + How often a master connection has been reused after being + flushed from the active list. + + Since 1.6.0. + + + + pool_slave_reactivated + + + How often a slave connection has been reused after being + flushed from the active list. + + Since 1.6.0. +