Spec-Zone .ru
спецификации, руководства, описания, API
|
START SLAVE [thread_types
] [until_option
] [connection_options
]thread_types
: [thread_type
[,thread_type
] ... ]thread_type
: IO_THREAD | SQL_THREADuntil_option
: UNTIL { {SQL_BEFORE_GTIDS | SQL_AFTER_GTIDS} =gtid_set
| MASTER_LOG_FILE = 'log_name
', MASTER_LOG_POS =log_pos
| RELAY_LOG_FILE = 'log_name
', RELAY_LOG_POS =log_pos
| SQL_AFTER_MTS_GAPS }connection_options
: [USER='user_name
'] [PASSWORD='user_pass
'] [DEFAULT_AUTH='plugin_name
'] [PLUGIN_DIR='plugin_dir
']gtid_set
:uuid_set
[,uuid_set
] ... | ''uuid_set
:uuid
:interval
[:interval
]...uuid
:hhhhhhhh
-hhhh
-hhhh
-hhhh
-hhhhhhhhhhhh
h
: [0-9,A-F]interval
:n
[-n
] (n
>= 1)
START
SLAVE
with no thread_type
options starts both of the slave
threads. The I/O thread reads events from the master server and stores them in the relay log. The SQL thread
reads events from the relay log and executes them. START SLAVE
requires the SUPER
privilege.
If START SLAVE
succeeds in starting the slave threads, it returns without any error.
However, even in that case, it might be that the slave threads start and then later stop (for example, because
they do not manage to connect to the master or read its binary log, or some other problem). START SLAVE
does not warn you about this. You must check the slave's error
log for error messages generated by the slave threads, or check that they are running satisfactorily with SHOW SLAVE STATUS
.
In MySQL 5.6.7 and later, START SLAVE
causes an implicit commit of an ongoing
transaction. See Section 13.3.3, "Statements That
Cause an Implicit Commit".
Beginning with MySQL 5.6.11, gtid_next
must be set to AUTOMATIC
before issuing this statement (Bug #16062608).
MySQL 5.6.4 and later supports pluggable user-password authentication with START
SLAVE
with the USER
, PASSWORD
, DEFAULT_AUTH
and PLUGIN_DIR
options, as described in the
following list:
USER
: User name. Cannot be set to an empty or null
string, or left unset if PASSWORD
is used.
PASSWORD
: Password.
DEFAULT_AUTH
: Name of plugin; default is MySQL native
authentication.
PLUGIN_DIR
: Location of plugin.
Starting with MySQL 5.6.4, you cannot use the SQL_THREAD
option when specifying
USER
, PASSWORD
, or both. (Bug #13083642).
See Section 6.3.7, "Pluggable Authentication", for more information.
If an insecure connection is used with any these options, the server issues the warning Sending passwords in plain text without SSL/TLS is extremely insecure.
Starting with MySQL 5.6.6, START SLAVE ... UNTIL
supports two additional options
for use with global transaction identifiers (GTIDs) (see Section
16.1.3, "Replication with Global Transaction Identifiers"). Each of these takes a set of one or more
global transaction identifiers gtid_set
as an argument (see GTID
sets, for more information).
When no thread_type
is specified, START SLAVE
UNTIL SQL_BEFORE_GTIDS
causes both the slave SQL thread to process and the slave I/O thread to fetch
transactions until both of them have reached the first transaction whose
GTID is listed in the gtid_set
. START SLAVE
UNTIL SQL_AFTER_GTIDS
causes the slave threads to process all transactions until the last
transaction in the gtid_set
has been processed by both threads. In other words, START SLAVE UNTIL SQL_BEFORE_GTIDS
causes the slave SQL to process and I/O
threads to fetch all transactions occurring before the first GTID in the gtid_set
is reached, and START SLAVE UNTIL
SQL_AFTER_GTIDS
causes the slave threads to handle all transactions, including those whose GTIDs are
found in gtid_set
, until each has encountered a transaction whose GTID
is not part of the set. SQL_BEFORE_GTIDS
and SQL_AFTER_GTIDS
each support the SQL_THREAD
and
IO_THREAD
options.
For example, START SLAVE SQL_THREAD UNTIL SQL_BEFORE_GTIDS =
3E11FA47-71CA-11E1-9E33-C80AA9429562:11-56
causes the slave SQL thread to process all transactions
originating from the master whose server_uuid
is 3E11FA47-71CA-11E1-9E33-C80AA9429562
until it encounters the transaction having
sequence number 11; it then stops without processing this transaction. In other words, all transactions up to
and including the transaction with sequence number 10 are processed. Executing START SLAVE
IO_THREAD UNTIL SQL_AFTER_GTIDS = 3E11FA47-71CA-11E1-9E33-C80AA9429562:11-56
, on the other hand,
would cause the slave I/O thread to obtain all transactions just mentioned from the master, including all of the
transactions having the sequence numbers 11 through 56, and then to stop without processing any additional
transactions; that is, the transaction having sequence number 56 would be the last transaction fetched by the
slave I/O thread.
With neither the SQL_THREAD
option nor the IO_THREAD
option, the previous statement would cause the slave SQL thread to execute all transactions originating from
this master, including all transactions with sequence numbers 11 through 56, and then to stop without processing
any additional transactions. The same command would also cause the slave I/O thread to start. When the SQL
thread reaches the condition, it is stopped. In other words, START SLAVE UNTIL
SQL_BEFORE_GTIDS
has the same effect as START SLAVE SQL_THREAD, IO_THREAD UNTIL
SQL_BEFORE_GTIDS
; the slave SQL thread and slave I/O thread are each started, and the SQL thread
continues executing transactions until the stop condition for that thread is met. (Similarly, START SLAVE UNTIL SQL_AFTER_GTIDS
is effectively the same as START SLAVE SQL_THREAD, IO_THREAD UNTIL SQL_AFTER_GTIDS
.)
The SQL_BEFORE_GTIDS
and SQL_AFTER_GTIDS
keywords are present in the MySQL 5.6.5 server; however, neither of them functioned correctly as options
with START SLAVE [SQL_THREAD | IO_THREAD] UNTIL
in that version, and are
therefore supported beginning only with MySQL 5.6.6. (Bug#13810456)
START SLAVE UNTIL SQL_AFTER_MTS_GAPS
is available in MySQL 5.6.6 or later. This
statement causes a multi-threaded slave's SQL threads to run until no more gaps are found in the relay log, and
then to stop. This statement can take an SQL_THREAD
option, but the effects of the
statement remain unchanged. It has no effect on the slave I/O thread (and cannot be used with the IO_THREAD
option). START SLAVE UNTIL
SQL_AFTER_MTS_GAPS
should be used before switching the slave from multi-threaded mode to
single-threaded mode (that is, when resetting slave_parallel_workers
back to 0 from a positive, nonzero value) after slave
has failed with errors in multi-threaded mode.
To change a failed multi-threaded slave to single-threaded mode, you can issue the following series of statements, in the order shown:
START SLAVE UNTIL SQL_AFTER_MTS_GAPS;SET @@GLOBAL.slave_parallel_workers = 0;START SLAVE SQL_THREAD;
If you were running the failed multi-threaded slave with relay_log_recovery
enabled, then you must issue START SLAVE
UNTIL SQL_AFTER_MTS_GAPS
prior to executing CHANGE MASTER TO
. Otherwise the latter statement fails.
It is possible to view the entire text of a running START SLAVE ...
statement, including any USER
or PASSWORD
values
used, in the output of SHOW
PROCESSLIST
. This is also true for the text of a running CHANGE MASTER TO
statement, including any values it employs for MASTER_USER
or MASTER_PASSWORD
.
START
SLAVE
sends an acknowledgment to the user after both the I/O thread and the SQL thread have started.
However, the I/O thread may not yet have connected. For this reason, a successful START SLAVE
causes SHOW SLAVE STATUS
to show Slave_SQL_Running=Yes
,
but this does not guarantee that Slave_IO_Running=Yes
(because Slave_IO_Running=Yes
only if the I/O thread is running and connected). For more information, see Section
13.7.5.35, "SHOW SLAVE STATUS
Syntax", and Section
16.1.5.1, "Checking Replication Status".
You can add IO_THREAD
and SQL_THREAD
options to the
statement to name which of the threads to start. In MySQL 5.6.4 and later, the SQL_THREAD
option is disallowed when specifying USER
,
PASSWORD
, or both (Bug #13083642).
An UNTIL
clause (until_option
, in the
preceding grammar) may be added to specify that the slave should start and run until the SQL thread reaches a
given point in the master binary log or in the slave relay log. When the SQL thread reaches that point, it
stops. If the SQL_THREAD
option is specified in the statement, it starts only the
SQL thread. Otherwise, it starts both slave threads. If the SQL thread is running, the UNTIL
clause is ignored and a warning is issued. You cannot use an UNTIL
clause with the
IO_THREAD
option.
In MySQL 5.6.6 and later, it is also possible with START SLAVE UNTIL
to specify a
stop point relative to a given GTID or set of GTIDs using one of the options SQL_BEFORE_GTIDS
or SQL_AFTER_GTIDS
, as explained previously in this section. When using one of
these options, you can specify SQL_THREAD
, IO_THREAD
,
both of these, or neither of them. If you specify only SQL_THREAD
, then only the
slave SQL thread is affected by the statement; if only IO_THREAD
is used, then only
the slave I/O is affected. If both SQL_THREAD
and IO_THREAD
are used, or if neither of them is used, then both the SQL and I/O
threads are affected by the statement.
The UNTIL
clause is not supported for multi-threaded slaves except when also using
SQL_AFTER_MTS_GAPS
. Prior to MySQL 5.6.6, UNTIL
was
not supported at all for multi-threaded slaves.
For an UNTIL
clause, you must specify any one of the following:
Both a log file name and a position in that file
(MySQL 5.6.6 or later:) Either of SQL_BEFORE_GTIDS
or SQL_AFTER_GTIDS
(MySQL 5.6.6 or later:) SQL_AFTER_MTS_GAPS
Do not mix master and relay log options. In MySQL 5.6.6 and later, do not mix log file options with GTID options.
Any UNTIL
condition is reset by a subsequent STOP SLAVE
statement, a START SLAVE
statement that includes no UNTIL
clause,
or a server restart.
When specifying a log file and position, you can use the IO_THREAD
option with
START SLAVE ... UNTIL
even though only the SQL thread is affected by this
statement. The IO_THREAD
option is ignored in such cases. The preceding restriction
does not apply when using one of the GTID options (SQL_BEFORE_GTIDS
and SQL_AFTER_GTIDS
) introduced in MySQL 5.6.6; the GTID options support both SQL_THREAD
and IO_THREAD
, as explained previously in
this section.
The UNTIL
clause can be useful for debugging replication, or to cause replication
to proceed until just before the point where you want to avoid having the slave replicate an event. For example,
if an unwise DROP TABLE
statement was executed on the master, you can use UNTIL
to tell the slave to execute up to that point but no farther. To find what
the event is, use mysqlbinlog
with the master binary log or slave relay log, or by using a SHOW BINLOG EVENTS
statement.
If you are using UNTIL
to have the slave process replicated queries in sections, it
is recommended that you start the slave with the --skip-slave-start
option to prevent the SQL thread from running when the
slave server starts. It is probably best to use this option in an option file rather than on the command line,
so that an unexpected server restart does not cause it to be forgotten.
The SHOW SLAVE STATUS
statement includes output fields that display the current
values of the UNTIL
condition.
In very old versions of MySQL (before 4.0.5), this statement was called SLAVE START
.
That syntax is no longer accepted as of MySQL 5.6.1.