MySQL5.7用于控制副本服务器的 SQL 语句

CHANGE MASTER TO option [, option] ... [ channel_option ]

option: {
    MASTER_BIND = 'interface_name'
  | MASTER_HOST = 'host_name'
  | MASTER_USER = 'user_name'
  | MASTER_PASSWORD = 'password'
  | MASTER_PORT = port_num
  | MASTER_CONNECT_RETRY = interval
  | MASTER_RETRY_COUNT = count
  | MASTER_DELAY = interval
  | MASTER_HEARTBEAT_PERIOD = interval
  | MASTER_LOG_FILE = 'source_log_name'
  | MASTER_LOG_POS = source_log_pos
  | MASTER_AUTO_POSITION = {0|1}
  | RELAY_LOG_FILE = 'relay_log_name'
  | RELAY_LOG_POS = relay_log_pos
  | MASTER_SSL = {0|1}
  | MASTER_SSL_CA = 'ca_file_name'
  | MASTER_SSL_CAPATH = 'ca_directory_name'
  | MASTER_SSL_CERT = 'cert_file_name'
  | MASTER_SSL_CRL = 'crl_file_name'
  | MASTER_SSL_CRLPATH = 'crl_directory_name'
  | MASTER_SSL_KEY = 'key_file_name'
  | MASTER_SSL_CIPHER = 'cipher_list'
  | MASTER_SSL_VERIFY_SERVER_CERT = {0|1}
  | MASTER_TLS_VERSION = 'protocol_list'
  | IGNORE_SERVER_IDS = (server_id_list)
}

channel_option:
    FOR CHANNEL channel

server_id_list:
    [server_id [, server_id] ... ]

CHANGE MASTER TO更改副本用于连接到复制源服务器、读取源的二进制日志以及读取副本的中继日志的参数。它还更新复制元数据存储库的内容（请参见?第 16.2.4 节“中继日志和复制元数据存储库”）。CHANGE MASTER TO需要?SUPER特权。

STOP SLAVE在 MySQL 5.7.4 之前，必须在发出此语句之前?停止复制线程（如有必要）。在 MySQL 5.7.4 及更高版本中，您可以CHANGE MASTER TO在运行的副本上发出语句，而无需执行此操作，具体取决于复制 SQL 线程和复制 I/O 线程的状态。本节稍后提供管理此类使用的规则。

当使用多线程副本（换句话说?slave_parallel_workers大于 0）时，停止副本可能会导致 从中继日志执行的事务序列中出现“间隙”，无论副本是有意停止还是其他原因。当存在这种差距时，发行就会CHANGE MASTER TO?失败。在这种情况下的解决方案是发出?START SLAVE UNTIL SQL_AFTER_MTS_GAPS确保弥补差距的问题。

可选子句使您能够指定该语句适用于哪个复制通道。提供子句将语句应用于?特定的复制通道，并用于添加新通道或修改现有通道。例如，要添加一个名为channel2的新通道：?FOR CHANNEL?channelFOR CHANNEL?channelCHANGE MASTER TO

CHANGE MASTER TO MASTER_HOST=host1, MASTER_PORT=3002 FOR CHANNEL 'channel2'

如果未指定子句且不存在额外通道，则该语句适用于默认通道。

使用多个复制通道时，如果CHANGE MASTER TO语句未使用子句命名通道?，则会发生错误。有关更多信息 ，请参见第 16.2.2 节 “复制通道” 。FOR CHANNEL?channel

未指定的选项保留其值，除非以下讨论中指出。因此，在大多数情况下，无需指定不更改的选项。例如，如果连接到复制源服务器的密码已更改，请发出以下语句以告知副本新密码：

CHANGE MASTER TO MASTER_PASSWORD='new3cret';

MASTER_HOST、MASTER_USER、?MASTER_PASSWORD、 并向?MASTER_PORT副本提供有关如何连接到其复制源服务器的信息：

设置MASTER_SSL=1复制连接，然后不设置其他?选项对应于?客户端的设置，如?加密连接的命令选项中所述。使用 时?，仅当可以建立加密连接时，连接尝试才会成功。复制连接不会回退到未加密的连接，因此没有与?复制设置相对应的设置。如果设置，则对应于?。?MASTER_SSL_xxx--ssl-mode=REQUIREDMASTER_SSL=1--ssl-mode=PREFERREDMASTER_SSL=0--ssl-mode=DISABLED

