MySQL :: MySQL 9.0 参考手册 :: 19.1.2.8 将副本添加到复制环境

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / 将副本添加到复制环境

19.1.2.8 将副本添加到复制环境

您可以在不停止源服务器的情况下将另一个副本添加到现有的复制配置中。为此，您可以通过复制现有副本的数据目录来设置新的副本，并为新副本提供不同的服务器 ID（用户指定）和服务器 UUID（在启动时生成）。

注意

如果要复制以创建新副本的复制源服务器或现有副本具有任何计划事件，请确保在启动新副本之前禁用这些事件。如果在源服务器上已经运行过的事件在新副本上运行，则重复操作会导致错误。事件调度程序由event_scheduler 系统变量控制，默认值为 ON，因此原始服务器上处于活动状态的事件在默认情况下会在新副本启动时运行。要阻止所有事件在新副本上运行，请将event_scheduler 系统变量在新副本上设置为 OFF 或 DISABLED。或者，您可以使用ALTER EVENT 语句将各个事件设置为 DISABLE 或 DISABLE ON REPLICA，以防止它们在新副本上运行。您可以使用SHOW 语句或 Information Schema EVENTS 表列出服务器上的事件。有关更多信息，请参见第 19.5.1.16 节，“被调用功能的复制”.

作为以这种方式创建新副本的替代方法，MySQL Server 的克隆插件可用于将所有数据和复制设置从现有副本传输到克隆副本。有关使用此方法的说明，请参见第 7.6.7.7 节，“复制的克隆”.

要复制现有副本而不进行克隆，请执行以下步骤

停止现有副本并记录副本状态信息，特别是源二进制日志文件和中继日志文件位置。您可以查看性能模式复制表中的副本状态（参见第 29.12.11 节，“性能模式复制表”），或者通过发出SHOW REPLICA STATUS，如下所示
```
mysql> STOP REPLICA;
mysql> SHOW REPLICA STATUS\G
```
关闭现有副本
```
$> mysqladmin shutdown
```
将数据目录从现有副本复制到新副本，包括日志文件和中继日志文件。您可以通过使用 tar 或 WinZip 创建存档，或通过使用 cp 或 rsync 等工具执行直接复制来实现。
重要
- 在复制之前，请验证与现有副本相关的所有文件是否实际存储在数据目录中。例如，InnoDB 系统表空间、撤消表空间和重做日志可能存储在备用位置。 InnoDB 表空间文件和每个表文件表空间可能已在其他目录中创建。副本的二进制日志和中继日志可能位于数据目录之外的自己的目录中。检查为现有副本设置的系统变量，并查找已指定的任何备用路径。如果您找到任何路径，请也将这些目录复制过来。
- 在复制过程中，如果文件已用于复制元数据存储库（请参阅第 19.2.4 节，“中继日志和复制元数据存储库”），请确保您还将这些文件从现有副本复制到新副本。如果已使用表作为存储库（默认情况下，这些表位于数据目录中。
- 复制完成后，从新副本上的数据目录副本中删除 auto.cnf 文件，以便新副本以不同的生成的服务器 UUID 启动。服务器 UUID 必须是唯一的。
在添加新副本时遇到的常见问题是，新副本失败并出现一系列警告和错误消息，如下所示
```
071118 16:44:10 [Warning] Neither --relay-log nor --relay-log-index were used; so
replication may break when this MySQL server acts as a replica and has his hostname
changed!! Please use '--relay-log=new_replica_hostname-relay-bin' to avoid this problem.
071118 16:44:10 [ERROR] Failed to open the relay log './old_replica_hostname-relay-bin.003525'
(relay_log_pos 22940879)
071118 16:44:10 [ERROR] Could not find target log during relay log initialization
071118 16:44:10 [ERROR] Failed to initialize the master info structure
```
如果未指定 relay_log 系统变量，则可能出现这种情况，因为中继日志文件在其文件名中包含主机名。如果未使用 relay_log_index 系统变量，中继日志索引文件也是如此。有关这些变量的更多信息，请参阅第 19.1.6 节，“复制和二进制日志选项和变量”。
为避免此问题，请在新副本上使用与现有副本上使用的 relay_log 相同的值。如果未在现有副本上显式设置此选项，请使用 existing_replica_hostname-relay-bin。如果这不可行，请将现有副本的中继日志索引文件复制到新副本，并将新副本上的 relay_log_index 系统变量设置为与现有副本上使用的值匹配。如果未在现有副本上显式设置此选项，请使用 existing_replica_hostname-relay-bin.index。或者，如果您已尝试在完成本节中的其余步骤后启动新副本，并且遇到了类似于前面描述的错误，请执行以下步骤
1. 如果您尚未这样做，请在新副本上发出 STOP REPLICA。
  如果您已再次启动现有副本，请在现有副本上也发出 STOP REPLICA。
2. 将现有副本的中继日志索引文件的内容复制到新副本的中继日志索引文件中，确保覆盖文件中已有的任何内容。
3. 继续本节中的其余步骤。
复制完成后，重新启动现有副本。
在新副本上，编辑配置，并为新副本提供唯一的服务器 ID（使用 server_id 系统变量），该 ID 不被源或任何现有副本使用。
启动新副本服务器，确保复制尚未开始，方法是指定 --skip-replica-start。使用 Performance Schema 复制表或发出 SHOW REPLICA STATUS 以确认新副本在与现有副本进行比较时是否具有正确的设置。还要显示服务器 ID 和服务器 UUID，并验证这些 ID 是否正确且对新副本而言是唯一的。
通过发出 START REPLICA 语句来启动副本线程。新副本现在使用其连接元数据存储库中的信息来启动复制过程。

PREV HOME UP NEXT