← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/replication.rst

  • Committer: Brian Aker
  • Date: 2010-10-27 21:00:49 UTC
  • mto: This revision was merged to the branch mainline in revision 1886.
  • Revision ID: brian@tangent.org-20101027210049-zfpgx2cfbrh8maq9
A couple of fixes to documentation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/replication.rst
6
6
sub-messages. There is a single main "envelope" message, Transaction, that
7
7
is passed to plugins that subscribe to the replication stream.
8
8
 
9
 
Configuration Options
10
 
---------------------
11
 
 
12
 
**transaction_message_threshold**
13
 
 
14
 
    Controls the size, in bytes, of the Transaction messages. When a Transaction
15
 
    message exceeds this size, a new Transaction message with the same
16
 
    transaction ID will be created to continue the replication events.
17
 
    See :ref:`bulk-operations` below.
18
 
 
19
 
 
20
 
**replicate_query**
21
 
 
22
 
    Controls whether the originating SQL query will be included within each
23
 
    Statement message contained in the enclosing Transaction message. The
24
 
    default global value is FALSE which will not include the query in the
25
 
    messages. It can be controlled per session, as well. For example:
26
 
 
27
 
    ``drizzle> set @@replicate_query = 1;``
28
 
 
29
 
    The stored query should be used as a guide only, and never executed
30
 
    on a slave to perform replication as this will lead to incorrect results.
31
9
 
32
10
Message Definitions
33
11
-------------------
124
102
of the Statement should construct the inner Statement subclass representing
125
103
a data change.
126
104
 
127
 
Statements are recorded seperatley as sometimes individual statements
128
 
have to be rolled back.
129
 
 
130
 
 
131
 
.. _bulk-operations:
132
105
 
133
106
How Bulk Operations Work
134
107
------------------------
216
189
Handling ROLLBACKs
217
190
------------------
218
191
 
219
 
Both transactions and individual statements may be rolled back.
220
 
 
221
192
When a transaction is rolled back, one of two things happen depending
222
193
on whether the transaction is made up of either a single Transaction
223
194
message, or if it is made up of multiple Transaction messages (e.g, bulk
229
200
* For a transaction which is made up of multiple messages, and at least
230
201
  one message has already been sent through the replication stream, then
231
202
  the Transaction message will contain a Statement message with type =
232
 
  ROLLBACK.
 
203
  ROLLBACK.
 
 
b'\\ No newline at end of file'