选项?和选项指定副本如何使用加密和密码来保护复制连接。即使在不支持 SSL 的情况下编译的副本上，也可以更改这些选项。它们会保存到源元数据存储库，但如果副本未启用 SSL 支持，则会被忽略。和?选项执行的功能与?加密连接的命令选项中描述的?和?客户端选项 相同。两组选项的对应关系以及?和的使用MASTER_SSL_xxxMASTER_TLS_VERSIONMASTER_SSL_xxxMASTER_TLS_VERSION--ssl-xxx--tls-versionMASTER_SSL_xxxMASTER_TLS_VERSION设置安全连接的选项，在?第 16.3.8 节 “设置复制以使用加密连接”中进行了解释。

、和 选项控制副本如何识别与源的连接已丢失MASTER_HEARTBEAT_PERIOD并?尝试重新连接。?MASTER_CONNECT_RETRYMASTER_RETRY_COUNT

MASTER_DELAY指定副本必须落后于源多少秒。interval从源接收到的事件直到在源上执行后至少几秒后才会执行 。默认值为 0。如果 不是 0 到 2?31interval?-1范围内的非负整数，则会发生错误。有关更多信息，请参见第 16.3.10 节 “延迟复制”。

从 MySQL 5.7 开始，当复制 SQL 线程停止时，可以在正在运行的副本上执行使用?CHANGE MASTER TO该选项的语句。MASTER_DELAY

MASTER_BIND用于具有多个网络接口的副本，并确定选择副本的哪个网络接口来连接到源。

使用此选项配置的地址（如果有）可以在Master_Bind输出的列 中看到SHOW SLAVE STATUS。如果您使用源元数据存储库（服务器以 开头）的表?master_info_repository=TABLE，则该值也可以视为表Master_bind?的列mysql.slave_master_info。

NDB Cluster 还支持将副本绑定到特定网络接口的功能。

MASTER_LOG_FILE和?MASTER_LOG_POS是复制 I/O 线程下次启动时应开始从源读取的坐标。?RELAY_LOG_FILE和?RELAY_LOG_POS是复制 SQL 线程下次启动时应开始从中继日志读取的坐标。如果您指定了这些选项中的任何一个，则无法指定MASTER_AUTO_POSITION = 1（本节稍后将介绍）。如果两者均未?MASTER_LOG_FILE指定?MASTER_LOG_POS，则副本将使用之前复制 SQL 线程的最后一个坐标CHANGE MASTER TO发出。这可以确保复制不会中断，即使复制 SQL 线程比复制 I/O 线程晚，当您只想更改（例如要使用的密码）时也是如此。

从 MySQL 5.7 开始，当复制 SQL 线程停止时，可以在正在运行的副本上执行CHANGE MASTER TO使用RELAY_LOG_FILE、 或这两个选项的语句。RELAY_LOG_POS在 MySQL 5.7.4 之前，CHANGE MASTER TO删除所有中继日志文件并启动新的中继日志文件，除非您指定RELAY_LOG_FILE或?RELAY_LOG_POS。在这种情况下，中继日志文件将被保留；全局relay_log_purge?变量静默设置为 0。在 MySQL 5.7.4 及更高版本中，如果复制 SQL 线程和复制 I/O 线程中至少之一正在运行，则会保留中继日志。如果两个线程都停止，则所有中继日志文件都将被删除，除非至少有以下之一RELAY_LOG_FILE：?RELAY_LOG_POS已指定。对于组复制应用程序通道 (?group_replication_applier)，它只有一个 SQL 线程而没有 I/O 线程，如果 SQL 线程停止，就会出现这种情况，但对于该通道，您不能使用 和?RELAY_LOG_FILE选项?RELAY_LOG_POS。

RELAY_LOG_FILE可以使用绝对路径或相对路径，并使用与 相同的基本名称?MASTER_LOG_FILE。（错误#12190）

