hcq/MaxScale
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update readwritesplit documentation

Browse Source 
Fixed a few typos, added the 10.2 relese where last_gtid tracking was
enabled, changed wording.
This commit is contained in:
Markus Mäkelä
2018-10-02 11:07:17 +03:00
parent d866cb3a21
commit d5dbad19bb
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Documentation/Routers/ReadWriteSplit.md
View File

@ -84,7 +84,7 @@ type=service
router=readwritesplit router=readwritesplit
servers=dbserv1, dbserv2, dbserv3 servers=dbserv1, dbserv2, dbserv3
user=maxscale user=maxscale
passwd=96F99AA1315BDC3604B006F427DD9484 password=96F99AA1315BDC3604B006F427DD9484
disable_sescmd_history=true disable_sescmd_history=true
master_failure_mode=fail_on_write master_failure_mode=fail_on_write
``` ```
@ -381,7 +381,7 @@ are met, the transaction can be safely replayed.
If the results from the replacement server are not identical when the transaction is If the results from the replacement server are not identical when the transaction is
replayed, the client connection is closed. This means that any transaction with a server replayed, the client connection is closed. This means that any transaction with a server
specific result (e.g. `NOW()`, `@@server_id`) cannot be replayed. specific result (e.g. `NOW()`, `@@server_id`) cannot be replayed successfully.
Performing MVCC reads (`SELECT` queries without `FOR UPDATE` or `LOCK IN SHARE MODE`) Performing MVCC reads (`SELECT` queries without `FOR UPDATE` or `LOCK IN SHARE MODE`)
with transaction replay is discouraged. If such statements are executed with transaction replay is discouraged. If such statements are executed
@ -428,9 +428,9 @@ subsequent reads performed on slave servers will be done in a manner that
prevents replication lag from affecting the results. This only applies to the prevents replication lag from affecting the results. This only applies to the
modifications done by the client itself. modifications done by the client itself.
**Note:** This feature requires MariaDB 10.2.X (TODO: update this once **Note:** This feature requires MariaDB 10.2.16 or newer to function. In
it's merged) or newer to function. In addition to this, the addition to this, the `session_track_system_variables` parameter must be set
`session_track_system_variables` parameter must be set to `last_gtid`. to `last_gtid`.
A practical example can be given by the following set of SQL commands executed A practical example can be given by the following set of SQL commands executed
with `autocommit=1`. with `autocommit=1`.
@ -448,7 +448,7 @@ appear as if the value we just inserted is not there.
By prefixing these types of SELECT statements with a command that guarantees By prefixing these types of SELECT statements with a command that guarantees
consistent results for the reads, read scalability can be improved without consistent results for the reads, read scalability can be improved without
reduced consistency. sacrificing consistency.
The set of example SQL above will be translated by MaxScale into the following The set of example SQL above will be translated by MaxScale into the following
statements. statements.
@ -469,7 +469,7 @@ the replication stream (see
for more details). If the slave has not caught up to the master within the for more details). If the slave has not caught up to the master within the
configured time, an error will be returned. To the client side configured time, an error will be returned. To the client side
application, this will appear as an error on the statement that they were application, this will appear as an error on the statement that they were
performing. This is caused by the fact that the syncronization command is performing. This is caused by the fact that the synchronization command is
executed with the original command as a multi-statement command. executed with the original command as a multi-statement command.
### `causal_reads_timeout` ### `causal_reads_timeout`