sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Coverage for new 1.1.0 statistics and changes/BC breaks between 1.0.x alpha - 1.1.0 beta

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@317190 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Ulf Wendel 2011-09-23 11:42:04 +00:00
parent 472094bae9
commit be11f1a0d1
2 changed files with 119 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
reference/mysqlnd_ms/changes.xml
View file

@ -52,7 +52,8 @@
BC break: <function>mysqlnd_ms_set_user_pick_server</function>
has been removed.
The <literal>user</literal> filter has been introduced to replace it.
The filter offers almost the same functionality, see below for details.
The filter offers almost the same functionality, see below for a
discussion of differences.
</simpara>
</listitem>
</itemizedlist>
@ -73,6 +74,22 @@
Support for (native) prepared statements.
</simpara>
</listitem>
<listitem>
<para>
New statistics: <literal>use_master_guess</literal>,
<literal>use_slave_guess</literal>.
<itemizedlist>
<listitem>
<simpara>
BC break: Semantics of statistics changed for
<literal>use_slave</literal>, <literal>use_master</literal>.
Future changes are likely. Please see,
<function>mysqlnd_ms_get_stats</function>.
</simpara>
</listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>
</para>
<para>

118
reference/mysqlnd_ms/functions/mysqlnd-ms-get-stats.xml
View file

@ -74,12 +74,34 @@
<literal>use_slave</literal>
</entry>
<entry>
Number of statements considered as read-only by the built-in query analyzer.
Neither statements which begin with a SQL hint to force
use of slave nor statements directed to a slave by an user-defined
callback are included. The total number of statements sent to the slaves is
<literal>use_slave</literal> + <literal>use_slave_sql_hint</literal> +
<literal>use_slave_callback</literal>.
<para>
The semantics of this statistic has changed between 1.0.1 - 1.1.0.
</para>
<para>
The meaning for version 1.0.1 is as follows.
Number of statements considered as read-only by the built-in query analyzer.
Neither statements which begin with a SQL hint to force
use of slave nor statements directed to a slave by an user-defined
callback are included. The total number of statements sent to the slaves is
<literal>use_slave</literal> + <literal>use_slave_sql_hint</literal> +
<literal>use_slave_callback</literal>.
</para>
<para>
PECL/mysqlnd_ms 1.1.0 introduces a new concept of chained filters. The
statictics is now set by the internal load balancing filter. With
version 1.1.0 the load balancing filter is always the last in the
filter chain, if used. In future versions a load balancing filter may be
followed by other filters causing another change in the meaning of
the statistic. If, in the future, a load balancing filter is followed
by another filter it is no longer guaranteed that the satement, whichs
increments <literal>use_slave</literal>, will be executed on the slaves.
</para>
<para>
The meaning for version 1.1.0 is as follows. Number of statements
sent to the slaves. Statements directed to a slave by the user filter
(an user-defined callback) are not included. The latter are counted by
<literal>use_slave_callback</literal>.
</para>
</entry>
<entry>Since 1.0.0.</entry>
</row>
@ -88,15 +110,67 @@
<literal>use_master</literal>
</entry>
<entry>
Number of statements not considered as read-only by the built-in query analyzer.
Neither statements which begin with a SQL hint to force
use of master nor statements directed to a master by an user-defined
callback are included. The total number of statements sent to the master is
<literal>use_master</literal> + <literal>use_master_sql_hint</literal> +
<literal>use_master_callback</literal>.
<para>
The semantics of this statistic has changed between 1.0.1 - 1.1.0.
</para>
<para>
The meaning for version 1.0.1 is as follows.
Number of statements not considered as read-only by the built-in query analyzer.
Neither statements which begin with a SQL hint to force
use of master nor statements directed to a master by an user-defined
callback are included. The total number of statements sent to the master is
<literal>use_master</literal> + <literal>use_master_sql_hint</literal> +
<literal>use_master_callback</literal>.
</para>
<para>
PECL/mysqlnd_ms 1.1.0 introduces a new concept of chained filters. The
statictics is now set by the internal load balancing filter. With
version 1.1.0 the load balancing filter is always the last in the
filter chain, if used. In future versions a load balancing filter may be
followed by other filters causing another change in the meaning of
the statistic. If, in the future, a load balancing filter is followed
by another filter it is no longer guaranteed that the satement, whichs
increments <literal>use_master</literal>, will be executed on the slaves.
</para>
<para>
The meaning for version 1.1.0 is as follows. Number of statements
sent to the masters. Statements directed to a master by the user filter
(an user-defined callback) are not included. The latter are counted by
<literal>use_master_callback</literal>.
</para>
</entry>
<entry>Since 1.0.0.</entry>
</row>
<row>
<entry>
<literal>use_slave_guess</literal>
</entry>
<entry>
Number of statements the built-in query analyzer recommends sending to
a slave because they contain no SQL hint to force use of a
certain server. The recommendation may be overruled in the following.
It is not guaranteed whether the statement will be excuted on a slave
or not. This is how often the internal <literal>is_select</literal>
function has guessed that a slave shall be used. Please, see also the
user space function <function>mysqlnd_ms_query_is_select</function>.
</entry>
<entry>Since 1.1.0.</entry>
</row>
<row>
<entry>
<literal>use_master_guess</literal>
</entry>
<entry>
Number of statements the built-in query analyzer recommends sending to
a master because they contain no SQL hint to force use of a
certain server. The recommendation may be overruled in the following.
It is not guaranteed whether the statement will be excuted on a slave
or not. This is how often the internal <literal>is_select</literal>
function has guessed that a master shall be used. Please, see also the
user space function <function>mysqlnd_ms_query_is_select</function>.
</entry>
<entry>Since 1.1.0.</entry>
</row>
<row>
<entry>
<literal>use_slave_sql_hint</literal>
@ -301,6 +375,7 @@
<programlisting role="php">
<![CDATA[
<?php
printf("mysqlnd_ms.enable = %d\n", ini_get("mysqlnd_ms.enable"));
printf("mysqlnd_ms.collect_statistics = %d\n", ini_get("mysqlnd_ms.collect_statistics"));
var_dump(mysqlnd_ms_get_stats());
?>
@ -309,17 +384,26 @@ var_dump(mysqlnd_ms_get_stats());
&example.outputs;
<screen>
<![CDATA[
mysqlnd_ms.collect_statistics = 0
array(13) {
mysqlnd_ms.enable = 1
mysqlnd_ms.collect_statistics = 1
array(20) {
["use_slave"]=>
string(1) "0"
["use_master"]=>
string(1) "0"
["use_slave_forced"]=>
["use_slave_guess"]=>
string(1) "0"
["use_master_forced"]=>
["use_master_guess"]=>
string(1) "0"
["use_last_used_forced"]=>
["use_slave_sql_hint"]=>
string(1) "0"
["use_master_sql_hint"]=>
string(1) "0"
["use_last_used_sql_hint"]=>
string(1) "0"
["use_slave_callback"]=>
string(1) "0"
["use_master_callback"]=>
string(1) "0"
["non_lazy_connections_slave_success"]=>
string(1) "0"