데브러너 (DevRunner)

15.7.5 CLONE Statement

1CLONE clone_action
2
3clone_action: {
4    LOCAL DATA DIRECTORY [=] 'clone_dir';
5  | INSTANCE FROM 'user'@'host':port
6    IDENTIFIED BY 'password'
7    [DATA DIRECTORY [=] 'clone_dir']
8    [REQUIRE [NO] SSL]
9}

CLONE statement는 로컬 또는 원격 MySQL 서버 인스턴스로부터 데이터를 클론하는 데 사용됩니다. CLONE 구문을 사용하려면 클론 플러그인이 설치되어 있어야 합니다. Section 7.6.6, “The Clone Plugin”을 참조하십시오.

CLONE LOCAL DATA DIRECTORY 구문은 로컬 MySQL 데이터 디렉터리에서 MySQL 서버 인스턴스가 실행되는 동일한 서버 또는 노드의 디렉터리로 데이터를 클론합니다. 'clone_dir' 디렉터리는 데이터가 클론되는 로컬 디렉터리의 전체 경로입니다. 절대 경로가 필요합니다. 지정된 디렉터리는 존재해서는 안 되지만, 지정된 경로는 존재하는 경로여야 합니다. MySQL 서버는 지정된 디렉터리를 생성하기 위한 필요한 쓰기 권한을 보유해야 합니다. 자세한 내용은 Section 7.6.6.2, “Cloning Data Locally”를 참조하십시오.

CLONE INSTANCE 구문은 원격 MySQL 서버 인스턴스(donor)로부터 데이터를 클론하여, 클론 작업이 시작된 MySQL 인스턴스(recipient)로 전송합니다.

user는 donor MySQL 서버 인스턴스의 클론 사용자입니다.
host는 donor MySQL 서버 인스턴스의 hostname 주소입니다. Internet Protocol version 6 (IPv6) 주소 형식은 지원되지 않습니다. 대신 IPv6 주소에 대한 별칭을 사용할 수 있습니다. IPv4 주소는 그대로 사용할 수 있습니다.
port는 donor MySQL 서버 인스턴스의 port 번호입니다. (mysqlx_port에 의해 지정되는 X Protocol 포트는 지원되지 않습니다. MySQL Router를 통해 donor MySQL 서버 인스턴스에 연결하는 것도 지원되지 않습니다.)
IDENTIFIED BY 'password'는 donor MySQL 서버 인스턴스의 클론 사용자 패스워드를 지정합니다.
DATA DIRECTORY [=] 'clone_dir'는 recipient에서 클론하려는 데이터의 디렉터리를 지정하는 데 사용되는 선택적 절입니다. recipient 데이터 디렉터리의 기존 데이터를 제거하고 싶지 않은 경우 이 옵션을 사용하십시오. 절대 경로가 필요하며, 디렉터리는 존재해서는 안 됩니다. MySQL 서버는 해당 디렉터리를 생성하기 위한 필요한 쓰기 권한을 보유해야 합니다.

선택적 DATA DIRECTORY [=] 'clone_dir' 절을 사용하지 않으면, 클론 작업은 recipient 데이터 디렉터리의 기존 데이터를 제거하고, 이를 클론된 데이터로 대체하며, 이후 자동으로 서버를 재시작합니다.

[REQUIRE [NO] SSL]은 네트워크를 통해 클론된 데이터를 전송할 때 암호화된 연결을 사용할지 여부를 명시적으로 지정합니다. 명시적으로 지정한 조건을 만족할 수 없는 경우 에러가 반환됩니다. SSL 절이 지정되지 않으면, 클론은 기본적으로 암호화된 연결을 설정하려 시도하고, 보안 연결 시도가 실패하면 보안되지 않은 연결로 폴백합니다. 이 절이 지정되었는지 여부와 상관없이, 암호화된 데이터를 클론할 때는 보안 연결이 필요합니다. 자세한 내용은 Configuring an Encrypted Connection for Cloning을 참조하십시오.

원격 MySQL 서버 인스턴스로부터 데이터를 클론하는 추가 정보는 Section 7.6.6.3, “Cloning Remote Data”를 참조하십시오.