### 13.7.5 CLONE 语句

[](<>)

```
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.html)语句用于在本地或从远程 MySQL 服务器实例克隆数据。使用[`克隆`](clone.html)语法，必须安装克隆插件。看[第 5.6.7 节，“克隆插件”](clone-plugin.html).

[`克隆本地数据目录`](clone.html)语法将数据从本地 MySQL 数据目录克隆到运行 MySQL 服务器实例的同一服务器或节点上的目录。这`“克隆目录”`directory 是数据克隆到的本地目录的完整路径。需要绝对路径。指定的目录不能存在，但指定的路径必须是存在的路径。MySQL 服务器需要必要的写入权限才能创建指定的目录。有关详细信息，请参阅[第 5.6.7.2 节，“本地克隆数据”](clone-plugin-local.html).

[`克隆实例`](clone.html)语法从远程 MySQL 服务器实例（捐助者）克隆数据并将其传输到启动克隆操作的 MySQL 实例（接收者）。

-   `*`用户`*`是捐赠者 MySQL 服务器实例上的克隆用户。

-   `*`主持人`*`是个[`主机名`](server-system-variables.html#sysvar_hostname)捐助者 MySQL 服务器实例的地址。不支持 Internet 协议版本 6 (IPv6) 地址格式。可以改为使用 IPv6 地址的别名。IPv4 地址可以按原样使用。

-   `*`港口`*`是个[`港口`](server-system-variables.html#sysvar_port)捐赠者 MySQL 服务器实例的数量。（由指定的 X 协议端口[`mysqlx_port`](x-plugin-options-system-variables.html#sysvar_mysqlx_port)不支持。也不支持通过 MySQL Router 连接到供体 MySQL 服务器实例。）

-   `由'*标识`密码`*'`指定捐赠者 MySQL 服务器实例上的克隆用户的密码。

-   `数据目录 [=] '*`克隆目录`*'`是一个可选子句，用于指定要克隆的数据的收件人目录。如果您不想删除收件人数据目录中的现有数据，请使用此选项。需要绝对路径，并且该目录不能存在。MySQL 服务器必须具有创建目录所需的写入权限。

    当可选`数据目录 [=] '*`克隆目录`*'`如果不使用子句，则克隆操作会删除收件人数据目录中的现有数据，将其替换为克隆的数据，然后自动重新启动服务器。

-   `[需要 [否] SSL]`明确指定通过网络传输克隆数据时是否使用加密连接。如果无法满足显式规范，则返回错误。如果未指定 SSL 子句，则克隆默认尝试建立加密连接，如果安全连接尝试失败，则回退到不安全的连接。无论是否指定此子句，克隆加密数据时都需要安全连接。有关详细信息，请参阅[为克隆配置加密连接](clone-plugin-remote.html#clone-plugin-remote-ssl).

    有关从远程 MySQL 服务器实例克隆数据的更多信息，请参阅[第 5.6.7.3 节，“克隆远程数据”](clone-plugin-remote.html).
