# 이진수 로그(binlog) 복제 구성, 시작 및 중지
다음 저장 프로시저는 트랜잭션이 외부 데이터베이스에서 RDS for MySQL로 또는 RDS for MySQL에서 외부 데이터베이스로 복제되는 방식을 제어합니다.
`caching_sha2_password`로 구성된 복제 사용자로 복제를 관리하기 위해 이러한 저장 프로시저를 사용하는 경우, `SOURCE_SSL=1`을 지정하여 TLS를 구성해야 합니다. `caching_sha2_password`는 RDS for MySQL 8.4의 기본 인증 플러그인입니다. 자세한 내용은 [SSL/TLS를 사용하여 암호화](mysql-ssl-connections.md) 섹션을 참조하세요.
읽기 전용 복제본 구성, 사용 및 관리에 대한 자세한 내용은 [MySQL 읽기 전용 복제본 작업](USER_MySQL.Replication.ReadReplicas.md) 섹션을 참조하세요.
**Topics**
+ [vmysql.rds\_next\_master\_log(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_next_master_log)
+ [mysql.rds\_next\_source\_log(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_next_source_log)
+ [mysql.rds\_reset\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_reset_external_master)
+ [mysql.rds\_reset\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_reset_external_source)
+ [mysql.rds\_set\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master)
+ [mysql.rds\_set\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source)
+ [mysql.rds\_set\_external\_master\_with\_auto\_position(RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master_with_auto_position)
+ [mysql.rds\_set\_external\_source\_with\_auto\_position(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source_with_auto_position)
+ [mysql.rds\_set\_external\_master\_with\_delay(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master_with_delay)
+ [mysql.rds\_set\_external\_source\_with\_delay(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source_with_delay)
+ [mysql.rds\_set\_external\_source\_gtid\_purged](#mysql_rds_set_external_source_gtid_purged)
+ [mysql.rds\_set\_master\_auto\_position(RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_master_auto_position)
+ [mysql.rds\_set\_source\_auto\_position(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_source_auto_position)
+ [mysql.rds\_set\_source\_delay](#mysql_rds_set_source_delay)
+ [mysql.rds\_skip\_repl\_error](#mysql_rds_skip_repl_error)
+ [mysql.rds\_start\_replication](#mysql_rds_start_replication)
+ [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until)
+ [mysql.rds\_stop\_replication](#mysql_rds_stop_replication)
## vmysql.rds\_next\_master\_log(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)
소스 데이터베이스 인스턴스 로그 위치를 소스 데이터베이스 인스턴스에서 다음 이진 로그의 시작으로 변경합니다. 읽기 전용 복제본에 대한 복제 I/O 오류 1236을 수신 중일 경우에만 이 프로시저를 사용하십시오.
### 구문
```
CALL mysql.rds_next_master_log(
{{curr_master_log}}
);
```
### 파라미터
{{curr\_master\_log}}
현재 마스터 로그 파일의 인덱스입니다. 예를 들어, 현재 파일의 이름이 `mysql-bin-changelog.012345`이면 인덱스는 12345입니다. 현재 마스터 로그 파일 이름을 확인하려면 `SHOW REPLICA STATUS` 명령을 실행하고 `Master_Log_File` 필드를 봅니다.
### 사용 노트
마스터 사용자는 `mysql.rds_next_master_log` 프로시저를 실행해야 합니다.
**주의**
복제 원본인 다중 AZ DB 인스턴스의 장애 조치 후 복제가 실패하고 `mysql.rds_next_master_log`의 `Last_IO_Errno`필드에서 I/O 오류 1236을 보고하는 경우에만 `SHOW REPLICA STATUS`를 호출합니다.
장애 조치 이벤트가 발생하기 전에 원본 인스턴스의 트랜잭션이 디스크의 바이너리 로그에 기록되지 않은 경우 `mysql.rds_next_master_log`를 호출하면 읽기 전용 복제본에서 데이터가 손실될 수 있습니다. 소스 인스턴스 파라미터 `sync_binlog` 및 `innodb_support_xa`를 `1`로 설정하여 이런 상황이 발생할 가능성을 줄일 수 있으나, 성능이 저하될 수 있습니다. 자세한 내용은 [MySQL 읽기 전용 복제본의 문제 해결](USER_ReadRepl.Troubleshooting.md) 섹션을 참조하세요.
### 예제
RDS for MySQL 읽기 전용 복제본에서 복제가 실패한다고 가정해 보겠습니다. 읽기 전용 복제본에서 `SHOW REPLICA STATUS\G`를 실행하면 다음 결과가 반환됩니다.
```
*************************** 1. row ***************************
Replica_IO_State:
Source_Host: myhost.XXXXXXXXXXXXXXX.rr-rrrr-1.rds.amazonaws.com
Source_User: MasterUser
Source_Port: 3306
Connect_Retry: 10
Source_Log_File: mysql-bin-changelog.012345
Read_Source_Log_Pos: 1219393
Relay_Log_File: relaylog.012340
Relay_Log_Pos: 30223388
Relay_Source_Log_File: mysql-bin-changelog.012345
Replica_IO_Running: No
Replica_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Source_Log_Pos: 30223232
Relay_Log_Space: 5248928866
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Source_SSL_Allowed: No
Source_SSL_CA_File:
Source_SSL_CA_Path:
Source_SSL_Cert:
Source_SSL_Cipher:
Source_SSL_Key:
Seconds_Behind_Master: NULL
Source_SSL_Verify_Server_Cert: No
Last_IO_Errno: 1236
Last_IO_Error: Got fatal error 1236 from master when reading data from binary log: 'Client requested master to start replication from impossible position; the first event 'mysql-bin-changelog.013406' at 1219393, the last event read from '/rdsdbdata/log/binlog/mysql-bin-changelog.012345' at 4, the last byte read from '/rdsdbdata/log/binlog/mysql-bin-changelog.012345' at 4.'
Last_SQL_Errno: 0
Last_SQL_Error:
Replicate_Ignore_Server_Ids:
Source_Server_Id: 67285976
```
`Last_IO_Errno` 필드가 인스턴스에서 I/O 오류 1236을 수신하고 있음을 보여 줍니다. `Master_Log_File` 필드는 파일 이름이 `mysql-bin-changelog.012345`임을 보여 줍니다. 이는 로그 파일 인덱스가 `12345`임을 의미합니다. 오류를 해결하려면 다음 파라미터와 함께 `mysql.rds_next_master_log`를 호출합니다.
```
CALL mysql.rds_next_master_log(12345);
```
## mysql.rds\_next\_source\_log(RDS for MySQL 메이저 버전 8.4 이상)
소스 데이터베이스 인스턴스 로그 위치를 소스 데이터베이스 인스턴스에서 다음 이진 로그의 시작으로 변경합니다. 읽기 전용 복제본에 대한 복제 I/O 오류 1236을 수신 중일 경우에만 이 프로시저를 사용하십시오.
### 구문
```
CALL mysql.rds_next_source_log(
{{curr_source_log}}
);
```
### 파라미터
{{curr\_source\_log}}
현재 소스 로그 파일의 인덱스입니다. 예를 들어, 현재 파일의 이름이 `mysql-bin-changelog.012345`이면 인덱스는 12345입니다. 현재 소스 로그 파일 이름을 확인하려면 `SHOW REPLICA STATUS` 명령을 실행하고 `Source_Log_File` 필드를 봅니다.
### 사용 노트
관리 사용자는 `mysql.rds_next_source_log` 프로시저를 실행해야 합니다.
**주의**
복제 원본인 다중 AZ DB 인스턴스의 장애 조치 후 복제가 실패하고 `mysql.rds_next_source_log`의 `Last_IO_Errno`필드에서 I/O 오류 1236을 보고하는 경우에만 `SHOW REPLICA STATUS`를 호출합니다.
장애 조치 이벤트가 발생하기 전에 원본 인스턴스의 트랜잭션이 디스크의 바이너리 로그에 기록되지 않은 경우 `mysql.rds_next_source_log`를 호출하면 읽기 전용 복제본에서 데이터가 손실될 수 있습니다. 소스 인스턴스 파라미터 `innodb_support_xa` 및 `sync_binlog`를 `1`로 설정하여 이런 상황이 발생할 가능성을 줄일 수 있으나, 성능이 저하될 수 있습니다. 자세한 내용은 [MySQL 읽기 전용 복제본의 문제 해결](USER_ReadRepl.Troubleshooting.md) 섹션을 참조하세요.
### 예제
RDS for MySQL 읽기 전용 복제본에서 복제가 실패한다고 가정해 보겠습니다. 읽기 전용 복제본에서 `SHOW REPLICA STATUS\G`를 실행하면 다음 결과가 반환됩니다.
```
*************************** 1. row ***************************
Replica_IO_State:
Source_Host: myhost.XXXXXXXXXXXXXXX.rr-rrrr-1.rds.amazonaws.com
Source_User: MasterUser
Source_Port: 3306
Connect_Retry: 10
Source_Log_File: mysql-bin-changelog.012345
Read_Source_Log_Pos: 1219393
Relay_Log_File: relaylog.012340
Relay_Log_Pos: 30223388
Relay_Source_Log_File: mysql-bin-changelog.012345
Replica_IO_Running: No
Replica_SQL_Running: Yes
Replicate_Do_DB:
Replicate_Ignore_DB:
Replicate_Do_Table:
Replicate_Ignore_Table:
Replicate_Wild_Do_Table:
Replicate_Wild_Ignore_Table:
Last_Errno: 0
Last_Error:
Skip_Counter: 0
Exec_Source_Log_Pos: 30223232
Relay_Log_Space: 5248928866
Until_Condition: None
Until_Log_File:
Until_Log_Pos: 0
Source_SSL_Allowed: No
Source_SSL_CA_File:
Source_SSL_CA_Path:
Source_SSL_Cert:
Source_SSL_Cipher:
Source_SSL_Key:
Seconds_Behind_Source: NULL
Source_SSL_Verify_Server_Cert: No
Last_IO_Errno: 1236
Last_IO_Error: Got fatal error 1236 from source when reading data from binary log: 'Client requested source to start replication from impossible position; the first event 'mysql-bin-changelog.013406' at 1219393, the last event read from '/rdsdbdata/log/binlog/mysql-bin-changelog.012345' at 4, the last byte read from '/rdsdbdata/log/binlog/mysql-bin-changelog.012345' at 4.'
Last_SQL_Errno: 0
Last_SQL_Error:
Replicate_Ignore_Server_Ids:
Source_Server_Id: 67285976
```
`Last_IO_Errno` 필드가 인스턴스에서 I/O 오류 1236을 수신하고 있음을 보여 줍니다. `Source_Log_File` 필드는 파일 이름이 `mysql-bin-changelog.012345`임을 보여 줍니다. 이는 로그 파일 인덱스가 `12345`임을 의미합니다. 오류를 해결하려면 다음 파라미터와 함께 `mysql.rds_next_source_log`를 호출합니다.
```
CALL mysql.rds_next_source_log(12345);
```
## mysql.rds\_reset\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)
이제 RDS for MySQL DB 인스턴스가 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되지 않도록 다시 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_reset_external_master;
```
### 사용 노트
마스터 사용자는 `mysql.rds_reset_external_master` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 제거되도록 MySQL DB 인스턴스에서 실행해야 합니다.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
복제를 사용하여 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 데이터 가져오기에 대한 자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 주제를 참조하십시오.
## mysql.rds\_reset\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)
이제 RDS for MySQL DB 인스턴스가 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되지 않도록 다시 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_reset_external_source;
```
### 사용 노트
관리 사용자는 `mysql.rds_reset_external_source` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 제거되도록 MySQL DB 인스턴스에서 실행해야 합니다.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다.
Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오. 복제를 사용하여 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 데이터 가져오기에 대한 자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 주제를 참조하십시오.
## mysql.rds\_set\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)
RDS for MySQL DB 인스턴스가 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
**참고**
[mysql.rds\_set\_external\_master\_with\_delay(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master_with_delay) 저장 프로시저를 사용하여 외부 소스 데이터베이스 인스턴스 및 지연된 복제를 구성할 수 있습니다.
### 구문
```
CALL mysql.rds_set_external_master (
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{mysql_binary_log_file_name}}
, {{mysql_binary_log_file_location}}
, {{ssl_encryption}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH(Secure Shell)에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{mysql\_binary\_log\_file\_name}}
복제 정보를 포함하는 소스 데이터베이스 인스턴스의 이진 로그 이름입니다.
{{mysql\_binary\_log\_file\_location}}
복제 시 복제 정보를 읽기 시작하는 `mysql_binary_log_file_name` 이진수 로그 내 위치입니다.
소스 데이터베이스 인스턴스의 `SHOW MASTER STATUS`를 실행하여 binlog 파일 이름 및 위치를 확인할 수 있습니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`MASTER_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
### 사용 노트
마스터 사용자는 `mysql.rds_set_external_master` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 MySQL DB 인스턴스에서 실행해야 합니다.
`mysql.rds_set_external_master`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 MySQL의 외부 인스턴스에서 `replication_user_name` 및 `replication_user_password` 권한이 있는 복제 사용자를 나타내는 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 값을 지정해야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예입니다.
**MySQL 5.7**
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY '{{password}}';
```
**MySQL 8.0**
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED WITH mysql_native_password BY '{{password}}';
```
**참고**
보안 모범 사례로 여기에 표시된 프롬프트 이외의 암호를 지정하는 것이 좋습니다.
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 'repl\_user' 사용자에게 모든 데이터베이스에 대한 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다.
**MySQL 5.7**
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com' IDENTIFIED BY '{{password}}';
```
**MySQL 8.0**
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com';
```
암호화된 복제를 사용하려면 SSL 연결을 사용하도록 소스 데이터베이스 인스턴스를 구성합니다.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_master`을 호출하여 Amazon RDS DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_reset_external_master)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_master`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
### 예제:
MySQL DB 인스턴스에서 다음 예제를 실행하면 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스가 구성됩니다.
```
call mysql.rds_set_external_master(
'Externaldb.some.com',
3306,
'repl_user',
'{{password}}',
'mysql-bin-changelog.0777',
120,
1);
```
## mysql.rds\_set\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)
RDS for MySQL DB 인스턴스가 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_source (
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{mysql_binary_log_file_name}}
, {{mysql_binary_log_file_location}}
, {{ssl_encryption}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH(Secure Shell)에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{mysql\_binary\_log\_file\_name}}
복제 정보를 포함하는 소스 데이터베이스 인스턴스의 이진 로그 이름입니다.
{{mysql\_binary\_log\_file\_location}}
복제 시 복제 정보를 읽기 시작하는 `mysql_binary_log_file_name` 이진수 로그 내 위치입니다.
소스 데이터베이스 인스턴스의 `SHOW MASTER STATUS`를 실행하여 binlog 파일 이름 및 위치를 확인할 수 있습니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`SOURCE_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
### 사용 노트
관리 사용자는 `mysql.rds_set_external_source` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 RDS for MySQL DB 인스턴스에서 실행해야 합니다.
`mysql.rds_set_external_source`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 MySQL의 외부 인스턴스에서 `replication_user_name` 및 `replication_user_password` 권한이 있는 복제 사용자를 나타내는 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 값을 지정해야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예입니다.
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY '{{password}}';
```
**참고**
보안 모범 사례로 여기에 표시된 프롬프트 이외의 암호를 지정하는 것이 좋습니다.
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 'repl\_user' 사용자에게 모든 데이터베이스에 대한 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다.
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com';
```
암호화된 복제를 사용하려면 SSL 연결을 사용하도록 소스 데이터베이스 인스턴스를 구성합니다. 또한 [mysql.rds\_import\_binlog\_ssl\_material](url-rds-user;mysql_rds_import_binlog_ssl_material.html) 프로시저를 사용하여 인증 기관(CA) 인증서, 클라이언트 인증서, 클라이언트 키를 DB 인스턴스나 DB 클러스터로 가져옵니다.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_source`를 직접 호출하여 RDS for MySQL DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 직접 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_reset_external_source)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_source`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
### 예제
RDS for MySQL DB 인스턴스에서 실행할 경우 다음 예시는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스를 구성합니다.
```
call mysql.rds_set_external_source(
'Externaldb.some.com',
3306,
'repl_user',
'{{password}}',
'mysql-bin-changelog.0777',
120,
1);
```
## mysql.rds\_set\_external\_master\_with\_auto\_position(RDS for MySQL 메이저 버전 8.0 이하)
RDS for MySQL DB 인스턴스를 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성합니다. 또한 이 프로시저는 전역 트랜잭션 식별자(GTID)를 기반으로 한 지연된 복제 및 복제를 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_master_with_auto_position (
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{ssl_encryption}}
, {{delay}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH(Secure Shell)에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`MASTER_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
{{delay}}
소스 데이터베이스 인스턴스에서 복제를 지연할 최소 시간(초)입니다.
이 파라미터에 대한 제한은 1일(86,400초)입니다.
### 사용 노트
마스터 사용자는 `mysql.rds_set_external_master_with_auto_position` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 MySQL DB 인스턴스에서 실행해야 합니다.
이 프로시저는 모든 RDS for MySQL 5.7 버전 및 RDS for MySQL 8.0.26 이상의 8.0 버전에서 지원됩니다.
`mysql.rds_set_external_master_with_auto_position`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 `replication_user_name` 및 `replication_user_password`의 값을 지정해야 합니다. 이러한 값은 MySQL의 외부 인스턴스에 대해 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 가진 복제 사용자를 나타내야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예제입니다.
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
```
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 `REPLICATION CLIENT` 사용자에게 모든 데이터베이스에 대한 `REPLICATION SLAVE` 및 `'repl_user'` 권한을 부여합니다.
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
IDENTIFIED BY 'SomePassW0rd'
```
자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 섹션을 참조하세요.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_master_with_auto_position` 직접 호출 전에 [mysql.rds\_set\_external\_source\_gtid\_purged](#mysql_rds_set_external_source_gtid_purged)를 직접 호출하여 외부 소스의 지정된 GTID 범위로 시스템 변수를 설정합니다.
`mysql.rds_set_external_master_with_auto_position`을 호출하여 Amazon RDS DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_reset_external_master)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_master_with_auto_position`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
재해 복구의 경우 이 프로시저를 [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저와 함께 사용할 수 있습니다. 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드하려면 `mysql.rds_set_external_master_with_auto_position` 프로시저를 실행할 수 있습니다. `mysql.rds_start_replication_until_gtid` 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
`mysql.rds_rds_start_replication_until_gtid` 프로시저를 사용하려면 GTID를 기반으로 한 복제를 활성화해야 합니다. 재해 원인으로 알려진 특정 GTID 기반 트랜잭션을 건너 뛰려면 [mysql.rds\_skip\_transaction\_with\_gtid](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid) 저장 프로시저를 사용할 수 있습니다. GTID 기반 복제 작업에 대한 자세한 내용은 [GTID 기반 복제 사용](mysql-replication-gtid.md) 섹션을 참조하십시오.
### 예제:
MySQL DB 인스턴스에서 다음 예제를 실행하면 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스가 구성됩니다. MySQL DB 인스턴스에서 최소 복제 지연을 1시간(3,600초)으로 설정합니다. Amazon RDS 외부에서 실행 중인 MySQL 소스 데이터베이스 인스턴스의 변경 사항은 최소 1시간 동안 MySQL DB 인스턴스 읽기 전용 복제본에 적용되지 않습니다.
```
call mysql.rds_set_external_master_with_auto_position(
'Externaldb.some.com',
3306,
'repl_user',
'SomePassW0rd',
1,
3600);
```
## mysql.rds\_set\_external\_source\_with\_auto\_position(RDS for MySQL 메이저 버전 8.4 이상)
RDS for MySQL DB 인스턴스를 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성합니다. 또한 이 프로시저는 전역 트랜잭션 식별자(GTID)를 기반으로 한 지연된 복제 및 복제를 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_source_with_auto_position (
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{ssl_encryption}}
, {{delay}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH(Secure Shell)에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`SOURCE_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
{{delay}}
소스 데이터베이스 인스턴스에서 복제를 지연할 최소 시간(초)입니다.
이 파라미터에 대한 제한은 1일(86,400초)입니다.
### 사용 노트
관리 사용자는 `mysql.rds_set_external_source_with_auto_position` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 MySQL DB 인스턴스에서 실행해야 합니다.
`mysql.rds_set_external_source_with_auto_position`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 `replication_user_name` 및 `replication_user_password`의 값을 지정해야 합니다. 이러한 값은 MySQL의 외부 인스턴스에 대해 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 가진 복제 사용자를 나타내야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예제입니다.
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
```
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 `REPLICATION CLIENT` 사용자에게 모든 데이터베이스에 대한 `REPLICATION SLAVE` 및 `'repl_user'` 권한을 부여합니다.
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
IDENTIFIED BY 'SomePassW0rd'
```
자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 섹션을 참조하세요.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_source_with_auto_position` 직접 호출 전에 [mysql.rds\_set\_external\_source\_gtid\_purged](#mysql_rds_set_external_source_gtid_purged)를 직접 호출하여 외부 소스의 지정된 GTID 범위로 `gtid_purged` 시스템 변수를 설정합니다.
`mysql.rds_set_external_source_with_auto_position`을 호출하여 Amazon RDS DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_reset_external_source)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_source_with_auto_position`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
재해 복구의 경우 이 프로시저를 [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저와 함께 사용할 수 있습니다. 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드하려면 `mysql.rds_set_external_source_with_auto_position` 프로시저를 실행할 수 있습니다. `mysql.rds_start_replication_until_gtid` 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
`mysql.rds_rds_start_replication_until_gtid` 프로시저를 사용하려면 GTID를 기반으로 한 복제를 활성화해야 합니다. 재해 원인으로 알려진 특정 GTID 기반 트랜잭션을 건너 뛰려면 [mysql.rds\_skip\_transaction\_with\_gtid](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid) 저장 프로시저를 사용할 수 있습니다. GTID 기반 복제 작업에 대한 자세한 내용은 [GTID 기반 복제 사용](mysql-replication-gtid.md) 섹션을 참조하십시오.
### 예제:
MySQL DB 인스턴스에서 다음 예제를 실행하면 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스가 구성됩니다. MySQL DB 인스턴스에서 최소 복제 지연을 1시간(3,600초)으로 설정합니다. Amazon RDS 외부에서 실행 중인 MySQL 소스 데이터베이스 인스턴스의 변경 사항은 최소 1시간 동안 MySQL DB 인스턴스 읽기 전용 복제본에 적용되지 않습니다.
```
call mysql.rds_set_external_source_with_auto_position(
'Externaldb.some.com',
3306,
'repl_user',
'SomePassW0rd',
1,
3600);
```
## mysql.rds\_set\_external\_master\_with\_delay(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 RDS for MySQL DB 인스턴스를 구성하고 지연 복제를 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_master_with_delay(
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{mysql_binary_log_file_name}}
, {{mysql_binary_log_file_location}}
, {{ssl_encryption}}
, {{delay}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{mysql\_binary\_log\_file\_name}}
복제 정보를 포함하는 소스 데이터베이스 인스턴스의 이진 로그 이름입니다.
{{mysql\_binary\_log\_file\_location}}
복제 시 복제 정보를 읽기 시작할 `mysql_binary_log_file_name` 이진 로그 내 위치입니다.
소스 데이터베이스 인스턴스의 `SHOW MASTER STATUS`를 실행하여 binlog 파일 이름 및 위치를 확인할 수 있습니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`MASTER_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
{{delay}}
소스 데이터베이스 인스턴스에서 복제를 지연할 최소 시간(초)입니다.
이 파라미터에 대한 제한은 1일(86,400초)입니다.
### 사용 노트
마스터 사용자는 `mysql.rds_set_external_master_with_delay` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 MySQL DB 인스턴스에서 실행해야 합니다.
`mysql.rds_set_external_master_with_delay`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 `replication_user_name` 및 `replication_user_password`의 값을 지정해야 합니다. 이러한 값은 MySQL의 외부 인스턴스에 대해 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 가진 복제 사용자를 나타내야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예제입니다.
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
```
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 `REPLICATION CLIENT` 사용자에게 모든 데이터베이스에 대한 `REPLICATION SLAVE` 및 `'repl_user'` 권한을 부여합니다.
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
IDENTIFIED BY 'SomePassW0rd'
```
자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 섹션을 참조하세요.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_master_with_delay`을 호출하여 Amazon RDS DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_reset_external_master)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_master_with_delay`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
재해 복구의 경우 이 프로시저를 [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저와 함께 사용할 수 있습니다. 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드하려면 `mysql.rds_set_external_master_with_delay` 프로시저를 실행할 수 있습니다. `mysql.rds_start_replication_until` 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
`mysql.rds_rds_start_replication_until_gtid` 프로시저를 사용하려면 GTID를 기반으로 한 복제를 활성화해야 합니다. 재해 원인으로 알려진 특정 GTID 기반 트랜잭션을 건너 뛰려면 [mysql.rds\_skip\_transaction\_with\_gtid](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid) 저장 프로시저를 사용할 수 있습니다. GTID 기반 복제 작업에 대한 자세한 내용은 [GTID 기반 복제 사용](mysql-replication-gtid.md) 섹션을 참조하십시오.
`mysql.rds_set_external_master_with_delay` 프로시저는 다음 버전의 RDS for MySQL에서 사용할 수 있습니다.
+ MySQL 8.0.26 및 8.0 버전 이상
+ 모든 5.6 버전
### 예제
MySQL DB 인스턴스에서 다음 예제를 실행하면 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스가 구성됩니다. MySQL DB 인스턴스에서 최소 복제 지연을 1시간(3,600초)으로 설정합니다. Amazon RDS 외부에서 실행 중인 MySQL 소스 데이터베이스 인스턴스의 변경 사항은 최소 1시간 동안 MySQL DB 인스턴스 읽기 전용 복제본에 적용되지 않습니다.
```
call mysql.rds_set_external_master_with_delay(
'Externaldb.some.com',
3306,
'repl_user',
'SomePassW0rd',
'mysql-bin-changelog.000777',
120,
1,
3600);
```
## mysql.rds\_set\_external\_source\_with\_delay(RDS for MySQL 메이저 버전 8.4 이상)
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 RDS for MySQL DB 인스턴스를 구성하고 지연 복제를 구성합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_source_with_delay (
{{host_name}}
, {{host_port}}
, {{replication_user_name}}
, {{replication_user_password}}
, {{mysql_binary_log_file_name}}
, {{mysql_binary_log_file_location}}
, {{ssl_encryption}}
, {{delay}}
);
```
### 파라미터
{{host\_name}}
소스 데이터베이스 인스턴스가 될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 호스트 이름 또는 IP 주소입니다.
{{host\_port}}
소스 데이터베이스 인스턴스로 구성될 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 사용하는 포트입니다. 네트워크 구성에 포트 번호를 변환하는 SSH 포트 복제가 포함되는 경우 SSH에 의해 공개되는 포트 이름을 지정하십시오.
{{replication\_user\_name}}
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 보유한 사용자의 ID입니다. 외부 인스턴스를 사용한 복제에만 사용되는 계정을 제공하는 것이 좋습니다.
{{replication\_user\_password}}
`replication_user_name`에 지정된 사용자 ID의 암호입니다.
{{mysql\_binary\_log\_file\_name}}
복제 정보를 포함하는 소스 데이터베이스 인스턴스의 이진 로그 이름입니다.
{{mysql\_binary\_log\_file\_location}}
복제 시 복제 정보를 읽기 시작할 `mysql_binary_log_file_name` 이진 로그 내 위치입니다.
소스 데이터베이스 인스턴스의 `SHOW MASTER STATUS`를 실행하여 binlog 파일 이름 및 위치를 확인할 수 있습니다.
{{ssl\_encryption}}
복제 연결에 보안 소켓 계층(SSL) 암호화를 사용할지 여부를 지정하는 값입니다. 1은 SSL 암호화 사용, 0은 암호화 사용 안 함입니다. 기본값은 0입니다.
`SOURCE_SSL_VERIFY_SERVER_CERT` 옵션은 지원되지 않습니다. 이 옵션은 0으로 설정되어 있는데, 이는 연결이 암호화되었지만 인증서는 확인되지 않았음을 의미합니다.
{{delay}}
소스 데이터베이스 인스턴스에서 복제를 지연할 최소 시간(초)입니다.
이 파라미터에 대한 제한은 1일(86,400초)입니다.
### 사용 노트
관리 사용자는 `mysql.rds_set_external_source_with_delay` 프로시저를 실행해야 합니다. 이 프로시저는 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본으로 구성되도록 MySQL DB 인스턴스에서 실행해야 합니다.
`mysql.rds_set_external_source_with_delay`을 실행하기 전에 소스 데이터베이스 인스턴스가 되도록 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스를 구성해야 합니다. Amazon RDS 외부에서 실행하는 MySQL 인스턴스에 연결하려면 `replication_user_name` 및 `replication_user_password`의 값을 지정해야 합니다. 이러한 값은 MySQL의 외부 인스턴스에 대해 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 가진 복제 사용자를 나타내야 합니다.
**MySQL의 외부 인스턴스를 소스 데이터베이스 인스턴스로 구성하려면**
1. 선택한 MySQL 클라이언트를 사용하여 MySQL의 외부 인스턴스에 연결하고 복제에 사용될 사용자 계정을 생성합니다. 다음은 예제입니다.
```
CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
```
1. MySQL의 외부 인스턴스에서 복제 사용자에게 `REPLICATION CLIENT` 및 `REPLICATION SLAVE` 권한을 부여합니다. 다음 예제에서는 도메인의 `REPLICATION CLIENT` 사용자에게 모든 데이터베이스에 대한 `REPLICATION SLAVE` 및 `'repl_user'` 권한을 부여합니다.
```
GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
IDENTIFIED BY 'SomePassW0rd'
```
자세한 내용은 [외부 소스 인스턴스를 사용하여 이진 로그 파일 위치 복제 구성](MySQL.Procedural.Importing.External.Repl.md) 섹션을 참조하세요.
**참고**
가능하면 읽기 전용 복제본을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 관리하는 것이 좋습니다. 그렇게 하면 이 복제 및 다른 복제 관련 저장 프로시저만 사용하는 것이 좋습니다. 이러한 방법을 사용하면 Amazon RDS DB 인스턴스 간 더욱 복잡한 복제 토폴로지를 사용할 수 있습니다. 이러한 저장 프로시저는 주로 Amazon RDS 외부에서 실행되는 MySQL 인스턴스를 사용하여 복제할 수 있도록 하기 위한 것입니다. Amazon RDS DB 인스턴스 간 복제 관리에 대한 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 주제를 참조하십시오.
`mysql.rds_set_external_source_with_delay`을 호출하여 Amazon RDS DB 인스턴스를 읽기 전용 복제본으로 구성한 후 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 복제 프로세스를 시작할 수 있습니다. [mysql.rds\_reset\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_reset_external_source)를 호출하여 읽기 전용 복제본 구성을 제거할 수 있습니다.
`mysql.rds_set_external_source_with_delay`를 호출하면 Amazon RDS는 `set master`의 시간, 사용자 및 작업을 `mysql.rds_history` 및 `mysql.rds_replication_status` 테이블에 기록합니다.
재해 복구의 경우 이 프로시저를 [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저와 함께 사용할 수 있습니다. 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드하려면 `mysql.rds_set_external_source_with_delay` 프로시저를 실행할 수 있습니다. `mysql.rds_start_replication_until` 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
`mysql.rds_rds_start_replication_until_gtid` 프로시저를 사용하려면 GTID를 기반으로 한 복제를 활성화해야 합니다. 재해 원인으로 알려진 특정 GTID 기반 트랜잭션을 건너 뛰려면 [mysql.rds\_skip\_transaction\_with\_gtid](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid) 저장 프로시저를 사용할 수 있습니다. GTID 기반 복제 작업에 대한 자세한 내용은 [GTID 기반 복제 사용](mysql-replication-gtid.md) 섹션을 참조하십시오.
### 예제:
MySQL DB 인스턴스에서 다음 예제를 실행하면 Amazon RDS 외부에서 실행 중인 MySQL 인스턴스의 읽기 전용 복제본이 되도록 DB 인스턴스가 구성됩니다. MySQL DB 인스턴스에서 최소 복제 지연을 1시간(3,600초)으로 설정합니다. Amazon RDS 외부에서 실행 중인 MySQL 소스 데이터베이스 인스턴스의 변경 사항은 최소 1시간 동안 MySQL DB 인스턴스 읽기 전용 복제본에 적용되지 않습니다.
```
call mysql.rds_set_external_source_with_delay(
'Externaldb.some.com',
3306,
'repl_user',
'SomePassW0rd',
'mysql-bin-changelog.000777',
120,
1,
3600);
```
## mysql.rds\_set\_external\_source\_gtid\_purged
외부 소스의 지정된 GTID 범위를 사용하여 [gtid\_purged](https://dev.mysql.com/doc/refman/8.0/en/replication-options-gtids.html#sysvar_gtid_purged) 시스템 변수를 설정합니다. `gtid_purged` 값은 자동 위치 지정을 사용하여 복제를 재개하도록 GTID 기반 복제를 구성하는 데 필요합니다.
**중요**
이 프로시저를 실행하려면 `autocommit`를 활성화해야 합니다. 활성화하려면 `autocommit` 파라미터를 `1`로 설정합니다. 파라미터 수정에 대한 자세한 정보는 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 섹션을 참조하십시오.
### 구문
```
CALL mysql.rds_set_external_source_gtid_purged(
{{server_uuid}}
, {{start_pos}}
, {{end_pos}}
);
```
### 파라미터
{{server\_uuid}}
GTID 범위를 가져오는 외부 서버의 범용 고유 식별자(UUID)입니다.
{{start\_pos}}
설정할 GTID 범위의 시작 위치입니다.
{{end\_pos}}
설정할 GTID 범위의 종료 위치입니다.
### 사용 노트
`mysql.rds_set_external_source_gtid_purged` 프로시저는 MySQL 8.0.37 이상의 8.0 버전에서만 사용할 수 있습니다.
[mysql.rds\_set\_external\_master\_with\_auto\_position(RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master_with_auto_position), [mysql.rds\_set\_external\_source\_with\_auto\_position(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source_with_auto_position) 또는 [mysql.rds\_set\_external\_source\_with\_auto\_position\_for\_channel](mysql-stored-proc-multi-source-replication.md#mysql_rds_set_external_source_with_auto_position_for_channel)을 직접 호출하기 전에 `mysql.rds_set_external_source_gtid_purged`를 직접 호출합니다.
`mysql.rds_set_external_source_gtid_purged` 직접 호출 전에 데이터베이스의 모든 활성 복제 채널을 중지해야 합니다. 채널 상태를 확인하려면 `SHOW REPLICA STATUS` MySQL 문을 사용합니다. 채널에서 복제를 중지하려면 [mysql.rds\_stop\_replication\_for\_channel](mysql-stored-proc-multi-source-replication.md#mysql_rds_stop_replication_for_channel)을 직접 호출합니다.
지정하는 GTID 범위는 기존 `GTID_PURGED` 값의 상위 집합이어야 합니다. 이 저장 프로시저는 `GTID_PURGED` 값을 설정하기 전에 다음 값을 확인합니다.
+ `server_uuid`는 유효합니다.
+ `start_pos` 값이 `0`보다 크거나 `end_pos`보다 작습니다.
+ `end_pos` 값이 `start_pos`보다 크거나 같습니다.
외부 서버의 GTID 집합에 여러 범위의 값이 포함된 경우 다른 GTID 집합 값을 사용하여 프로시저를 여러 번 직접 호출해 보세요.
`mysql.rds_set_external_source_gtid_purged`를 직접 호출하면 Amazon RDS는 `set gtid_purged`의 시간, 사용자 및 작업을 `mysql.rds_history` 테이블에 기록합니다.
복제에 사용하는 백업의 `gtid_purged` 값을 적절하게 설정하지 않으면 복제 프로세스 중에 트랜잭션이 누락되거나 중복될 수 있습니다. 다음 단계를 수행하여 올바른 `gtid_purged` 값을 설정합니다.
**복제본에 gtid\_purged 값을 설정하려면**
1. 복제 시작 지점으로 사용할 시점 또는 특정 백업 파일을 결정합니다. 이는 논리적 백업(mysqldump 파일) 또는 물리적 백업(Amazon RDS 스냅샷)일 수 있습니다.
1. `gtid_executed` 값을 결정합니다. 이 값은 서버에서 커밋된 모든 GTID 집합을 나타냅니다. 이 값을 검색하려면 소스 인스턴스에서 다음 중 하나를 수행합니다.
+ 백업을 수행할 때 SQL 문(`SELECT @@GLOBAL.GTID_EXECUTED;`)을 실행합니다.
+ 관련 옵션이 해당 백업 유틸리티에 포함되어 있는 경우 백업 파일에서 값을 추출합니다. 자세한 내용은 MySQL 설명서의 [set-gtid-purged](https://dev.mysql.com/doc/refman/8.4/en/mysqldump.html#option_mysqldump_set-gtid-purged) 옵션을 참조하세요.
1. `mysql.rds_set_external_source_gtid_purged`에 대한 직접 호출에 사용할 `gtid_purged` 값을 결정합니다. `gtid_purged` 값에는 소스 인스턴스에서 실행되어 복제에 더 이상 필요하지 않은 GTID가 모두 포함되어야 합니다. 따라서 `gtid_purged` 값은 이전 단계에서 검색한 `gtid_executed` 값의 하위 집합이어야 합니다.
`gtid_purged` 값을 확인하려면 백업에 포함되지 않아 복제에 더 이상 필요하지 않은 GTID를 식별합니다. 바이너리 로그를 분석하거나 mysqlbinlog와 같은 도구를 사용하여 바이너리 로그에서 제거된 GTID를 찾으면 됩니다.
또는 백업 지점까지의 모든 바이너리 로그를 포함하는 일관된 백업이 있는 경우 백업 지점의 `gtid_executed` 값과 동일하게 `gtid_purged` 값을 설정할 수 있습니다.
1. 백업과 일치하는 적절한 `gtid_purged` 값을 결정한 후 RDS for MySQL DB 인스턴스에서 `mysql.rds_set_external_source_gtid_purged` 저장 프로시저를 직접 호출하여 값을 설정합니다.
### 예제
MySQL DB 인스턴스에서 실행하는 경우 다음 예제에서는 UUID가 `12345678-abcd-1234-efgh-123456789abc`, 시작 위치가 `1`, 종료 위치가 `100`인 외부 MySQL 서버의 GTID 범위를 설정합니다. 결과 GTID 값은 `+12345678-abcd-1234-efgh-123456789abc:1-100`으로 설정됩니다.
```
CALL mysql.rds_set_external_source_gtid_purged('12345678-abcd-1234-efgh-123456789abc', 1, 100);
```
## mysql.rds\_set\_master\_auto\_position(RDS for MySQL 메이저 버전 8.0 이하)
복제 모드를 바이너리 로그 파일 위치 또는 전역 트랜잭션 식별자(GTID)를 기반으로 설정합니다.
### 구문
```
CALL mysql.rds_set_master_auto_position (
{{auto_position_mode}}
);
```
### 파라미터
{{auto\_position\_mode}}
로그 파일 위치 복제 또는 GTID를 기반으로 하는 복제를 사용할지 여부를 나타내는 값:
+ `0` – 바이너리 로그 파일 위치를 기반으로 한 복제 방법을 사용합니다. 기본값은 `0`입니다.
+ `1` – GTID 기반 복제 방법을 사용합니다.
### 사용 노트
마스터 사용자는 `mysql.rds_set_master_auto_position` 프로시저를 실행해야 합니다.
이 프로시저는 모든 RDS for MySQL 5.7 버전 및 RDS for MySQL 8.0.26 이상의 8.0 버전에서 지원됩니다.
## mysql.rds\_set\_source\_auto\_position(RDS for MySQL 메이저 버전 8.4 이상)
복제 모드를 바이너리 로그 파일 위치 또는 전역 트랜잭션 식별자(GTID)를 기반으로 설정합니다.
### 구문
```
CALL mysql.rds_set_source_auto_position ({{auto_position_mode}});
```
### 파라미터
{{auto\_position\_mode}}
로그 파일 위치 복제 또는 GTID를 기반으로 하는 복제를 사용할지 여부를 나타내는 값:
+ `0` – 바이너리 로그 파일 위치를 기반으로 한 복제 방법을 사용합니다. 기본값은 `0`입니다.
+ `1` – GTID 기반 복제 방법을 사용합니다.
### 사용 노트
관리 사용자는 `mysql.rds_set_source_auto_position` 프로시저를 실행해야 합니다.
## mysql.rds\_set\_source\_delay
소스 데이터베이스 인스턴스에서 현재 읽기 전용 복제본으로의 복제를 지연할 최소 시간(초)을 설정합니다. 읽기 전용 복제본에 연결된 경우에 이 프로시저를 사용하여 소스 데이터베이스 인스턴스에서 복제를 지연합니다.
### 구문
```
CALL mysql.rds_set_source_delay(
{{delay}}
);
```
### 파라미터
{{delay}}
소스 데이터베이스 인스턴스에서 복제를 지연할 최소 시간(초)입니다.
이 파라미터에 대한 제한은 1일(86,400초)입니다.
### 사용 노트
마스터 사용자는 `mysql.rds_set_source_delay` 프로시저를 실행해야 합니다.
재해 복구의 경우 이 프로시저를 [mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 저장 프로시저 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저와 함께 사용할 수 있습니다. 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드하려면 `mysql.rds_set_source_delay` 프로시저를 실행할 수 있습니다. `mysql.rds_start_replication_until` 또는 `mysql.rds_start_replication_until_gtid` 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
`mysql.rds_rds_start_replication_until_gtid` 프로시저를 사용하려면 GTID를 기반으로 한 복제를 활성화해야 합니다. 재해 원인으로 알려진 특정 GTID 기반 트랜잭션을 건너 뛰려면 [mysql.rds\_skip\_transaction\_with\_gtid](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid) 저장 프로시저를 사용할 수 있습니다. GTID 기반 복제에 대한 자세한 내용은 [GTID 기반 복제 사용](mysql-replication-gtid.md) 섹션을 참조하십시오.
`mysql.rds_set_source_delay` 프로시저는 다음 버전의 RDS for MySQL에서 사용할 수 있습니다.
+ 모든 RDS for MySQL 8.4 버전
+ MySQL 8.0.26 및 8.0 버전 이상
+ 모든 5.6 버전
### 예제
소스 데이터베이스 인스턴스에서 현재 읽기 전용 복제본으로의 복제를 최소 1시간(3,600초) 동안 지연하려면 다음 파라미터를 사용하여 `mysql.rds_set_source_delay`를 호출하면 됩니다.
```
CALL mysql.rds_set_source_delay(3600);
```
## mysql.rds\_skip\_repl\_error
MySQL DB 읽기 전용 복제본의 복제 오류를 건너뛰고 삭제합니다.
### 구문
```
CALL mysql.rds_skip_repl_error;
```
### 사용 노트
마스터 사용자는 읽기 전용 복제본에서 `mysql.rds_skip_repl_error` 프로시저를 실행해야 합니다. 이 프로시저에 대한 자세한 내용은 [mysql.rds\_skip\_repl\_error 프로시저 호출](Appendix.MySQL.CommonDBATasks.SkipError.md#Appendix.MySQL.CommonDBATasks.SkipError.procedure)를 참조하세요.
오류가 있는지 여부를 판별하려면 MySQL `SHOW REPLICA STATUS\G` 명령을 실행합니다. 중대한 복제 오류가 아닌 경우 `mysql.rds_skip_repl_error`를 사용하여 오류를 건너뛸 수 있습니다. 오류가 여러 개인 경우 `mysql.rds_skip_repl_error`는 첫 번째 오류를 삭제한 후 다른 오류가 있음을 경고합니다. `SHOW REPLICA STATUS\G`를 사용하여 다음 오류에 대한 적합한 조치를 결정할 수 있습니다. 반환된 값에 대한 자세한 내용은 MySQL 설명서의 [SHOW SLAVE STATUS 문](https://dev.mysql.com/doc/refman/8.0/en/show-replica-status.html)을 참조하세요.
Amazon RDS의 복제 오류 해결에 대한 자세한 내용은 [MySQL 읽기 전용 복제본의 문제 해결](USER_ReadRepl.Troubleshooting.md) 주제를 참조하십시오.
#### 복제 중지 오류
`mysql.rds_skip_repl_error` 프로시저를 호출할 때 복제본이 중단되었거나 사용 중지되었다는 오류 메시지가 표시될 수 있습니다.
읽기 전용 복제본 대신 기본 인스턴스에서 프로시저를 실행하면 이 오류 메시지가 나타납니다. 이 프로시저가 작동하려면 읽기 전용 복제본에서 이 프로시저를 실행해야 합니다.
이 오류 메시지는 읽기 전용 복제본에서 프로시저를 실행하지만 복제를 성공적으로 다시 시작할 수 없는 경우에도 나타날 수 있습니다.
많은 수의 오류를 건너뛰어야 하는 경우, 복제 지연이 바이너리 로그(binlog) 파일의 기본값 보관 기간 이상으로 늘어날 수 있습니다. 이 경우 binlog 파일이 읽기 전용 복제본에서 재생되기 전에 지워지기 때문에 치명적 오류가 발생할 수 있습니다. 이 제거는 복제를 중지시키며, 복제 오류를 건너뛰기 위해 더 이상 `mysql.rds_skip_repl_error` 명령을 호출할 수 없습니다.
이 문제는 소스 데이터베이스 인스턴스에서 binlog 파일이 보관되는 시간을 늘려서 완화할 수 있습니다. binlog 보관 시간을 늘린 후에 복제를 재시작하고 필요에 따라 `mysql.rds_skip_repl_error` 명령을 호출할 수 있습니다.
binlog 보관 기간을 설정하려면 [mysql.rds\_set\_configuration](mysql-stored-proc-configuring.md#mysql_rds_set_configuration) 프로시저를 사용하여 `'binlog retention hours'` 구성 파라미터와 DB 클러스터에 binlog 파일을 보관할 시간을 함께 지정하십시오. 다음 예제에서는 binlog 파일의 보관 기간을 48시간으로 설정합니다.
```
CALL mysql.rds_set_configuration('binlog retention hours', 48);
```
## mysql.rds\_start\_replication
RDS for MySQL DB 인스턴스에서 복제를 시작합니다.
**참고**
[mysql.rds\_start\_replication\_until](#mysql_rds_start_replication_until) 또는 [mysql.rds\_start\_replication\_until\_gtid](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) 저장 프로시저를 사용하여 RDS for MySQL DB 인스턴스에서 복제를 시작하고 지정된 바이너리 로그 파일 위치에서 복제를 중지할 수 있습니다.
### 구문
```
CALL mysql.rds_start_replication;
```
### 사용 노트
마스터 사용자는 `mysql.rds_start_replication` 프로시저를 실행해야 합니다.
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 데이터를 가져오려면 [mysql.rds\_set\_external\_master(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master) 또는 [mysql.rds\_set\_external\_source(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source)를 직접 호출하여 복제 구성을 빌드한 다음, 읽기 전용 복제본에서 `mysql.rds_start_replication`을 직접 호출하여 복제 프로세스를 시작합니다. 자세한 내용은 [Amazon RDS for MySQL DB 인스턴스로 백업 복원](MySQL.Procedural.Importing.md) 섹션을 참조하세요.
Amazon RDS 외부의 MySQL 인스턴스로 데이터를 내보내려면 읽기 전용 복제본에서 `mysql.rds_start_replication` 및 `mysql.rds_stop_replication`을 호출하여 바이너리 로그 삭제 등의 몇 가지 복제 작업을 제어합니다. 자세한 내용은 [복제를 사용하여 MySQL DB 인스턴스에서 데이터 내보내기](MySQL.Procedural.Exporting.NonRDSRepl.md) 섹션을 참조하세요.
읽기 전용 복제본에서 `mysql.rds_start_replication`을 호출하여 이전에 `mysql.rds_stop_replication`을 호출하여 중지한 복제 프로세스를 재시작할 수도 있습니다. 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 섹션을 참조하세요.
## mysql.rds\_start\_replication\_until
RDS for MySQL DB 인스턴스에서 복제를 시작하고 지정된 바이너리 로그 파일 위치에서 복제를 중지합니다.
### 구문
```
CALL mysql.rds_start_replication_until (
{{replication_log_file}}
, {{replication_stop_point}}
);
```
### 파라미터
{{replication\_log\_file}}
복제 정보를 포함하는 소스 데이터베이스 인스턴스의 이진 로그 이름입니다.
{{replication\_stop\_point }}
복제를 중지할 `replication_log_file` 바이너리 로그 내 위치입니다.
### 사용 노트
마스터 사용자는 `mysql.rds_start_replication_until` 프로시저를 실행해야 합니다.
`mysql.rds_start_replication_until` 프로시저는 다음 버전의 RDS for MySQL에서 사용할 수 있습니다.
+ 모든 RDS for MySQL 8.4 버전
+ MySQL 8.0.26 및 8.0 버전 이상
+ 모든 5.6 버전
이 프로시저는 지연 복제에서 재해 복구를 위해 사용할 있습니다. 지연된 복제를 구성한 경우 이 프로시저를 사용하여 지연된 읽기 전용 복제본에 대한 변경 사항을 재해 직전 시간으로 롤포워드할 수 있습니다. 이 프로시저에서 복제를 중지한 이후에 [읽기 전용 복제본을 독립 DB 인스턴스로 승격](USER_ReadRepl.Promote.md)의 지침에 따라 읽기 전용 복제본을 새 기본 DB 인스턴스가 되도록 승격할 수 있습니다.
다음 저장 프로시저를 사용하여 지연 복제를 구성할 수 있습니다.
+ [mysql.rds\_set\_configuration](mysql-stored-proc-configuring.md#mysql_rds_set_configuration)
+ [mysql.rds\_set\_external\_master\_with\_delay(RDS for MariaDB 및 RDS for MySQL 메이저 버전 8.0 이하)](#mysql_rds_set_external_master_with_delay)
+ [mysql.rds\_set\_external\_source\_with\_delay(RDS for MySQL 메이저 버전 8.4 이상)](#mysql_rds_set_external_source_with_delay)
+ [mysql.rds\_set\_source\_delay](#mysql_rds_set_source_delay)
`replication_log_file` 파라미터에 지정된 파일 이름은 소스 데이터베이스 인스턴스 binlog 파일 이름과 일치해야 합니다.
`replication_stop_point` 파라미터가 과거에 해당하는 중지 위치를 지정하는 경우 복제가 즉시 중지됩니다.
### 예제
다음 예에서는 복제를 시작하고 `120` 바이너리 로그 파일의 `mysql-bin-changelog.000777` 위치에 도달할 때까지 변경 사항을 복제합니다.
```
call mysql.rds_start_replication_until(
'mysql-bin-changelog.000777',
120);
```
## mysql.rds\_stop\_replication
MySQL DB 인스턴스에서 복제를 중지합니다.
### 구문
```
CALL mysql.rds_stop_replication;
```
### 사용 노트
마스터 사용자는 `mysql.rds_stop_replication` 프로시저를 실행해야 합니다.
Amazon RDS 외부에서 실행 중인 MySQL 인스턴스에서 데이터를 가져오도록 복제를 구성하는 경우 가져오기가 완료된 후 읽기 전용 복제본에서 `mysql.rds_stop_replication`을 호출하여 복제 프로세스를 중지합니다. 자세한 내용은 [Amazon RDS for MySQL DB 인스턴스로 백업 복원](MySQL.Procedural.Importing.md) 섹션을 참조하세요.
Amazon RDS 외부의 MySQL 인스턴스로 데이터를 내보내도록 복제를 구성할 경우 읽기 전용 복제본에서 `mysql.rds_start_replication` 및 `mysql.rds_stop_replication`을 호출하여 이진 로그 삭제 등의 몇 가지 복제 작업을 제어합니다. 자세한 내용은 [복제를 사용하여 MySQL DB 인스턴스에서 데이터 내보내기](MySQL.Procedural.Exporting.NonRDSRepl.md) 섹션을 참조하세요.
`mysql.rds_stop_replication`을 사용하여 두 Amazon RDS DB 인스턴스 간 복제를 중지할 수도 있습니다. 일반적으로 읽기 전용 복제본에서 대규모 인덱스 생성과 같이 읽기 전용 복제본에서 장기 실행 작업을 수행하려는 경우 복제를 중지합니다. 읽기 전용 복제본에서 [mysql.rds\_start\_replication](#mysql_rds_start_replication)을 호출하여 중지한 복제 프로세스를 재시작할 수 있습니다. 자세한 내용은 [DB 인스턴스 읽기 전용 복제본 작업](USER_ReadRepl.md) 섹션을 참조하세요.