当MASTER_AUTO_POSITION = 1与 一起使用?CHANGE MASTER TO时，副本尝试使用基于 GTID 的复制的自动定位功能（而不是基于二进制日志文件的位置）连接到源。CHANGE MASTER TO从 MySQL 5.7 开始，仅当复制 SQL 线程和复制 I/O 线程都停止时才能使用此选项 。副本和源都必须启用 GTID（GTID_MODE=ON，?ON_PERMISSIVE,或?OFF_PERMISSIVE在副本和?GTID_MODE=ON源上）。?MASTER_LOG_FILE、?MASTER_LOG_POS、?RELAY_LOG_FILE、 和?RELAY_LOG_POS不能与 一起指定MASTER_AUTO_POSITION = 1。如果副本上启用了多源复制，则需要设置MASTER_AUTO_POSITION = 1每个适用的复制通道的选项。

通过MASTER_AUTO_POSITION = 1设置，在初始连接握手中，副本会发送一个 GTID 集，其中包含它已接收、提交或两者的事务。源通过发送其二进制日志中记录的所有事务进行响应，这些事务的 GTID 不包含在副本发送的 GTID 集中。此交换确保源仅发送具有副本尚未记录或提交的 GTID 的事务。如果副本从多个源接收事务（如钻石拓扑的情况），自动跳过功能可确保事务不会应用两次。有关如何计算副本发送的 GTID 集的详细信息，请参阅?第 16.1.3.3 节 “GTID 自动定位”。

如果源应发送的任何事务已从源的二进制日志中清除，或gtid_purged?通过其他方法添加到系统变量中的 GTID 集中，则源会将错误发送?ER_MASTER_HAS_PURGED_REQUIRED_GTIDS?到副本，并且复制不会启动。此外，如果在事务交换期间发现副本已记录或提交了 GTID 中源 UUID 的事务，但源本身尚未提交这些事务，则源会将错误发送到?ER_SLAVE_HAS_MORE_GTIDS_THAN_MASTER?副本，并且复制不会启动。有关如何处理这些情况的信息，请参阅?第 16.1.3.3 节“GTID 自动定位”。

IGNORE_SERVER_IDS采用 0 个或多个服务器 ID 的逗号分隔列表。源自相应服务器的事件将被忽略，但日志轮转和删除事件除外，这些事件仍记录在中继日志中。

在循环复制中，原始服务器通常充当其自身事件的终结者，因此它们不会被多次应用。因此，当删除循环中的一台服务器时，此选项在循环复制中非常有用。假设您有一个包含 4 台服务器的循环复制设置，服务器 ID 为 1、2、3 和 4，并且服务器 3 发生故障。通过启动从服务器 2 到服务器 4 的复制来弥补差距时，您可以在服务器 4 上发出的语句中包含IGNORE_SERVER_IDS = (3)该CHANGE MASTER TO语句，以告诉它使用服务器 2 而不是服务器 3 作为源。这样做会导致它忽略而不是传播源自不再使用的服务器的任何语句。

如果CHANGE MASTER TO发出的语句没有任何IGNORE_SERVER_IDS?选项，则保留任何现有列表。要清除被忽略的服务器列表，需要使用带有空列表的选项：

CHANGE MASTER TO IGNORE_SERVER_IDS = ();

MySQL 5.7.5 之前，?RESET SLAVE ALL对服务器 ID 列表没有影响。在 MySQL 5.7.5 及更高版本中，RESET SLAVE ALL清除?IGNORE_SERVER_IDS.?（错误#18816897）

如果IGNORE_SERVER_IDS包含服务器自己的 ID 并且服务器是在?--replicate-same-server-id启用该选项的情况下启动的，则会产生错误。

源元数据存储库和 的输出?SHOW SLAVE STATUS提供当前被忽略的服务器列表。有关更多信息，请参阅第 16.2.4.2 节“复制元数据存储库”和?第 13.7.5.34 节“SHOW SLAVE STATUS 语句”。

调用会导致、?、?和?CHANGE MASTER TO的先前值以及执行前有关副本状态的其他信息写入错误日志。?MASTER_HOSTMASTER_PORTMASTER_LOG_FILEMASTER_LOG_POS

CHANGE MASTER TO导致正在进行的事务的隐式提交。请参见第 13.3.3 节“导致隐式提交的语句”。

