Updated documentation.

This commit is contained in:
Markus Makela
2015-08-25 16:35:25 +03:00
parent 79c77d3f01
commit 6ed3f0eee4
2 changed files with 4 additions and 4 deletions

View File

@ -75,12 +75,12 @@ There is a possibility for misbehavior; if `USE mytable` was executed in one of
The above-mentioned behavior can be partially controller with the `use_sql_variables_in` configuration parameter.
```
use_sql_variables_in=[master|all] (master)
use_sql_variables_in=[master|all] (default: all)
```
Server-side session variables are called as SQL variables. If "master" or no value is set, SQL variables are read and written in master only. Autocommit values and prepared statements are routed to all nodes always.
Server-side session variables are called as SQL variables. If "master" is set, SQL variables are read and written in master only. Autocommit values and prepared statements are routed to all nodes always.
**NOTE**: If variable is written as a part of write query, it is treated like write query and not routed to all servers. For example, `INSERT INTO test.t1 VALUES (@myvar:= 7)` will be routed to the master and an error in the error log will be written.
**NOTE**: If variable is written as a part of write query, it is treated like write query and not routed to all servers. For example, `INSERT INTO test.t1 VALUES (@myvar:= 7)` will not be routed and an error in the error log will be written. Add the `use_sql_variables_in=master` to the service definition to allow these queries.
#### Examples of session command limitations

View File

@ -65,7 +65,7 @@ where *<criteria>* is one of the following:
**`use_sql_variables_in`** specifies where should queries, which read session variable, be routed. The syntax for `use_sql_variable_in` is:
use_sql_variables_in=[master|all]
use_sql_variables_in=[master|all] (default: all)
When value all is used, queries reading session variables can be routed to any available slave (depending on selection criteria). Note, that queries modifying session variables are routed to all backend servers by default, excluding write queries with embedded session variable modifications, such as: