MySQL :: MySQL 8.4 Reference Manual :: 15.7.5 CLONE Statement

version 8.4

8.0 current

8.0 Japanese

MySQL 8.4 Reference Manual / ... / CLONE Statement

15.7.5 克隆语句

CLONE clone_action

clone_action: {
    LOCAL DATA DIRECTORY [=] 'clone_dir';
  | INSTANCE FROM 'user'@'host':port
    IDENTIFIED BY 'password'
    [DATA DIRECTORY [=] 'clone_dir']
    [REQUIRE [NO] SSL]
}

CLONE 语句用于本地或从远程 MySQL 服务器实例克隆数据。要使用CLONE 语法，必须安装克隆插件。见第7.6.7节，“The Clone Plugin”。

CLONE LOCAL DATA DIRECTORY 语法从本地 MySQL 数据目录克隆数据到同一服务器或节点上运行的 MySQL 服务器实例的目录。'clone_dir' 目录是要克隆到的本地目录的全路径。绝对路径是必需的。指定的目录不能存在，但指定的路径必须存在。MySQL 服务器需要创建指定目录所需的写权限。更多信息见第7.6.7.2节，“本地克隆数据”。

CLONE INSTANCE 语法从远程 MySQL 服务器实例（捐赠者）克隆数据并将其转移到克隆操作开始的 MySQL 实例（受益者）。

user 是捐赠 MySQL 服务器实例上的克隆用户。
host 是捐赠 MySQL 服务器实例的hostname 地址。IPv6 地址格式不支持，可以使用别名代替。IPv4 地址可以直接使用。
port 是捐赠 MySQL 服务器实例的port 号码。（由mysqlx_port 指定的 X 协议端口不支持。通过 MySQL 路由器连接捐赠 MySQL 服务器实例也不是支持的。）
IDENTIFIED BY 'password' 指定捐赠 MySQL 服务器实例上的克隆用户密码。
DATA DIRECTORY [=] 'clone_dir' 是可选子句，用于指定接收端的数据目录。使用这个选项如果不想删除接收端数据目录中的现有数据。需要提供绝对路径，且该目录不能存在。MySQL 服务器必须拥有创建目录所需的写权限。

当没有使用可选的 DATA DIRECTORY [=] 'clone_dir' 子句时，克隆操作将删除接收端数据目录中的现有数据，替换为克隆数据，并自动重启服务器。
[REQUIRE [NO] SSL] 明确指定是否使用加密连接传输克隆数据，否则返回错误。如果不指定SSL子句，clone尝试建立加密连接，如果失败则降级到非安全连接。无论是否指定该子句，clone都需要在克隆加密数据时使用安全连接。更多信息，请参见配置克隆加密连接。

关于从远程 MySQL 服务器实例中克隆数据的更多信息，请参见第7.6.7.3节，“克隆远程数据”。

PREV HOME UP NEXT