在 MySQL 5.7.4 及更高版本中，删除了在发出任何语句?STOP SLAVE之前 （以及之后）?执行的严格要求 。的行为不取决于副本是否停止，而是取决于（在 MySQL 5.7.4 及更高版本中）复制 SQL 线程和复制 I/O 线程的状态；现在停止或运行这些线程中的哪一个决定了在给定时间点可以或不能与语句一起使用的选项。做出此决定的规则如下：?CHANGE MASTER TOSTART SLAVECHANGE MASTER TOCHANGE MASTER TO

您可以使用 检查复制 SQL 线程和复制 I/O 线程的当前状态SHOW SLAVE STATUS。请注意，组复制应用程序通道 (?group_replication_applier) 没有 I/O 线程，只有 SQL 线程。

有关更多信息，请参阅?第 16.3.7 节 “故障转移期间切换源”。

CHANGE MASTER TO?如果您使用基于语句的复制和临时表，则语句后面的语句?可能会STOP SLAVE在副本上留下临时表。ER_WARN_OPEN_TEMP_TABLES_MUST_BE_ZERO从 MySQL 5.7 开始，每当发生这种情况时都会发出警告 ( )。在这种情况下，您可以通过在执行此类语句之前确保?Slave_open_temp_tables系统状态变量的值等于 0 来 避免这种情况CHANGE MASTER TO。

CHANGE MASTER TO当您拥有复制源服务器的快照并记录了与快照时间相对应的源二进制日志坐标时，这对于设置副本非常有用。将快照加载到副本以将其与源同步后，您可以在副本上运行以指定副本应开始读取源二进制日志的坐标。?CHANGE MASTER TO MASTER_LOG_FILE='log_name', MASTER_LOG_POS=log_pos

以下示例更改副本使用的复制源服务器，并建立副本开始读取的源二进制日志坐标。当您想要设置副本来复制源时，可以使用此选项：

CHANGE MASTER TO
  MASTER_HOST='source2.example.com',
  MASTER_USER='replication',
  MASTER_PASSWORD='password',
  MASTER_PORT=3306,
  MASTER_LOG_FILE='source2-bin.001',
  MASTER_LOG_POS=4,
  MASTER_CONNECT_RETRY=10;

下一个示例显示了不太常用的操作。当副本具有中继日志文件且您因某种原因希望其再次执行时使用它。为此，源不需要可达。您只需要使用?CHANGE MASTER TO并启动 SQL 线程 (?START SLAVE SQL_THREAD)：

CHANGE MASTER TO
  RELAY_LOG_FILE='replica-relay-bin.006',
  RELAY_LOG_POS=4025;

下表显示了字符串值选项的最大允许长度。

CHANGE REPLICATION FILTER filter[, filter][, ...]

filter: {
    REPLICATE_DO_DB = (db_list)
  | REPLICATE_IGNORE_DB = (db_list)
  | REPLICATE_DO_TABLE = (tbl_list)
  | REPLICATE_IGNORE_TABLE = (tbl_list)
  | REPLICATE_WILD_DO_TABLE = (wild_tbl_list)
  | REPLICATE_WILD_IGNORE_TABLE = (wild_tbl_list)
  | REPLICATE_REWRITE_DB = (db_pair_list)
}

db_list:
    db_name[, db_name][, ...]

tbl_list:
    db_name.table_name[, db_table_name][, ...]
wild_tbl_list:
    'db_pattern.table_pattern'[, 'db_pattern.table_pattern'][, ...]

db_pair_list:
    (db_pair)[, (db_pair)][, ...]

db_pair:
    from_db, to_db

CHANGE REPLICATION FILTER在副本上设置一个或多个复制过滤规则，其方式与使用复制过滤选项（例如?或 ） 启动副本mysqld相同。使用此语句设置的过滤器与使用服务器选项设置的过滤器在两个关键方面有所不同：?--replicate-do-db--replicate-wild-ignore-table

CHANGE REPLICATION FILTER?需要SUPER特权。

以下列表显示了这些选项以及它们与服务器选项?CHANGE REPLICATION FILTER的关系 ：--replicate-*

REPLICATE_DO_DB和 过滤器?的精确效果REPLICATE_IGNORE_DB取决于基于语句的复制还是基于行的复制有效。有关更多信息，请参阅第 16.2.5 节“服务器如何评估复制过滤规则”。

