svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml functions/mysqlnd-ms-get-stats.xml

From: Date: Sat, 02 Aug 2014 17:52:33 +0000
Subject: svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ changes.xml functions/mysqlnd-ms-get-stats.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-12693@lists.php.net to get a copy of this message
uw Sat, 02 Aug 2014 17:52:33 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=334467 Log: New internal connection pool and its statistics Changed paths: U phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml U phpdoc/en/trunk/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml Modified: phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2014-08-02 17:11:35 UTC (rev 334466) +++ phpdoc/en/trunk/reference/mysqlnd_ms/changes.xml 2014-08-02 17:52:33 UTC (rev 334467) @@ -89,6 +89,28 @@ <itemizedlist> <listitem> <para> + 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. + </para> + <para> + 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. + </para> + <para> + 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. + </para> + </listitem> + <listitem> + <para> Added a basic distributed transaction abstraction. XA transactions can are supported ever since using standard SQL calls. This is inconvenient as XA participants must be managed manually. Modified: phpdoc/en/trunk/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml 2014-08-02 17:11:35 UTC (rev 334466) +++ phpdoc/en/trunk/reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml 2014-08-02 17:52:33 UTC (rev 334467) @@ -594,6 +594,74 @@ </entry> <entry>Since 1.6.0.</entry> </row> + <row> + <entry> + <literal>pool_masters_total</literal> + </entry> + <entry> + Number of master servers (connections) in the internal connection pool. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_slaves_total</literal> + </entry> + <entry> + Number of slave servers (connections) in the internal connection pool. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_masters_active</literal> + </entry> + <entry> + Number of master servers (connections) from the internal connection pool + which are currently used for picking a connection. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_slaves_active</literal> + </entry> + <entry> + Number of slave servers (connections) from the internal connection pool + which are currently used for picking a connection. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_updates</literal> + </entry> + <entry> + Number of slave servers (connections) from the internal connection pool + which are currently used for picking a connection. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_master_reactivated</literal> + </entry> + <entry> + How often a master connection has been reused after being + flushed from the active list. + </entry> + <entry>Since 1.6.0.</entry> + </row> + <row> + <entry> + <literal>pool_slave_reactivated</literal> + </entry> + <entry> + How often a slave connection has been reused after being + flushed from the active list. + </entry> + <entry>Since 1.6.0.</entry> + </row> </tbody> </tgroup> </informaltable>

« previous php.doc.cvs (#12693) next »