可以通过用逗号分隔规则来在单个语句中创建多个复制过滤规则?CHANGE REPLICATION FILTER，如下所示：

CHANGE REPLICATION FILTER
    REPLICATE_DO_DB = (d1), REPLICATE_IGNORE_DB = (d2);

发出刚才显示的语句相当于使用 options 启动副本mysqld。?--replicate-do-db=d1?--replicate-ignore-db=d2

如果多次指定相同的过滤规则，则仅?实际使用最后一个过滤规则。例如，此处显示的两个语句具有完全相同的效果，因为REPLICATE_DO_DB?第一个语句中的第一个规则被忽略：

CHANGE REPLICATION FILTER
    REPLICATE_DO_DB = (db1, db2), REPLICATE_DO_DB = (db3, db4);

CHANGE REPLICATION FILTER
    REPLICATE_DO_DB = (db3,db4);

不包含任何特殊字符的表和数据库的名称不需要加引号。REPLICATION_WILD_TABLE与一起?使用的值?REPLICATION_WILD_IGNORE_TABLE是字符串表达式，可能包含（特殊）通配符，因此必须用引号引起来。以下示例语句显示了这一点：

CHANGE REPLICATION FILTER
    REPLICATE_WILD_DO_TABLE = ('db1.old%');

CHANGE REPLICATION FILTER
    REPLICATE_WILD_IGNORE_TABLE = ('db1.new%', 'db2.new%');

与一起?使用的值REPLICATE_REWRITE_DB?表示数据库名称对；每个这样的值都必须括在括号中。以下语句将?源 数据库上发生的语句重写为副本数据库上的语句：?db1db2

CHANGE REPLICATION FILTER REPLICATE_REWRITE_DB = ((db1, db2));

刚刚显示的语句包含两组括号，一组括着一对数据库名称，另一组括着整个列表。这在以下示例中可能更容易看出，该示例创建了两条?rewrite-db规则，一条将数据库重写?dbA为dbB，一条将数据库重写dbC为?dbD：

CHANGE REPLICATION FILTER
  REPLICATE_REWRITE_DB = ((dbA, dbB), (dbC, dbD));

该语句使任何现有的复制过滤规则保持不变；要取消设置给定类型的所有过滤器，请将过滤器的值设置为显式空列表，如此例所示，这将删除所有现有的?REPLICATE_DO_DB和?REPLICATE_IGNORE_DB规则：

CHANGE REPLICATION FILTER
    REPLICATE_DO_DB = (), REPLICATE_IGNORE_DB = ();

以这种方式将过滤器设置为空会删除所有现有规则，不会创建任何新规则，并且不会使用--replicate-*?命令行或配置文件中的选项恢复 mysqld 启动时设置的任何规则。

REPLICATE_WILD_DO_TABLE?与一起?使用的值REPLICATE_WILD_IGNORE_TABLE必须采用以下格式?。在 MySQL 5.7.5 之前，这并没有严格执行，尽管在这些选项中使用不合格的值可能会导致错误的结果（Bug #18095449）。?db_name.tbl_name

有关更多信息，请参见第 16.2.5 节 “服务器如何评估复制过滤规则”。

RESET SLAVE [ALL] [channel_option]

channel_option:
    FOR CHANNEL channel

<span style="background-color:#ffffff"><span style="color:#555555"><span style="background-color:#f8f8f8"><span style="color:#000000"><code class="language-sql"><span style="color:#0077aa">SET</span> <span style="color:#0077aa">GLOBAL</span> sql_slave_skip_counter <span style="color:#a67f59">=</span> <em>N</em></code></span></span></span></span>

START SLAVE [thread_types] [until_option] [connection_options] [channel_option]

thread_types:
    [thread_type [, thread_type] ... ]

thread_type:
    IO_THREAD | SQL_THREAD

until_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']


channel_option:
    FOR CHANNEL channel

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 UNTIL SQL_AFTER_MTS_GAPS;
SET @@GLOBAL.slave_parallel_workers = 0;
START SLAVE SQL_THREAD;

STOP SLAVE [thread_types] [channel_option]

thread_types:
    [thread_type [, thread_type] ... ]

thread_type: IO_THREAD | SQL_THREAD

channel_option:
    FOR CHANNEL channel