

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aurora Referensi prosedur SQL tersimpan saya
<a name="AuroraMySQL.Reference.StoredProcs"></a>

Anda dapat mengelola cluster Aurora My SQL DB Anda dengan memanggil prosedur tersimpan bawaan.

**Topics**
+ [

# Mengumpulkan dan memelihara Sejarah Status Global
](mysql-stored-proc-gsh.md)
+ [

# Mengkonfigurasi, memulai, dan menghentikan replikasi log biner (binlog)
](mysql-stored-proc-replicating.md)
+ [

# Mengakhiri sesi atau kueri
](mysql-stored-proc-ending.md)
+ [

# Mereplikasi transaksi menggunakan GTIDs
](mysql-stored-proc-gtid.md)
+ [

# Memutar log kueri
](mysql-stored-proc-logging.md)
+ [

# Mengatur dan menampilkan konfigurasi log biner
](mysql-stored-proc-configuring.md)

# Mengumpulkan dan memelihara Sejarah Status Global
<a name="mysql-stored-proc-gsh"></a>

Amazon RDS menyediakan serangkaian prosedur yang mengambil snapshot dari nilai variabel status dari waktu ke waktu dan menuliskannya ke tabel, bersama dengan perubahan apa pun sejak snapshot terakhir. Infrastruktur ini disebut Global Status History. Untuk informasi selengkapnya, lihat [Mengelola Global Status History](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.MySQL.CommonDBATasks.html#Appendix.MySQL.CommonDBATasks.GoSH).

Prosedur tersimpan berikut mengelola bagaimana Global Status History dikumpulkan dan dipelihara.

**Topics**
+ [

## mysql.rds\$1collect\$1global\$1status\$1history
](#mysql_rds_collect_global_status_history)
+ [

## mysql.rds\$1disable\$1gsh\$1collector
](#mysql_rds_disable_gsh_collector)
+ [

## mysql.rds\$1disable\$1gsh\$1rotation
](#mysql_rds_disable_gsh_rotation)
+ [

## mysql.rds\$1enable\$1gsh\$1collector
](#mysql_rds_enable_gsh_collector)
+ [

## mysql.rds\$1enable\$1gsh\$1rotation
](#mysql_rds_enable_gsh_rotation)
+ [

## mysql.rds\$1rotate\$1global\$1status\$1history
](#mysql_rds_rotate_global_status_history)
+ [

## mysql.rds\$1set\$1gsh\$1collector
](#mysql_rds_set_gsh_collector)
+ [

## mysql.rds\$1set\$1gsh\$1rotation
](#mysql_rds_set_gsh_rotation)

## mysql.rds\$1collect\$1global\$1status\$1history
<a name="mysql_rds_collect_global_status_history"></a>

Mengambil snapshot sesuai permintaan untuk Global Status History.

### Sintaks
<a name="rds_collect_global_status_history-syntax"></a>

 

```
CALL mysql.rds_collect_global_status_history;
```

## mysql.rds\$1disable\$1gsh\$1collector
<a name="mysql_rds_disable_gsh_collector"></a>

Menonaktifkan snapshot yang diambil oleh Global Status History.

### Sintaks
<a name="mysql_rds_disable_gsh_collector-syntax"></a>

 

```
CALL mysql.rds_disable_gsh_collector;
```

## mysql.rds\$1disable\$1gsh\$1rotation
<a name="mysql_rds_disable_gsh_rotation"></a>

Menonaktifkan rotasi tabel `mysql.global_status_history`.

### Sintaks
<a name="mysql_rds_disable_gsh_rotation-syntax"></a>

 

```
CALL mysql.rds_disable_gsh_rotation;
```

## mysql.rds\$1enable\$1gsh\$1collector
<a name="mysql_rds_enable_gsh_collector"></a>

Mengaktifkan Global Status History untuk mengambil snapshot default pada interval yang ditentukan oleh `rds_set_gsh_collector`.

### Sintaks
<a name="mysql_rds_enable_gsh_collector-syntax"></a>

 

```
CALL mysql.rds_enable_gsh_collector;
```

## mysql.rds\$1enable\$1gsh\$1rotation
<a name="mysql_rds_enable_gsh_rotation"></a>

Mengaktifkan rotasi konten tabel `mysql.global_status_history` ke `mysql.global_status_history_old` pada interval yang ditentukan oleh `rds_set_gsh_rotation`.

### Sintaks
<a name="mysql_rds_enable_gsh_rotation-syntax"></a>

 

```
CALL mysql.rds_enable_gsh_rotation;
```

## mysql.rds\$1rotate\$1global\$1status\$1history
<a name="mysql_rds_rotate_global_status_history"></a>

Merotasi konten tabel `mysql.global_status_history` ke `mysql.global_status_history_old` sesuai permintaan.

### Sintaks
<a name="mysql_rds_rotate_global_status_history-syntax"></a>

 

```
CALL mysql.rds_rotate_global_status_history;
```

## mysql.rds\$1set\$1gsh\$1collector
<a name="mysql_rds_set_gsh_collector"></a>

Menentukan interval, dalam menit, di antara snapshot yang diambil oleh Global Status History.

### Sintaks
<a name="mysql_rds_set_gsh_collector-syntax"></a>

 

```
CALL mysql.rds_set_gsh_collector(intervalPeriod);
```

### Parameter
<a name="mysql_rds_set_gsh_collector-parameters"></a>

 *intervalPeriod*   
Interval, dalam menit, di antara snapshot. Nilai default-nya adalah `5`.

## mysql.rds\$1set\$1gsh\$1rotation
<a name="mysql_rds_set_gsh_rotation"></a>

Menentukan interval, dalam hari, antara rotasi tabel `mysql.global_status_history`.

### Sintaks
<a name="mysql_rds_set_gsh_rotation-syntax"></a>

 

```
CALL mysql.rds_set_gsh_rotation(intervalPeriod);
```

### Parameter
<a name="mysql_rds_set_gsh_rotation-parameters"></a>

 *intervalPeriod*   
Interval, dalam hari, di antara rotasi tabel. Nilai default-nya adalah `7`.

# Mengkonfigurasi, memulai, dan menghentikan replikasi log biner (binlog)
<a name="mysql-stored-proc-replicating"></a>

Anda dapat memanggil prosedur tersimpan berikut saat terhubung dengan instans primer di klaster Aurora MySQL. Prosedur ini mengontrol bagaimana transaksi direplikasi dari basis data eksternal ke Aurora MySQL, atau dari Aurora MySQL ke basis data eksternal.

**Topics**
+ [

## mysql.rds\$1disable\$1session\$1binlog (Aurora MySQL versi 2)
](#mysql_rds_disable_session_binlog)
+ [

## mysql.rds\$1enable\$1session\$1binlog (Aurora MySQL versi 2)
](#mysql_rds_enable_session_binlog)
+ [

## mysql.rds\$1import\$1binlog\$1ssl\$1material
](#mysql_rds_import_binlog_ssl_material)
+ [

## mysql.rds\$1next\$1master\$1log versi 2)
](#mysql_rds_next_master_log)
+ [

## mysql.rds\$1next\$1source\$1log (RDS )
](#mysql_rds_next_source_log)
+ [

## mysql.rds\$1remove\$1binlog\$1ssl\$1material
](#mysql_rds_remove_binlog_ssl_material)
+ [

## mysql.rds\$1reset\$1external\$1master versi 2)
](#mysql_rds_reset_external_master)
+ [

## mysql.rds\$1reset\$1external\$1source ( 3)
](#mysql_rds_reset_external_source)
+ [

## mysql.rds\$1set\$1binlog\$1source\$1ssl (Aurora MySQL versi 3)
](#mysql_rds_set_binlog_source_ssl)
+ [

## mysql.rds\$1set\$1external\$1master 2)
](#mysql_rds_set_external_master)
+ [

## mysql.rds\$1set\$1external\$1source (RDS )
](#mysql_rds_set_external_source)
+ [

## mysql.rds\$1set\$1external\$1master\$1with\$1auto\$1position (Aurora MySQL versi 2)
](#mysql_rds_set_external_master_with_auto_position)
+ [

## mysql.rds\$1set\$1external\$1source\$1with\$1auto\$1position (Aurora MySQL versi 3)
](#mysql_rds_set_external_source_with_auto_position)
+ [

## mysql.rds\$1set\$1master\$1auto\$1position (RDS )
](#mysql_rds_set_master_auto_position)
+ [

## mysql.rds\$1set\$1read\$1only (Aurora MySQL versi 3)
](#mysql_rds_set_read_only)
+ [

## mysql.rds\$1set\$1session\$1binlog\$1format (Aurora MySQL versi 2)
](#mysql_rds_set_session_binlog_format)
+ [

## mysql.rds\$1set\$1source\$1auto\$1position ( 3)
](#mysql_rds_set_source_auto_position)
+ [

## mysql.rds\$1skip\$1repl\$1error
](#mysql_rds_skip_repl_error)
+ [

## mysql.rds\$1start\$1replication
](#mysql_rds_start_replication)
+ [

## mysql.rds\$1start\$1replication\$1until (Aurora MySQL versi 3)
](#mysql_rds_start_replication_until)
+ [

## mysql.rds\$1stop\$1replication
](#mysql_rds_stop_replication)

## mysql.rds\$1disable\$1session\$1binlog (Aurora MySQL versi 2)
<a name="mysql_rds_disable_session_binlog"></a>

Menonaktifkan pencatatan log biner untuk sesi saat ini dengan mengatur variabel `sql_log_bin` ke `OFF`.

### Sintaksis
<a name="mysql_rds_disable_session_binlog-syntax"></a>

```
CALL mysql.rds_disable_session_binlog;
```

### Parameter
<a name="mysql_rds_disable_session_binlog-parameters"></a>

Tidak ada

### Catatan penggunaan
<a name="mysql_rds_disable_session_binlog-usage"></a>

Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer.

Untuk Aurora, prosedur ini didukung untuk Aurora MySQL versi 2.12 dan versi yang lebih tinggi yang kompatibel dengan MySQL 5.7.

**catatan**  
Di Aurora MySQL versi 3, Anda dapat menggunakan perintah berikut untuk menonaktifkan pencatatan log biner untuk sesi saat ini jika Anda memiliki hak istimewa `SESSION_VARIABLES_ADMIN`:  

```
SET SESSION sql_log_bin = OFF;
```

## mysql.rds\$1enable\$1session\$1binlog (Aurora MySQL versi 2)
<a name="mysql_rds_enable_session_binlog"></a>

Mengaktifkan pencatatan log biner untuk sesi saat ini dengan mengatur variabel `sql_log_bin` ke `ON`.

### Sintaksis
<a name="mysql_rds_enable_session_binlog-syntax"></a>

```
CALL mysql.rds_enable_session_binlog;
```

### Parameter
<a name="mysql_rds_enable_session_binlog-parameters"></a>

Tidak ada

### Catatan penggunaan
<a name="mysql_rds_enable_session_binlog-usage"></a>

Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer.

Untuk Aurora, prosedur ini didukung untuk Aurora MySQL versi 2.12 dan versi yang lebih tinggi yang kompatibel dengan MySQL 5.7.

**catatan**  
Di Aurora MySQL versi 3, Anda dapat menggunakan perintah berikut untuk mengaktifkan pencatatan log biner untuk sesi saat ini jika Anda memiliki hak istimewa `SESSION_VARIABLES_ADMIN`:  

```
SET SESSION sql_log_bin = ON;
```

## mysql.rds\$1import\$1binlog\$1ssl\$1material
<a name="mysql_rds_import_binlog_ssl_material"></a>

Mengimpor sertifikat otoritas sertifikat, sertifikat klien, dan kunci klien ke klaster DB Aurora MySQL. Informasi tersebut diperlukan untuk komunikasi SSL dan replikasi terenkripsi.

**catatan**  
Saat ini, prosedur ini didukung untuk Aurora MySQL versi 2:2.09.2, 2.10.0, 2.10.1, dan 2.11.0; serta versi 3:3.01.1 dan yang lebih tinggi.

### Sintaks
<a name="mysql_rds_import_binlog_ssl_material-syntax"></a>

 

```
CALL mysql.rds_import_binlog_ssl_material (
  ssl_material
);
```

### Parameter
<a name="mysql_rds_import_binlog_ssl_material-parameters"></a>

 *ssl\$1material*   
Payload JSON yang berisi konten file berformat .pem berikut untuk klien MySQL:  
+ “ssl\$1ca”:”” *Certificate authority certificate*
+ “ssl\$1cert”:”” *Client certificate*
+ “ssl\$1key”:”” *Client key*

### Catatan penggunaan
<a name="mysql_rds_import_binlog_ssl_material-usage-notes"></a>

Persiapkan untuk replikasi terenkripsi sebelum Anda menjalankan prosedur ini:
+ Jika Anda tidak memiliki SSL yang diaktifkan pada instans basis data sumber MySQL eksternal dan tidak menyiapkan kunci klien dan sertifikat klien, aktifkan SSL pada server basis data MySQL serta buat kunci klien dan sertifikat klien yang diperlukan.
+ Jika SSL diaktifkan pada instans basis data sumber eksternal, sediakan kunci dan sertifikat klien untuk klaster DB Aurora MySQL. Jika Anda tidak memilikinya, buat kunci dan sertifikat baru untuk klaster DB Aurora MySQL. Untuk menandatangani sertifikat klien, Anda harus memiliki kunci otoritas sertifikat yang Anda gunakan untuk mengonfigurasi SSL pada instans basis data sumber MySQL eksternal.

Untuk informasi selengkapnya, lihat [Creating SSL certificates and keys using openssl](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-files-using-openssl.html) dalam dokumentasi MySQL.

**penting**  
Setelah Anda mempersiapkan replikasi terenkripsi, gunakan koneksi SSL untuk menjalankan prosedur ini. Kunci klien tidak boleh ditransfer melalui koneksi yang tidak aman. 

Prosedur ini mengimpor informasi SSL dari basis data MySQL eksternal ke klaster DB Aurora MySQL. Informasi SSL dalam file berformat .pem yang berisi informasi SSL untuk klaster DB Aurora MySQL. Selama replikasi terenkripsi, klaster DB Aurora MySQL berperan sebagai klien untuk server basis data MySQL. Sertifikat dan kunci untuk klien Aurora MySQL ada di dalam file berformat .pem.

Anda dapat menyalin informasi dari file ini ke dalam parameter `ssl_material` dalam payload JSON yang benar. Untuk mendukung replikasi terenkripsi, impor informasi SSL ini ke klaster DB Aurora MySQL.

Payload JSON harus dalam format berikut.

```
'{"ssl_ca":"-----BEGIN CERTIFICATE-----
ssl_ca_pem_body_code
-----END CERTIFICATE-----\n","ssl_cert":"-----BEGIN CERTIFICATE-----
ssl_cert_pem_body_code
-----END CERTIFICATE-----\n","ssl_key":"-----BEGIN RSA PRIVATE KEY-----
ssl_key_pem_body_code
-----END RSA PRIVATE KEY-----\n"}'
```

### Contoh
<a name="mysql_rds_import_binlog_ssl_material-examples"></a>

Contoh berikut mengimpor informasi SSL ke Aurora MySQL. Dalam file berformat .pem, kode konten biasanya lebih panjang dari kode konten yang ditunjukkan dalam contoh.

```
call mysql.rds_import_binlog_ssl_material(
'{"ssl_ca":"-----BEGIN CERTIFICATE-----
AAAAB3NzaC1yc2EAAAADAQABAAABAQClKsfkNkuSevGj3eYhCe53pcjqP3maAhDFcvBS7O6V
hz2ItxCih+PnDSUaw+WNQn/mZphTk/a/gU8jEzoOWbkM4yxyb/wB96xbiFveSFJuOp/d6RJhJOI0iBXr
lsLnBItntckiJ7FbtxJMXLvvwJryDUilBMTjYtwB+QhYXUMOzce5Pjz5/i8SeJtjnV3iAoG/cQk+0FzZ
qaeJAAHco+CY/5WrUBkrHmFJr6HcXkvJdWPkYQS3xqC0+FmUZofz221CBt5IMucxXPkX4rWi+z7wB3Rb
BQoQzd8v7yeb7OzlPnWOyN0qFU0XA246RA8QFYiCNYwI3f05p6KLxEXAMPLE
-----END CERTIFICATE-----\n","ssl_cert":"-----BEGIN CERTIFICATE-----
AAAAB3NzaC1yc2EAAAADAQABAAABAQClKsfkNkuSevGj3eYhCe53pcjqP3maAhDFcvBS7O6V
hz2ItxCih+PnDSUaw+WNQn/mZphTk/a/gU8jEzoOWbkM4yxyb/wB96xbiFveSFJuOp/d6RJhJOI0iBXr
lsLnBItntckiJ7FbtxJMXLvvwJryDUilBMTjYtwB+QhYXUMOzce5Pjz5/i8SeJtjnV3iAoG/cQk+0FzZ
qaeJAAHco+CY/5WrUBkrHmFJr6HcXkvJdWPkYQS3xqC0+FmUZofz221CBt5IMucxXPkX4rWi+z7wB3Rb
BQoQzd8v7yeb7OzlPnWOyN0qFU0XA246RA8QFYiCNYwI3f05p6KLxEXAMPLE
-----END CERTIFICATE-----\n","ssl_key":"-----BEGIN RSA PRIVATE KEY-----
AAAAB3NzaC1yc2EAAAADAQABAAABAQClKsfkNkuSevGj3eYhCe53pcjqP3maAhDFcvBS7O6V
hz2ItxCih+PnDSUaw+WNQn/mZphTk/a/gU8jEzoOWbkM4yxyb/wB96xbiFveSFJuOp/d6RJhJOI0iBXr
lsLnBItntckiJ7FbtxJMXLvvwJryDUilBMTjYtwB+QhYXUMOzce5Pjz5/i8SeJtjnV3iAoG/cQk+0FzZ
qaeJAAHco+CY/5WrUBkrHmFJr6HcXkvJdWPkYQS3xqC0+FmUZofz221CBt5IMucxXPkX4rWi+z7wB3Rb
BQoQzd8v7yeb7OzlPnWOyN0qFU0XA246RA8QFYiCNYwI3f05p6KLxEXAMPLE
-----END RSA PRIVATE KEY-----\n"}');
```

## mysql.rds\$1next\$1master\$1log versi 2)
<a name="mysql_rds_next_master_log"></a>

Mengubah posisi log instans basis data sumber menjadi awal log biner berikutnya pada instans basis data sumber. Gunakan prosedur ini hanya jika Anda menerima I/O kesalahan replikasi 1236 pada replika baca.

### Sintaks
<a name="mysql_rds_next_master_log-syntax"></a>

 

```
CALL mysql.rds_next_master_log(
curr_master_log
);
```

### Parameter
<a name="mysql_rds_next_master_log-parameters"></a>

 *curr\$1master\$1log*   
Indeks file log master saat ini. Misalnya, jika file saat ini bernama `mysql-bin-changelog.012345`, maka indeksnya adalah 12345. Untuk menentukan nama file log master saat ini, jalankan perintah `SHOW REPLICA STATUS` dan lihat kolom `Master_Log_File`.

### Catatan penggunaan
<a name="mysql_rds_next_master_log-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_next_master_log`. 

**Awas**  
Panggil `mysql.rds_next_master_log` hanya jika replikasi gagal setelah failover instans DB multi-AZ yang merupakan sumber replikasi, dan `Last_IO_Errno` bidang laporan kesalahan 1236. `SHOW REPLICA STATUS` I/O   
Memanggil `mysql.rds_next_master_log` ​​dapat mengakibatkan hilangnya data di replika baca jika transaksi dalam instans sumber tidak ditulis ke log biner di disk sebelum peristiwa failover terjadi. 

### Contoh
<a name="mysql_rds_next_master_log-examples"></a>

Asumsikan replikasi gagal pada replika baca Aurora MySQL. Menjalankan `SHOW REPLICA STATUS\G` pada replika baca akan menampilkan hasil berikut:

```
*************************** 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
```

Kolom `Last_IO_Errno` menunjukkan bahwa instans menerima kesalahan I/O 1236. Kolom `Master_Log_File` menunjukkan bahwa nama file adalah `mysql-bin-changelog.012345`, yang berarti indeks file log adalah `12345`. Untuk mengatasi kesalahan, Anda dapat memanggil `mysql.rds_next_master_log` dengan parameter berikut:

```
CALL mysql.rds_next_master_log(12345);
```

## mysql.rds\$1next\$1source\$1log (RDS )
<a name="mysql_rds_next_source_log"></a>

Mengubah posisi log instans basis data sumber menjadi awal log biner berikutnya pada instans basis data sumber. Gunakan prosedur ini hanya jika Anda menerima I/O kesalahan replikasi 1236 pada replika baca.

### Sintaks
<a name="mysql_rds_next_source_log-syntax"></a>

 

```
CALL mysql.rds_next_source_log(
curr_source_log
);
```

### Parameter
<a name="mysql_rds_next_source_log-parameters"></a>

 *curr\$1source\$1log*   
Indeks file log sumber saat ini. Misalnya, jika file saat ini bernama `mysql-bin-changelog.012345`, maka indeksnya adalah 12345. Untuk menentukan nama file log sumber saat ini, jalankan perintah `SHOW REPLICA STATUS` dan lihat kolom `Source_Log_File`.

### Catatan penggunaan
<a name="mysql_rds_next_source_log-usage-notes"></a>

Pengguna administratif harus menjalankan prosedur `mysql.rds_next_source_log`. 

**Awas**  
Panggil `mysql.rds_next_source_log` hanya jika replikasi gagal setelah failover instans DB multi-AZ yang merupakan sumber replikasi, dan `Last_IO_Errno` bidang laporan kesalahan 1236. `SHOW REPLICA STATUS` I/O   
Memanggil `mysql.rds_next_source_log` ​​dapat mengakibatkan hilangnya data di replika baca jika transaksi dalam instans sumber tidak ditulis ke log biner di disk sebelum peristiwa failover terjadi. Anda dapat mengurangi kemungkinan hal ini terjadi dengan menyetel parameter instance sumber `sync_binlog` dan `innodb_support_xa` ke`1`, meskipun ini dapat mengurangi kinerja. 

### Contoh
<a name="mysql_rds_next_source_log-examples"></a>

Asumsikan replikasi gagal pada replika baca Aurora MySQL. Menjalankan `SHOW REPLICA STATUS\G` pada replika baca akan menampilkan hasil berikut:

```
*************************** 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
```

Kolom `Last_IO_Errno` menunjukkan bahwa instans menerima kesalahan I/O 1236. Kolom `Source_Log_File` menunjukkan bahwa nama file adalah `mysql-bin-changelog.012345`, yang berarti indeks file log adalah `12345`. Untuk mengatasi kesalahan, Anda dapat memanggil `mysql.rds_next_source_log` dengan parameter berikut:

```
CALL mysql.rds_next_source_log(12345);
```

## mysql.rds\$1remove\$1binlog\$1ssl\$1material
<a name="mysql_rds_remove_binlog_ssl_material"></a>

Menghapus sertifikat otoritas sertifikat, sertifikat klien, dan kunci klien untuk komunikasi SSL dan replikasi terenkripsi. Informasi ini diimpor menggunakan [mysql.rds\$1import\$1binlog\$1ssl\$1material](#mysql_rds_import_binlog_ssl_material).

### Sintaksis
<a name="mysql_rds_remove_binlog_ssl_material-syntax"></a>

 

```
CALL mysql.rds_remove_binlog_ssl_material;
```

## mysql.rds\$1reset\$1external\$1master versi 2)
<a name="mysql_rds_reset_external_master"></a>

Mengonfigurasi ulang instans DB Aurora MySQL agar tidak lagi menjadi replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

**penting**  
Untuk menjalankan prosedur ini, `autocommit` harus diaktifkan. Untuk mengaktifkannya, atur parameter `autocommit` ke `1`. Lihat informasi tentang cara mengubah parameter di [Memodifikasi parameter dalam grup parameter DB di ](USER_WorkingWithParamGroups.Modifying.md).

### Sintaks
<a name="mysql_rds_reset_external_master-syntax"></a>

 

```
CALL mysql.rds_reset_external_master;
```

### Catatan penggunaan
<a name="mysql_rds_reset_external_master-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_reset_external_master`. Prosedur ini harus dijalankan pada instans DB MySQL agar dihapus sebagai replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

**catatan**  
Kami menawarkan prosedur tersimpan ini terutama untuk mengaktifkan replikasi dengan instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda menggunakan Aurora Replicas untuk mengelola replikasi dalam klaster DB Aurora MySQL jika memungkinkan. Untuk informasi tentang cara mengelola replikasi di klaster DB Aurora MySQL, lihat [Menggunakan Replika Aurora](AuroraMySQL.Replication.md#AuroraMySQL.Replication.Replicas).

Untuk informasi selengkapnya tentang cara menggunakan replikasi untuk mengimpor data dari instans MySQL yang berjalan di luar Aurora MySQL, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md).

## mysql.rds\$1reset\$1external\$1source ( 3)
<a name="mysql_rds_reset_external_source"></a>

Mengonfigurasi ulang instans DB Aurora MySQL agar tidak lagi menjadi replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

**penting**  
Untuk menjalankan prosedur ini, `autocommit` harus diaktifkan. Untuk mengaktifkannya, atur parameter `autocommit` ke `1`. Lihat informasi tentang cara mengubah parameter di [Memodifikasi parameter dalam grup parameter DB di ](USER_WorkingWithParamGroups.Modifying.md).

### Sintaks
<a name="mysql_rds_reset_external_source-syntax"></a>

 

```
CALL mysql.rds_reset_external_source;
```

### Catatan penggunaan
<a name="mysql_rds_reset_external_source-usage-notes"></a>

Pengguna administratif harus menjalankan prosedur `mysql.rds_reset_external_source`. Prosedur ini harus dijalankan pada instans DB MySQL agar dihapus sebagai replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

**catatan**  
Kami menawarkan prosedur tersimpan ini terutama untuk mengaktifkan replikasi dengan instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda menggunakan Aurora Replicas untuk mengelola replikasi dalam klaster DB Aurora MySQL jika memungkinkan. Untuk informasi tentang cara mengelola replikasi di klaster DB Aurora MySQL, lihat [Menggunakan Replika Aurora](AuroraMySQL.Replication.md#AuroraMySQL.Replication.Replicas).

## mysql.rds\$1set\$1binlog\$1source\$1ssl (Aurora MySQL versi 3)
<a name="mysql_rds_set_binlog_source_ssl"></a>

Mengaktifkan `SOURCE_SSL` enkripsi untuk replikasi binlog. Untuk informasi selengkapnya, lihat [MENGUBAH SUMBER REPLIKASI KE pernyataan](https://dev.mysql.com/doc/refman/8.0/en/change-replication-source-to.html) dalam dokumentasi MySQL.

### Sintaks
<a name="mysql_rds_set_binlog_source_ssl-syntax"></a>

```
CALL mysql.rds_set_binlog_source_ssl(mode);
```

### Parameter
<a name="mysql_rds_set_binlog_source_ssl-parameters"></a>

*mode*  
Nilai yang menunjukkan apakah `SOURCE_SSL` enkripsi diaktifkan:  
+ `0`— `SOURCE_SSL` enkripsi dinonaktifkan. Nilai default-nya `0`.
+ `1`— `SOURCE_SSL` enkripsi diaktifkan. Anda dapat mengonfigurasi enkripsi menggunakan SSL atau TLS.

### Catatan penggunaan
<a name="mysql_rds_set_binlog_source_ssl-usage"></a>

Prosedur ini didukung untuk Aurora MySQL versi 3.06 dan lebih tinggi.

## mysql.rds\$1set\$1external\$1master 2)
<a name="mysql_rds_set_external_master"></a>

Mengonfigurasi instans DB Aurora MySQL agar tidak lagi menjadi replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

Prosedur `mysql.rds_set_external_master` tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan `mysql.rds\$1set\$1external\$1source` sebagai gantinya.

**penting**  
Untuk menjalankan prosedur ini, `autocommit` harus diaktifkan. Untuk mengaktifkannya, atur parameter `autocommit` ke `1`. Lihat informasi tentang cara mengubah parameter di [Memodifikasi parameter dalam grup parameter DB di ](USER_WorkingWithParamGroups.Modifying.md).

### Sintaks
<a name="mysql_rds_set_external_master-syntax"></a>

 

```
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
);
```

### Parameter
<a name="mysql_rds_set_external_master-parameters"></a>

 *host\$1name*   
Nama host atau alamat IP instans MySQL yang berjalan di luar Amazon RDS untuk menjadi instans basis data sumber.

 *host\$1port*   
Port yang digunakan oleh instans MySQL yang berjalan di luar Amazon RDS untuk dikonfigurasi sebagai instans basis data sumber. Jika konfigurasi jaringan Anda mencakup replikasi port Secure Shell (SSH) yang mengubah nomor port, tentukan nomor port yang diekspos oleh SSH.

 *replication\$1user\$1name*   
ID pengguna dengan izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda memberikan akun yang digunakan sepenuhnya untuk replikasi dengan instans eksternal.

 *replication\$1user\$1password*   
Kata sandi ID pengguna yang ditentukan dalam `replication_user_name`.

 *mysql\$1binary\$1log\$1file\$1name*   
Nama log biner pada instans basis data sumber yang berisi informasi replikasi.

 *mysql\$1binary\$1log\$1file\$1location*   
Lokasi di log biner `mysql_binary_log_file_name` tempat replikasi mulai membaca informasi replikasi.  
Anda dapat menentukan nama dan lokasi file binlog dengan menjalankan `SHOW MASTER STATUS` pada instans basis data sumber.

 *ssl\$1encryption*   
Nilai yang menentukan apakah enkripsi Lapisan Soket Aman (SSL) digunakan pada sambungan replikasi. 1 menentukan untuk menggunakan enkripsi SSL, 0 menentukan untuk tidak menggunakan enkripsi. Default-nya adalah 0.  
Opsi `MASTER_SSL_VERIFY_SERVER_CERT` tidak didukung. Opsi ini diatur ke 0, yang berarti koneksi dienkripsi, tetapi sertifikat tidak diverifikasi.

### Catatan penggunaan
<a name="mysql_rds_set_external_master-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_set_external_master`. Prosedur ini harus dijalankan pada instans DB MySQL untuk dikonfigurasi sebagai replika baca dari instans MySQL yang berjalan di luar Amazon RDS. 

Sebelum menjalankan `mysql.rds_set_external_master`, Anda harus mengonfigurasi instans MySQL yang berjalan di luar Amazon RDS menjadi instans basis data sumber. Untuk terhubung ke instans MySQL yang berjalan di luar Amazon RDS, Anda harus menentukan nilai `replication_user_name` dan `replication_user_password` yang menunjukkan pengguna replikasi yang memiliki izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans eksternal MySQL. 

**Untuk mengonfigurasi instans ​​eksternal MySQL sebagai instans basis data sumber**

1. Dengan menggunakan klien MySQL pilihan Anda, hubungkan ke instans eksternal MySQL dan buat akun pengguna yang akan digunakan untuk replikasi. Berikut adalah contohnya.

   **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';
   ```
**catatan**  
Tetapkan kata sandi selain penggugah (prompt) yang ditampilkan di sini sebagai praktik terbaik keamanan.

1. Pada instans eksternal MySQL, berikan hak istimewa `REPLICATION CLIENT` dan `REPLICATION SLAVE` kepada pengguna replikasi Anda. Contoh berikut memberikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada semua basis data untuk pengguna ‘repl\$1user’ domain Anda.

   **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';
   ```

Untuk menggunakan replikasi terenkripsi, konfigurasikan instans basis data sumber untuk menggunakan koneksi SSL. Selain itu, impor sertifikat otoritas sertifikat, sertifikat klien, dan kunci klien ke dalam instans DB atau klaster DB menggunakan prosedur [mysql.rds\$1import\$1binlog\$1ssl\$1material](#mysql_rds_import_binlog_ssl_material).

**catatan**  
Kami menawarkan prosedur tersimpan ini terutama untuk mengaktifkan replikasi dengan instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda menggunakan Aurora Replicas untuk mengelola replikasi dalam klaster DB Aurora MySQL jika memungkinkan. Untuk informasi tentang cara mengelola replikasi di klaster DB Aurora MySQL, lihat [Menggunakan Replika Aurora](AuroraMySQL.Replication.md#AuroraMySQL.Replication.Replicas).

Setelah memanggil `mysql.rds_set_external_master` ​​untuk mengonfigurasi instans DB Amazon RDS sebagai replika baca, Anda dapat memanggil [mysql.rds\$1start\$1replication](#mysql_rds_start_replication) pada replika baca untuk memulai proses replikasi. Anda dapat memanggil [mysql.rds\$1reset\$1external\$1master versi 2)](#mysql_rds_reset_external_master) ​​untuk menghapus konfigurasi replika baca.

Saat `mysql.rds_set_external_master` dipanggil, Amazon RDS mencatat waktu, pengguna, dan tindakan `set master` di tabel `mysql.rds_history` dan `mysql.rds_replication_status`.

### Contoh
<a name="mysql_rds_set_external_master-examples"></a>

Ketika dijalankan pada instans DB MySQL, contoh berikut mengonfigurasi instans DB menjadi replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

```
call mysql.rds_set_external_master(
  'Externaldb.some.com',
  3306,
  'repl_user',
  'password',
  'mysql-bin-changelog.0777',
  120,
  1);
```

## mysql.rds\$1set\$1external\$1source (RDS )
<a name="mysql_rds_set_external_source"></a>

Mengonfigurasi instans DB Aurora MySQL agar tidak lagi menjadi replika baca dari instans MySQL yang berjalan di luar Amazon RDS.

**penting**  
Untuk menjalankan prosedur ini, `autocommit` harus diaktifkan. Untuk mengaktifkannya, atur parameter `autocommit` ke `1`. Lihat informasi tentang cara mengubah parameter di [Memodifikasi parameter dalam grup parameter DB di ](USER_WorkingWithParamGroups.Modifying.md).

### Sintaks
<a name="mysql_rds_set_external_source-syntax"></a>

 

```
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
);
```

### Parameter
<a name="mysql_rds_set_external_source-parameters"></a>

 *host\$1name*   
Nama host atau alamat IP instans MySQL yang berjalan di luar Amazon RDS untuk menjadi instans basis data sumber.

 *host\$1port*   
Port yang digunakan oleh instans MySQL yang berjalan di luar Amazon RDS untuk dikonfigurasi sebagai instans basis data sumber. Jika konfigurasi jaringan Anda mencakup replikasi port Secure Shell (SSH) yang mengubah nomor port, tentukan nomor port yang diekspos oleh SSH.

 *replication\$1user\$1name*   
ID pengguna dengan izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda memberikan akun yang digunakan sepenuhnya untuk replikasi dengan instans eksternal.

 *replication\$1user\$1password*   
Kata sandi ID pengguna yang ditentukan dalam `replication_user_name`.

 *mysql\$1binary\$1log\$1file\$1name*   
Nama log biner pada instans basis data sumber yang berisi informasi replikasi.

 *mysql\$1binary\$1log\$1file\$1location*   
Lokasi di log biner `mysql_binary_log_file_name` tempat replikasi mulai membaca informasi replikasi.  
Anda dapat menentukan nama dan lokasi file binlog dengan menjalankan `SHOW MASTER STATUS` pada instans basis data sumber.

 *ssl\$1encryption*   
Nilai yang menentukan apakah enkripsi Lapisan Soket Aman (SSL) digunakan pada sambungan replikasi. 1 menentukan untuk menggunakan enkripsi SSL, 0 menentukan untuk tidak menggunakan enkripsi. Standarnya adalah 0.  
Anda harus telah mengimpor sertifikat SSL khusus menggunakan [mysql.rds\$1import\$1binlog\$1ssl\$1material](#mysql_rds_import_binlog_ssl_material) untuk mengaktifkan opsi ini. Jika Anda belum mengimpor sertifikat SSL kustom, maka atur parameter ini ke 0 dan gunakan untuk mengaktifkan SSL [mysql.rds\$1set\$1binlog\$1source\$1ssl (Aurora MySQL versi 3)](#mysql_rds_set_binlog_source_ssl) untuk replikasi log biner.  
Opsi `SOURCE_SSL_VERIFY_SERVER_CERT` tidak didukung. Opsi ini diatur ke 0, yang berarti koneksi dienkripsi, tetapi sertifikat tidak diverifikasi.

### Catatan penggunaan
<a name="mysql_rds_set_external_source-usage-notes"></a>

Pengguna administratif harus menjalankan prosedur `mysql.rds_set_external_source`. Prosedur ini harus dijalankan pada Aurora MySQL agar instance MySQL DB dikonfigurasi sebagai replika baca instance MySQL yang berjalan di luar Amazon RDS. 

 Sebelum menjalankan `mysql.rds_set_external_source`, Anda harus mengonfigurasi instans MySQL yang berjalan di luar Amazon RDS menjadi instans basis data sumber. Untuk terhubung ke instans MySQL yang berjalan di luar Amazon RDS, Anda harus menentukan nilai `replication_user_name` dan `replication_user_password` yang menunjukkan pengguna replikasi yang memiliki izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans eksternal MySQL.

**Untuk mengonfigurasi instans ​​eksternal MySQL sebagai instans basis data sumber**

1. Dengan menggunakan klien MySQL pilihan Anda, hubungkan ke instans eksternal MySQL dan buat akun pengguna yang akan digunakan untuk replikasi. Berikut sebuah contoh.

   ```
   CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'password';
   ```
**catatan**  
Tetapkan kata sandi selain penggugah (prompt) yang ditampilkan di sini sebagai praktik terbaik keamanan.

1. Pada instans eksternal MySQL, berikan hak istimewa `REPLICATION CLIENT` dan `REPLICATION SLAVE` kepada pengguna replikasi Anda. Contoh berikut memberikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada semua basis data untuk pengguna ‘repl\$1user’ domain Anda.

   ```
   GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com';
   ```

Untuk menggunakan replikasi terenkripsi, konfigurasikan instans basis data sumber untuk menggunakan koneksi SSL. Selain itu, impor sertifikat otoritas sertifikat, sertifikat klien, dan kunci klien ke dalam instans DB atau klaster DB menggunakan prosedur [mysql.rds\$1import\$1binlog\$1ssl\$1material](url-rds-user;mysql_rds_import_binlog_ssl_material.html).

**catatan**  
Kami menawarkan prosedur tersimpan ini terutama untuk mengaktifkan replikasi dengan instans MySQL yang berjalan di luar Amazon RDS. Kami menyarankan Anda menggunakan Aurora Replicas untuk mengelola replikasi dalam klaster DB Aurora MySQL jika memungkinkan. Untuk informasi tentang cara mengelola replikasi di klaster DB Aurora MySQL, lihat [Menggunakan Replika Aurora](AuroraMySQL.Replication.md#AuroraMySQL.Replication.Replicas).

Setelah memanggil `mysql.rds_set_external_source` untuk mengkonfigurasi Aurora MySQL  DB instance sebagai replika baca, Anda dapat memanggil replika baca untuk memulai proses replikasi. [mysql.rds\$1start\$1replication](#mysql_rds_start_replication) Anda dapat memanggil [mysql.rds\$1reset\$1external\$1source ( 3)](#mysql_rds_reset_external_source) ​​untuk menghapus konfigurasi replika baca.

Saat `mysql.rds_set_external_source` dipanggil, Amazon RDS mencatat waktu, pengguna, dan tindakan `set master` di tabel `mysql.rds_history` dan `mysql.rds_replication_status`.

### Contoh
<a name="mysql_rds_set_external_source-examples"></a>

Ketika dijalankan pada Aurora MySQL  DB, contoh berikut mengonfigurasi instans DB menjadi replika baca dari instance MySQL yang berjalan eksternal ke Amazon RDS.

```
call mysql.rds_set_external_source(
  'Externaldb.some.com',
  3306,
  'repl_user',
  'password',
  'mysql-bin-changelog.0777',
  120,
  1);
```

## mysql.rds\$1set\$1external\$1master\$1with\$1auto\$1position (Aurora MySQL versi 2)
<a name="mysql_rds_set_external_master_with_auto_position"></a>

Mengonfigurasi instans primer Aurora MySQL untuk menerima replikasi masuk dari instans MySQL eksternal. Prosedur ini juga mengonfigurasi replikasi berdasarkan pengidentifikasi transaksi global (). GTIDs

Prosedur ini tidak mengonfigurasi replikasi tertunda, karena Aurora MySQL tidak mendukung replikasi tertunda.

### Sintaksis
<a name="mysql_rds_set_external_master_with_auto_position-syntax"></a>

```
CALL mysql.rds_set_external_master_with_auto_position (
  host_name
  , host_port
  , replication_user_name
  , replication_user_password
  , ssl_encryption
);
```

### Parameter
<a name="mysql_rds_set_external_master_with_auto_position-parameters"></a>

*host\$1name*  
 Nama host atau alamat IP instans MySQL yang berjalan di luar Aurora untuk menjadi sumber replikasi. 

*host\$1port*  
 Port yang digunakan oleh instans MySQL yang berjalan di luar Aurora untuk dikonfigurasi sebagai sumber replikasi. Jika konfigurasi jaringan Anda mencakup replikasi port Secure Shell (SSH) yang mengubah nomor port, tentukan nomor port yang diekspos oleh SSH. 

*replication\$1user\$1name*  
 ID pengguna dengan izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL yang berjalan di luar Aurora. Kami menyarankan Anda memberikan akun yang digunakan sepenuhnya untuk replikasi dengan instans eksternal. 

*replication\$1user\$1password*  
Kata sandi ID pengguna yang ditentukan dalam `replication_user_name`.

*ssl\$1encryption*  
Opsi ini belum diterapkan. Default-nya adalah 0.

### Catatan penggunaan
<a name="mysql_rds_set_external_master_with_auto_position-usage-notes"></a>

Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer.

Pengguna utama harus menjalankan prosedur `mysql.rds_set_external_master_with_auto_position`. Pengguna utama menjalankan prosedur ini pada instans primer dari klaster DB Aurora MySQL yang bertindak sebagai target replikasi. Ini dapat menjadi target replikasi dari instans DB MySQL eksternal atau klaster DB Aurora MySQL.

Prosedur ini didukung untuk Aurora MySQL versi 2. Untuk Aurora MySQL versi 3, gunakan prosedur [mysql.rds\$1set\$1external\$1source\$1with\$1auto\$1position (Aurora MySQL versi 3)](#mysql_rds_set_external_source_with_auto_position) sebagai gantinya.

Sebelum Anda menjalankan `mysql.rds_set_external_master_with_auto_position`, konfigurasikan instans DB MySQL eksternal menjadi sumber replikasi. Agar terhubung ke instans MySQL eksternal, tentukan nilai untuk `replication_user_name` dan `replication_user_password`. Nilai-nilai ini harus menunjukkan pengguna replikasi yang memiliki izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL eksternal.

**Untuk mengonfigurasi instans MySQL eksternal sebagai sumber replikasi**

1. Dengan menggunakan klien MySQL pilihan Anda, hubungkan ke instans MySQL eksternal dan buat akun pengguna yang akan digunakan untuk replikasi. Berikut adalah contohnya.

   ```
   CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
   ```

1. Pada instans MySQL eksternal, berikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` kepada pengguna replikasi Anda. Contoh berikut memberikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada semua basis data untuk pengguna `'repl_user'` domain Anda.

   ```
   GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
   IDENTIFIED BY 'SomePassW0rd'
   ```

Saat Anda memanggil `mysql.rds_set_external_master_with_auto_position`, Amazon RDS mencatat informasi tertentu. Informasi ini adalah waktu, pengguna, dan tindakan `"set master"` di tabel `mysql.rds_history` dan `mysql.rds_replication_status`.

Untuk melewati transaksi berbasis GTID tertentu yang diketahui menyebabkan masalah, Anda dapat menggunakan prosedur tersimpan [mysql.rds\$1skip\$1transaction\$1with\$1gtid (Aurora MySQL versi 2 dan 3)](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid). Untuk informasi selengkapnya tentang cara menggunakan replikasi berbasis GTID, lihat [Menggunakan replikasi GTID berbasis](mysql-replication-gtid.md).

### Contoh
<a name="mysql_rds_set_external_master_with_auto_position-examples"></a>

 Saat menjalankan di instans primer Aurora, contoh berikut mengonfigurasi klaster Aurora untuk bertindak sebagai replika baca dari instans MySQL yang berjalan di luar Aurora. 

```
call mysql.rds_set_external_master_with_auto_position(
  'Externaldb.some.com',
  3306,
  'repl_user'@'mydomain.com',
  'SomePassW0rd');
```

## mysql.rds\$1set\$1external\$1source\$1with\$1auto\$1position (Aurora MySQL versi 3)
<a name="mysql_rds_set_external_source_with_auto_position"></a>

Mengonfigurasi instans primer Aurora MySQL untuk menerima replikasi masuk dari instans MySQL eksternal. Prosedur ini juga mengonfigurasi replikasi berdasarkan pengidentifikasi transaksi global (). GTIDs

### Sintaks
<a name="mysql_rds_set_external_source_with_auto_position-syntax"></a>

```
CALL mysql.rds_set_external_source_with_auto_position (
  host_name
  , host_port
  , replication_user_name
  , replication_user_password
  , ssl_encryption
);
```

### Parameter
<a name="mysql_rds_set_external_source_with_auto_position-parameters"></a>

*host\$1name*  
 Nama host atau alamat IP instans MySQL yang berjalan di luar Aurora untuk menjadi sumber replikasi. 

*host\$1port*  
 Port yang digunakan oleh instans MySQL yang berjalan di luar Aurora untuk dikonfigurasi sebagai sumber replikasi. Jika konfigurasi jaringan Anda mencakup replikasi port Secure Shell (SSH) yang mengubah nomor port, tentukan nomor port yang diekspos oleh SSH. 

*replication\$1user\$1name*  
 ID pengguna dengan izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL yang berjalan di luar Aurora. Kami menyarankan Anda memberikan akun yang digunakan sepenuhnya untuk replikasi dengan instans eksternal. 

*replication\$1user\$1password*  
 Kata sandi ID pengguna yang ditentukan dalam `replication_user_name`. 

*ssl\$1encryption*  
Opsi ini belum diterapkan. Default-nya adalah 0.  
Gunakan [mysql.rds\$1set\$1binlog\$1source\$1ssl (Aurora MySQL versi 3)](#mysql_rds_set_binlog_source_ssl) untuk mengaktifkan SSL untuk replikasi log biner.

### Catatan penggunaan
<a name="mysql_rds_set_external_source_with_auto_position-usage-notes"></a>

 Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer. 

 Pengguna administratif harus menjalankan prosedur `mysql.rds_set_external_source_with_auto_position`. Pengguna administratif menjalankan prosedur ini pada instans primer dari klaster DB Aurora MySQL yang bertindak sebagai target replikasi. Ini dapat menjadi target replikasi dari instans DB MySQL eksternal atau klaster DB Aurora MySQL. 

Prosedur ini didukung untuk Aurora MySQL versi 3. Prosedur ini tidak mengonfigurasi replikasi tertunda, karena Aurora MySQL tidak mendukung replikasi tertunda.

 Sebelum Anda menjalankan `mysql.rds_set_external_source_with_auto_position`, konfigurasikan instans DB MySQL eksternal menjadi sumber replikasi. Agar terhubung ke instans MySQL eksternal, tentukan nilai untuk `replication_user_name` dan `replication_user_password`. Nilai-nilai ini harus menunjukkan pengguna replikasi yang memiliki izin `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada instans MySQL eksternal. 

**Untuk mengonfigurasi instans MySQL eksternal sebagai sumber replikasi**

1.  Dengan menggunakan klien MySQL pilihan Anda, hubungkan ke instans MySQL eksternal dan buat akun pengguna yang akan digunakan untuk replikasi. Berikut adalah contohnya. 

   ```
   CREATE USER 'repl_user'@'mydomain.com' IDENTIFIED BY 'SomePassW0rd'
   ```

1.  Pada instans MySQL eksternal, berikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` kepada pengguna replikasi Anda. Contoh berikut memberikan hak akses `REPLICATION CLIENT` dan `REPLICATION SLAVE` pada semua basis data untuk pengguna `'repl_user'` domain Anda. 

   ```
   GRANT REPLICATION CLIENT, REPLICATION SLAVE ON *.* TO 'repl_user'@'mydomain.com'
   IDENTIFIED BY 'SomePassW0rd'
   ```

 Saat Anda memanggil `mysql.rds_set_external_source_with_auto_position`, Amazon RDS mencatat informasi tertentu. Informasi ini adalah waktu, pengguna, dan tindakan `"set master"` di tabel `mysql.rds_history` dan `mysql.rds_replication_status`. 

 Untuk melewati transaksi berbasis GTID tertentu yang diketahui menyebabkan masalah, Anda dapat menggunakan prosedur tersimpan [mysql.rds\$1skip\$1transaction\$1with\$1gtid (Aurora MySQL versi 2 dan 3)](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid). Untuk informasi selengkapnya tentang cara menggunakan replikasi berbasis GTID, lihat [Menggunakan replikasi GTID berbasis](mysql-replication-gtid.md). 

### Contoh
<a name="mysql_rds_set_external_source_with_auto_position-examples"></a>

 Saat menjalankan di instans primer Aurora, contoh berikut mengonfigurasi klaster Aurora untuk bertindak sebagai replika baca dari instans MySQL yang berjalan di luar Aurora. 

```
call mysql.rds_set_external_source_with_auto_position(
  'Externaldb.some.com',
  3306,
  'repl_user'@'mydomain.com',
  'SomePassW0rd');
```

## mysql.rds\$1set\$1master\$1auto\$1position (RDS )
<a name="mysql_rds_set_master_auto_position"></a>

Menetapkan mode replikasi untuk didasarkan pada posisi file log biner atau pada pengidentifikasi transaksi global ()GTIDs.

### Sintaks
<a name="mysql_rds_set_master_auto_position-syntax"></a>

 

```
CALL mysql.rds_set_master_auto_position (
auto_position_mode
);
```

### Parameter
<a name="mysql_rds_set_master_auto_position-parameters"></a>

 *auto\$1position\$1mode*   
Nilai yang menunjukkan apakah akan menggunakan replikasi posisi file log atau replikasi berbasis GTID:  
+ `0` – Gunakan metode replikasi berdasarkan posisi file log biner. Nilai default-nya `0`.
+ `1` – Gunakan metode replikasi berbasis GTID.

### Catatan penggunaan
<a name="mysql_rds_set_master_auto_position-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_set_master_auto_position`.

Prosedur ini didukung untuk Aurora MySQL versi 2.

## mysql.rds\$1set\$1read\$1only (Aurora MySQL versi 3)
<a name="mysql_rds_set_read_only"></a>

Menghidupkan atau menonaktifkan `read_only` mode secara global untuk instans DB.

### Sintaks
<a name="mysql_rds_set_read_only-syntax"></a>

```
CALL mysql.rds_set_read_only(mode);
```

### Parameter
<a name="mysql_rds_set_read_only-parameters"></a>

*mode*  
Nilai yang menunjukkan apakah `read_only` mode aktif atau tidak aktif secara global untuk instans DB:  
+ `0`—`OFF`. Defaultnya adalah`0`.
+ `1` – `ON`

### Catatan penggunaan
<a name="mysql_rds_set_read_only-usage"></a>

Prosedur yang `mysql.rds_set_read_only` disimpan hanya memodifikasi `read_only` parameter. `innodb_read_only`Parameter tidak dapat diubah pada instans DB pembaca.

Perubahan `read_only` parameter tidak bertahan saat reboot. Untuk membuat perubahan permanen`read_only`, Anda harus menggunakan parameter cluster `read_only` DB.

Prosedur ini didukung untuk Aurora MySQL versi 3.06 dan lebih tinggi.

## mysql.rds\$1set\$1session\$1binlog\$1format (Aurora MySQL versi 2)
<a name="mysql_rds_set_session_binlog_format"></a>

Mengatur format log biner untuk sesi saat ini.

### Sintaksis
<a name="mysql_rds_set_session_binlog_format-syntax"></a>

```
CALL mysql.rds_set_session_binlog_format(format);
```

### Parameter
<a name="mysql_rds_set_session_binlog_format-parameters"></a>

*format*  
Nilai yang menunjukkan format log biner untuk sesi saat ini:  
+ `STATEMENT` – Sumber replikasi menulis peristiwa ke log biner berdasarkan pernyataan SQL.
+ `ROW` – Sumber replikasi menulis peristiwa ke log biner yang menunjukkan perubahan pada baris tabel individual.
+ `MIXED` – Pencatatan log umumnya didasarkan pada pernyataan SQL, tetapi beralih ke baris dalam kondisi tertentu. Untuk informasi selengkapnya, lihat [Mixed Binary Logging Format](https://dev.mysql.com/doc/refman/8.0/en/binary-log-mixed.html) dalam dokumentasi MySQL.

### Catatan penggunaan
<a name="mysql_rds_set_session_binlog_format-usage"></a>

Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer.

Untuk menggunakan prosedur tersimpan ini, Anda harus memiliki pencatatan log biner yang dikonfigurasi untuk sesi saat ini.

Untuk Aurora, prosedur ini didukung untuk Aurora MySQL versi 2.12 dan versi yang lebih tinggi yang kompatibel dengan MySQL 5.7.

## mysql.rds\$1set\$1source\$1auto\$1position ( 3)
<a name="mysql_rds_set_source_auto_position"></a>

Menetapkan mode replikasi untuk didasarkan pada posisi file log biner atau pada pengidentifikasi transaksi global ()GTIDs.

### Sintaks
<a name="mysql_rds_set_source_auto_position-syntax"></a>

```
CALL mysql.rds_set_source_auto_position (auto_position_mode);
```

### Parameter
<a name="mysql_rds_set_source_auto_position-parameters"></a>

*auto\$1position\$1mode*  
Nilai yang menunjukkan apakah akan menggunakan replikasi posisi file log atau replikasi berbasis GTID:  
+  `0` – Gunakan metode replikasi berdasarkan posisi file log biner. Nilai default-nya `0`. 
+  `1` – Gunakan metode replikasi berbasis GTID. 

### Catatan penggunaan
<a name="mysql_rds_set_source_auto_position-usage-notes"></a>

Untuk klaster DB Aurora MySQL, Anda memanggil prosedur tersimpan ini saat terhubung ke instans primer. 

Pengguna administratif harus menjalankan prosedur `mysql.rds_set_source_auto_position`. 

## mysql.rds\$1skip\$1repl\$1error
<a name="mysql_rds_skip_repl_error"></a>

Melewati dan menghapus kesalahan replikasi pada replika baca DB MySQL.

### Sintaksis
<a name="mysql_rds_skip_repl_error-syntax"></a>

 

```
CALL mysql.rds_skip_repl_error;
```

### Catatan penggunaan
<a name="mysql_rds_skip_repl_error-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_skip_repl_error` pada replika baca. Untuk informasi selengkapnya tentang prosedur ini, lihat [Melewati kesalahan replikasi saat ini](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.MySQL.CommonDBATasks.html#Appendix.MySQL.CommonDBATasks.SkipError).

Untuk menentukan apakah ada kesalahan, jalankan perintah `SHOW REPLICA STATUS\G` MySQL. Jika kesalahan replikasi tidak parah, Anda dapat menjalankan `mysql.rds_skip_repl_error` untuk melewati kesalahan tersebut. Jika ada beberapa kesalahan, `mysql.rds_skip_repl_error` akan menghapus kesalahan pertama, lalu memberi peringatan bahwa ada kesalahan lain. Anda kemudian dapat menggunakan `SHOW REPLICA STATUS\G` untuk menentukan tindakan yang benar untuk kesalahan berikutnya. Untuk informasi tentang nilai yang ditampilkan, lihat [SHOW REPLICA STATUS statement](https://dev.mysql.com/doc/refman/8.0/en/show-replica-status.html) dalam dokumentasi MySQL.

Untuk informasi selengkapnya tentang cara mengatasi kesalahan replikasi dengan Aurora MySQL, lihat [](CHAP_Troubleshooting.md#CHAP_Troubleshooting.MySQL.RR).

#### Kesalahan replikasi terhenti
<a name="skip_repl_error.stopped-error"></a>

Ketika memanggil prosedur `mysql.rds_skip_repl_error`, Anda mungkin menerima pesan kesalahan yang menyatakan bahwa replika tidak berfungsi atau dinonaktifkan.

Pesan kesalahan ini muncul jika Anda menjalankan prosedur pada instans primer, bukan replika baca. Anda harus menjalankan prosedur ini pada replika baca agar prosedur berfungsi.

Pesan kesalahan ini mungkin juga muncul jika Anda menjalankan prosedur pada replika baca, tetapi replikasi tidak berhasil dimulai ulang.

Jika Anda perlu melewati sejumlah besar kesalahan, lag replikasi dapat meningkat hingga melampaui periode retensi default untuk file log biner (binlog). Dalam hal ini, Anda mungkin mengalami kesalahan fatal karena file binlog dibersihkan sebelum diputar ulang pada replika baca. Penghapusan ini menyebabkan replikasi berhenti, dan Anda tidak dapat lagi memanggil perintah `mysql.rds_skip_repl_error` untuk melewati kesalahan replikasi.

Anda dapat memitigasi masalah ini dengan meningkatkan jumlah jam retensi file binlog tersebut pada instans basis data sumber Anda. Setelah meningkatkan waktu retensi binlog, Anda dapat memulai ulang replikasi dan memanggil perintah `mysql.rds_skip_repl_error` sesuai kebutuhan.

Untuk mengatur waktu retensi binlog, gunakan prosedur [mysql.rds\$1set\$1configuration](mysql-stored-proc-configuring.md#mysql_rds_set_configuration) dan tentukan parameter konfigurasi `'binlog retention hours'` bersama dengan jumlah jam untuk mempertahankan file binlog di klaster DB. Contoh berikut menetapkan periode penyimpanan file binlog menjadi 48 jam.

```
CALL mysql.rds_set_configuration('binlog retention hours', 48);
```

## mysql.rds\$1start\$1replication
<a name="mysql_rds_start_replication"></a>

Memulai replikasi dari klaster DB Aurora MySQL.

**catatan**  
Anda dapat menggunakan prosedur tersimpan [mysql.rds\$1start\$1replication\$1until (Aurora MySQL versi 3)](#mysql_rds_start_replication_until) atau [mysql.rds\$1start\$1replication\$1until\$1gtid (Aurora MySQL versi 3)](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid) untuk memulai replikasi dari instans DB Aurora MySQL dan menghentikan replikasi di lokasi file log biner yang telah ditentukan.

### Sintaksis
<a name="mysql_rds_start_replication-syntax"></a>

 

```
CALL mysql.rds_start_replication;
```

### Catatan penggunaan
<a name="mysql_rds_start_replication-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_start_replication`.

Untuk mengimpor data dari instance MySQL eksternal ke Amazon RDS, `mysql.rds_start_replication` panggil replika baca untuk memulai proses replikasi setelah Anda [mysql.rds\$1set\$1external\$1master 2)](#mysql_rds_set_external_master) memanggil [mysql.rds\$1set\$1external\$1source (RDS )](#mysql_rds_set_external_source) atau membangun konfigurasi replikasi. Untuk informasi selengkapnya, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md).

Untuk mengekspor data ke instans MySQL yang berjalan di luar Amazon RDS, panggil `mysql.rds_start_replication` dan `mysql.rds_stop_replication` pada replika baca untuk mengontrol beberapa tindakan replikasi, seperti membersihkan log biner. Untuk informasi selengkapnya, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md).

Anda juga dapat memanggil `mysql.rds_start_replication` ​​pada replika baca untuk memulai kembali proses replikasi apa pun yang sebelumnya Anda hentikan dengan memanggil `mysql.rds_stop_replication`. Untuk informasi selengkapnya, lihat [Kesalahan replikasi terhenti](CHAP_Troubleshooting.md#CHAP_Troubleshooting.MySQL.ReplicationStopped).

## mysql.rds\$1start\$1replication\$1until (Aurora MySQL versi 3)
<a name="mysql_rds_start_replication_until"></a>

Memulai replikasi dari klaster DB Aurora MySQL dan menghentikan replikasi di lokasi file log biner yang telah ditentukan.

### Sintaks
<a name="mysql_rds_start_replication_until-syntax"></a>

 

```
CALL mysql.rds_start_replication_until (
replication_log_file
  , replication_stop_point
);
```

### Parameter
<a name="mysql_rds_start_replication_until-parameters"></a>

 *replication\$1log\$1file*   
Nama log biner pada instans basis data sumber yang berisi informasi replikasi.

 *replication\$1stop\$1point *   
Lokasi di log biner `replication_log_file` tempat replikasi akan berhenti.

### Catatan penggunaan
<a name="mysql_rds_start_replication_until-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_start_replication_until`.

Prosedur ini didukung untuk Aurora MySQL versi 3.04 dan yang lebih tinggi.

Prosedur `mysql.rds_start_replication_until` tersimpan tidak didukung untuk replikasi terkelola, yang mencakup hal-hal berikut:
+ [Mereplikasi kluster DB MySQL Amazon Aurora Wilayah AWS](AuroraMySQL.Replication.CrossRegion.md)
+ [Memigrasikan data dari instans DB RDS for MySQL ke klaster DB Amazon Aurora MySQL menggunakan replika baca Aurora](AuroraMySQL.Migrating.RDSMySQL.Replica.md)

Nama file yang ditentukan untuk parameter `replication_log_file` harus cocok dengan nama file binlog instans basis data sumber.

Jika parameter `replication_stop_point` menentukan lokasi perhentian di masa lalu, replikasi akan segera dihentikan.

### Contoh
<a name="mysql_rds_start_replication_until-examples"></a>

Contoh berikut memulai replikasi dan mereplikasi perubahan hingga mencapai lokasi `120` di file log biner `mysql-bin-changelog.000777`.

```
call mysql.rds_start_replication_until(
  'mysql-bin-changelog.000777',
  120);
```

## mysql.rds\$1stop\$1replication
<a name="mysql_rds_stop_replication"></a>

Menghentikan replikasi dari instans DB MySQL.

### Sintaks
<a name="mysql_rds_stop_replication-syntax"></a>

 

```
CALL mysql.rds_stop_replication;
```

### Catatan penggunaan
<a name="mysql_rds_stop_replication-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_stop_replication`. 

Jika Anda mengonfigurasi replikasi untuk mengimpor data dari instans MySQL yang berjalan di luar Amazon RDS, Anda memanggil `mysql.rds_stop_replication` pada replika baca untuk menghentikan proses replikasi setelah impor selesai. Untuk informasi selengkapnya, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md).

Jika Anda mengonfigurasi replikasi untuk mengekspor data ke instans MySQL yang berjalan di luar Amazon RDS, Anda memanggil `mysql.rds_start_replication` dan `mysql.rds_stop_replication` pada replika baca untuk mengontrol beberapa tindakan replikasi, seperti membersihkan log biner. Untuk informasi selengkapnya, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md).

Prosedur `mysql.rds_stop_replication` tersimpan tidak didukung untuk replikasi terkelola, yang mencakup hal-hal berikut:
+ [Mereplikasi kluster DB MySQL Amazon Aurora Wilayah AWS](AuroraMySQL.Replication.CrossRegion.md)
+ [Memigrasikan data dari instans DB RDS for MySQL ke klaster DB Amazon Aurora MySQL menggunakan replika baca Aurora](AuroraMySQL.Migrating.RDSMySQL.Replica.md)

# Mengakhiri sesi atau kueri
<a name="mysql-stored-proc-ending"></a>

Prosedur tersimpan berikut mengakhiri sesi atau kueri.

**Topics**
+ [

## mysql.rds\$1kill
](#mysql_rds_kill)
+ [

## mysql.rds\$1kill\$1query
](#mysql_rds_kill_query)

## mysql.rds\$1kill
<a name="mysql_rds_kill"></a>

Mengakhiri koneksi ke server MySQL.

### Sintaksis
<a name="mysql_rds_kill-syntax"></a>

```
CALL mysql.rds_kill(processID);
```

### Parameter
<a name="mysql_rds_kill-parameters"></a>

 *processID*   
Identitas utas koneksi akan diakhiri.

### Catatan penggunaan
<a name="mysql_rds_kill-usage-notes"></a>

Setiap koneksi ke server MySQL berjalan di utas terpisah. Untuk mengakhiri koneksi, gunakan prosedur `mysql.rds_kill` dan teruskan ID utas koneksi tersebut. Untuk mendapatkan ID utas, gunakan perintah [SHOW PROCESSLIST](https://dev.mysql.com/doc/refman/8.0/en/show-processlist.html) MySQL.

### Contoh
<a name="mysql_rds_kill-examples"></a>

Contoh berikut mengakhiri koneksi dengan ID utas 4243:

```
CALL mysql.rds_kill(4243);
```

## mysql.rds\$1kill\$1query
<a name="mysql_rds_kill_query"></a>

Mengakhiri kueri yang berjalan pada server MySQL.

### Sintaksis
<a name="mysql_rds_kill_query-syntax"></a>

```
CALL mysql.rds_kill_query(processID);
```

### Parameter
<a name="mysql_rds_kill_query-parameters"></a>

 *processID*   
Identitas proses atau utas yang menjalankan kueri yang akan diakhiri.

### Catatan penggunaan
<a name="mysql_rds_kill_query-usage-notes"></a>

Untuk mengakhiri kueri yang berjalan pada server MySQL, gunakan prosedur `mysql_rds_kill_query` dan teruskan ID koneksi utas yang menjalankan kueri. Lalu, prosedur akan mengakhiri koneksi.

Untuk mendapatkan ID, lakukan kueri pada [tabel INFORMATION\$1SCHEMA PROCESSLIST](https://dev.mysql.com/doc/refman/8.0/en/information-schema-processlist-table.html) MySQL atau gunakan perintah [SHOW PROCESSLIST](https://dev.mysql.com/doc/refman/8.0/en/show-processlist.html) MySQL. Nilai dalam kolom ID dari `SHOW PROCESSLIST` atau `SELECT * FROM INFORMATION_SCHEMA.PROCESSLIST` adalah *processID*. 

### Contoh
<a name="mysql_rds_kill_query-examples"></a>

Contoh berikut mengakhiri kueri dengan ID utas kueri 230040:

```
CALL mysql.rds_kill_query(230040);
```

# Mereplikasi transaksi menggunakan GTIDs
<a name="mysql-stored-proc-gtid"></a>

Prosedur tersimpan berikut mengontrol bagaimana transaksi direplikasi menggunakan pengidentifikasi transaksi global (GTIDs) dengan Aurora MySQL. Untuk mempelajari cara menggunakan replikasi berdasarkan GTIDs Aurora MySQL, lihat. [Menggunakan replikasi GTID berbasis](mysql-replication-gtid.md)

**Topics**
+ [

## mysql.rds\$1assign\$1gtids\$1to\$1anonymous\$1transactions (Aurora MySQL versi 3)
](#mysql_assign_gtids_to_anonymous_transactions)
+ [

## mysql.rds\$1gtid\$1purged (Aurora MySQL versi 3)
](#mysql_rds_gtid_purged)
+ [

## mysql.rds\$1skip\$1transaction\$1with\$1gtid (Aurora MySQL versi 2 dan 3)
](#mysql_rds_skip_transaction_with_gtid)
+ [

## mysql.rds\$1start\$1replication\$1until\$1gtid (Aurora MySQL versi 3)
](#mysql_rds_start_replication_until_gtid)

## mysql.rds\$1assign\$1gtids\$1to\$1anonymous\$1transactions (Aurora MySQL versi 3)
<a name="mysql_assign_gtids_to_anonymous_transactions"></a>

Mengonfigurasi opsi `ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS` dari pernyataan `CHANGE REPLICATION SOURCE TO`. Hal ini akan membuat saluran replikasi menetapkan GTID ke transaksi replikasi yang tidak memilikinya. Dengan begitu, Anda dapat melakukan replikasi log biner dari sumber yang tidak menggunakan replikasi berbasis GTID ke replika yang menggunakan replikasi tersebut. *Untuk informasi selengkapnya, lihat [MENGUBAH SUMBER REPLIKASI MENJADI Pernyataan](https://dev.mysql.com/doc/refman/8.0/en/change-replication-source-to.html) dan [Replikasi Dari Sumber Tanpa GTIDs ke Replika Dengan GTIDs di Manual Referensi](https://dev.mysql.com/doc/refman/8.0/en/replication-gtids-assign-anon.html) MySQL.*

### Sintaks
<a name="mysql_assign_gtids_to_anonymous_transactions-syntax"></a>

```
CALL mysql.rds_assign_gtids_to_anonymous_transactions(gtid_option);
```

### Parameter
<a name="mysql_assign_gtids_to_anonymous_transactions-parameters"></a>

 *gtid\$1option*  
Nilai string. Nilai yang diizinkan adalah `OFF`, `LOCAL`, atau UUID yang ditentukan.

### Catatan penggunaan
<a name="mysql_assign_gtids_to_anonymous_transactions-usage-notes"></a>

Prosedur ini memiliki efek yang sama seperti mengeluarkan pernyataan `CHANGE REPLICATION SOURCE TO ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS = gtid_option` di komunitas MySQL.

 GTID harus diubah `ON` untuk disetel *gtid\$1option* ke `LOCAL` atau UUID tertentu. 

Defaultnya adalah `OFF`, yang artinya fitur tersebut tidak digunakan.

`LOCAL` menetapkan GTID termasuk UUID replika itu sendiri (pengaturan `server_uuid`).

Meneruskan parameter yang merupakan UUID akan menetapkan GTID yang menyertakan UUID tertentu, seperti pengaturan `server_uuid` untuk server sumber replikasi.

### Contoh
<a name="mysql_assign_gtids_to_anonymous_transactions-examples"></a>

Untuk menonaktifkan fitur ini:

```
mysql> call mysql.rds_assign_gtids_to_anonymous_transactions('OFF');
+-------------------------------------------------------------+
| Message  |
+-------------------------------------------------------------+
| ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS has been set to: OFF |
+-------------------------------------------------------------+
1 row in set (0.07 sec)
```

Untuk menggunakan UUID replika itu sendiri:

```
mysql> call mysql.rds_assign_gtids_to_anonymous_transactions('LOCAL');
+---------------------------------------------------------------+
| Message  |
+---------------------------------------------------------------+
| ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS has been set to: LOCAL |
+---------------------------------------------------------------+
1 row in set (0.07 sec)
```

Untuk menggunakan UUID yang ditentukan:

```
mysql> call mysql.rds_assign_gtids_to_anonymous_transactions('317a4760-f3dd-3b74-8e45-0615ed29de0e');
+----------------------------------------------------------------------------------------------+
| Message |
+----------------------------------------------------------------------------------------------+
| ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS has been set to: 317a4760-f3dd-3b74-8e45-0615ed29de0e |
+----------------------------------------------------------------------------------------------+
1 row in set (0.07 sec)
```

## mysql.rds\$1gtid\$1purged (Aurora MySQL versi 3)
<a name="mysql_rds_gtid_purged"></a>



Menetapkan nilai global variabel sistem `gtid_purged` ke set pengidentifikasi transaksi global (GTID) yang diberikan. Variabel `gtid_purged` sistem adalah set GTID yang terdiri GTIDs dari semua transaksi yang telah dilakukan di server, tetapi tidak ada dalam file log biner apa pun di server.

Untuk memungkinkan kompatibilitas dengan MySQL 8.0, ada dua cara untuk mengatur nilai `gtid_purged`:
+ Ganti nilai `gtid_purged` dengan set GTID yang Anda tentukan.
+ Tambahkan set GTID yang Anda tentukan ke set GTID yang sudah ada di `gtid_purged`.

### Sintaksis
<a name="mysql_rds_gtid_purged-syntax"></a>

Untuk mengganti nilai `gtid_purged` dengan set GTID yang Anda tentukan:

```
CALL mysql.rds_gtid_purged (gtid_set);
```

Untuk menambahkan nilai `gtid_purged` ke set GTID yang Anda tentukan:

```
CALL mysql.rds_gtid_purged (+gtid_set);
```

### Parameter
<a name="mysql_rds_gtid_purged-parameters"></a>

*gtid\$1set*  
Nilai *gtid\$1set* harus menjadi superset dari nilai saat ini`gtid_purged`, dan tidak dapat berpotongan dengan. `gtid_subtract(gtid_executed,gtid_purged)` Artinya, set GTID baru harus menyertakan apa pun GTIDs yang sudah ada`gtid_purged`, dan tidak dapat menyertakan `gtid_executed` yang belum dibersihkan. GTIDs *gtid\$1set*Parameter juga tidak dapat menyertakan apa pun GTIDs yang ada di `gtid_owned` set global, GTIDs untuk transaksi yang saat ini sedang diproses di server.

### Catatan penggunaan
<a name="mysql_rds_gtid_purged-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_gtid_purged`.

Prosedur ini didukung untuk Aurora MySQL versi 3.04 dan yang lebih tinggi.

### Contoh
<a name="mysql_rds_gtid_purged-examples"></a>

Contoh berikut menetapkan GTID `3E11FA47-71CA-11E1-9E33-C80AA9429562:23` ke variabel global `gtid_purged`.

```
CALL mysql.rds_gtid_purged('3E11FA47-71CA-11E1-9E33-C80AA9429562:23');
```

## mysql.rds\$1skip\$1transaction\$1with\$1gtid (Aurora MySQL versi 2 dan 3)
<a name="mysql_rds_skip_transaction_with_gtid"></a>

Melewati replikasi transaksi dengan pengenal transaksi global (GTID) yang ditentukan pada instans primer Aurora.

Anda dapat menggunakan prosedur ini untuk pemulihan bencana ketika transaksi GTID tertentu diketahui menyebabkan masalah. Gunakan prosedur tersimpan ini untuk melewati transaksi bermasalah. Contoh transaksi bermasalah mencakup transaksi yang menonaktifkan replikasi, menghapus data penting, atau menyebabkan instans DB menjadi tidak tersedia.

### Sintaksis
<a name="mysql_rds_skip_transaction_with_gtid-syntax"></a>

 

```
CALL mysql.rds_skip_transaction_with_gtid (
gtid_to_skip
);
```

### Parameter
<a name="mysql_rds_skip_transaction_with_gtid-parameters"></a>

 *gtid\$1to\$1skip*   
GTID dari transaksi replikasi yang akan dilewati.

### Catatan penggunaan
<a name="mysql_rds_skip_transaction_with_gtid-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_skip_transaction_with_gtid`.

Prosedur ini didukung untuk Aurora MySQL versi 2 dan 3.

### Contoh
<a name="mysql_rds_skip_transaction_with_gtid-examples"></a>

Contoh berikut melewati replikasi transaksi dengan GTID `3E11FA47-71CA-11E1-9E33-C80AA9429562:23`.

```
CALL mysql.rds_skip_transaction_with_gtid('3E11FA47-71CA-11E1-9E33-C80AA9429562:23');
```

## mysql.rds\$1start\$1replication\$1until\$1gtid (Aurora MySQL versi 3)
<a name="mysql_rds_start_replication_until_gtid"></a>

Memulai replikasi dari klaster DB Aurora MySQL dan menghentikan replikasi segera setelah pengidentifikasi transaksi global (GTID) yang ditentukan.

### Sintaksis
<a name="mysql_rds_start_replication_until_gtid-syntax"></a>

 

```
CALL mysql.rds_start_replication_until_gtid(gtid);
```

### Parameter
<a name="mysql_rds_start_replication_until_gtid-parameters"></a>

 *gtid*   
GTID setelah replikasi dihentikan.

### Catatan penggunaan
<a name="mysql_rds_start_replication_until_gtid-usage-notes"></a>

Pengguna utama harus menjalankan prosedur `mysql.rds_start_replication_until_gtid`.

Prosedur ini didukung untuk Aurora MySQL versi 3.04 dan yang lebih tinggi.

Prosedur `mysql.rds_start_replication_until_gtid` tersimpan tidak didukung untuk replikasi terkelola, yang mencakup hal-hal berikut:
+ [Mereplikasi kluster DB MySQL Amazon Aurora Wilayah AWS](AuroraMySQL.Replication.CrossRegion.md)
+ [Memigrasikan data dari instans DB RDS for MySQL ke klaster DB Amazon Aurora MySQL menggunakan replika baca Aurora](AuroraMySQL.Migrating.RDSMySQL.Replica.md)

Saat parameter `gtid` menentukan transaksi yang telah dijalankan oleh replika, replikasi akan segera dihentikan.

### Contoh
<a name="mysql_rds_start_replication_until_gtid-examples"></a>

Contoh berikut memulai replikasi dan mereplikasi perubahan hingga mencapai GTID `3E11FA47-71CA-11E1-9E33-C80AA9429562:23`.

```
call mysql.rds_start_replication_until_gtid('3E11FA47-71CA-11E1-9E33-C80AA9429562:23');
```

# Memutar log kueri
<a name="mysql-stored-proc-logging"></a>

Prosedur tersimpan berikut memutar SQL log Saya ke tabel cadangan. Untuk informasi selengkapnya, lihat [File log database MySQL Aurora](USER_LogAccess.Concepts.MySQL.md).

**Topics**
+ [

## mysql.rds\$1rotate\$1general\$1log
](#mysql_rds_rotate_general_log)
+ [

## mysql.rds\$1rotate\$1slow\$1log
](#mysql_rds_rotate_slow_log)

## mysql.rds\$1rotate\$1general\$1log
<a name="mysql_rds_rotate_general_log"></a>

Merotasi tabel `mysql.general_log` ke tabel cadangan.

### Sintaks
<a name="mysql_rds_rotate_general_log-syntax"></a>

 

```
CALL mysql.rds_rotate_general_log;
```

### Catatan penggunaan
<a name="mysql_rds_rotate_general_log-usage-notes"></a>

Anda bisa merotasi tabel `mysql.general_log` ke tabel cadangan dengan memanggil prosedur `mysql.rds_rotate_general_log`. Saat tabel log dirotasi, tabel log saat ini disalin ke tabel log cadangan dan entri di tabel log saat ini dihapus. Jika sudah ada, tabel log cadangan akan dihapus sebelum tabel log saat ini disalin ke cadangan. Anda dapat meminta tabel log cadangan jika diperlukan. Tabel log cadangan untuk tabel `mysql.general_log` bernama `mysql.general_log_backup`.

Anda dapat menjalankan prosedur ini hanya ketika parameter `log_output` diatur ke `TABLE`.

## mysql.rds\$1rotate\$1slow\$1log
<a name="mysql_rds_rotate_slow_log"></a>

Merotasi tabel `mysql.slow_log` ke tabel cadangan.

### Sintaks
<a name="mysql_rds_rotate_slow_log-syntax"></a>

 

```
CALL mysql.rds_rotate_slow_log;
```

### Catatan penggunaan
<a name="mysql_rds_rotate_slow_log-usage-notes"></a>

Anda bisa merotasi tabel `mysql.slow_log` ke tabel cadangan dengan memanggil prosedur `mysql.rds_rotate_slow_log`. Saat tabel log dirotasi, tabel log saat ini disalin ke tabel log cadangan dan entri di tabel log saat ini dihapus. Jika sudah ada, tabel log cadangan akan dihapus sebelum tabel log saat ini disalin ke cadangan. 

Anda dapat meminta tabel log cadangan jika diperlukan. Tabel log cadangan untuk tabel `mysql.slow_log` bernama `mysql.slow_log_backup`. 

# Mengatur dan menampilkan konfigurasi log biner
<a name="mysql-stored-proc-configuring"></a>

Prosedur tersimpan berikut mengatur dan menampilkan parameter konfigurasi, seperti untuk retensi file log biner.

**Topics**
+ [

## mysql.rds\$1set\$1configuration
](#mysql_rds_set_configuration)
+ [

## mysql.rds\$1show\$1configuration
](#mysql_rds_show_configuration)

## mysql.rds\$1set\$1configuration
<a name="mysql_rds_set_configuration"></a>

Menentukan jumlah jam untuk mempertahankan log biner atau jumlah detik untuk menunda replikasi.

### Sintaksis
<a name="mysql_rds_set_configuration-syntax"></a>

 

```
CALL mysql.rds_set_configuration(name,value);
```

### Parameter
<a name="mysql_rds_set_configuration-parameters"></a>

 *name*   
Nama parameter konfigurasi yang akan diatur.

 *value*   
Nilai parameter konfigurasi.

### Catatan penggunaan
<a name="mysql_rds_set_configuration-usage-notes"></a>

Prosedur `mysql.rds_set_configuration` mendukung parameter konfigurasi berikut:
+ [binlog retention hours](#mysql_rds_set_configuration-usage-notes.binlog-retention-hours)

Parameter konfigurasi disimpan secara permanen dan bertahan dari boot ulang atau failover instans DB apa pun.

#### binlog retention hours
<a name="mysql_rds_set_configuration-usage-notes.binlog-retention-hours"></a>

Parameter `binlog retention hours` digunakan untuk menentukan jumlah jam untuk mempertahankan file log biner. Amazon Aurora biasanya membersihkan log biner sesegera mungkin, tetapi log biner mungkin masih diperlukan untuk replikasi dengan basis data MySQL di luar Aurora.

Nilai default `binlog retention hours` adalah `NULL`. Untuk Aurora MySQL, `NULL` menandakan bahwa log biner dibersihkan dengan lambat. Log biner Aurora MySQL mungkin masih berada di dalam sistem untuk jangka waktu tertentu, yang biasanya tidak lebih dari satu hari.

Untuk menentukan jumlah jam guna mempertahankan log biner pada klaster DB, gunakan prosedur tersimpan `mysql.rds_set_configuration` dan tentukan periode dengan waktu yang cukup untuk terjadinya proses replikasi, seperti yang diperlihatkan dalam contoh berikut.

`call mysql.rds_set_configuration('binlog retention hours', 24);`

**catatan**  
Anda tidak dapat menggunakan nilai `0` untuk `binlog retention hours`.

Untuk Aurora MySQL versi 2.11.0 dan yang lebih tinggi dan klaster DB versi 3, nilai `binlog retention hours` maksimumnya adalah 2160 (90 hari).

Setelah Anda mengatur periode retensi, pantau penggunaan penyimpanan untuk instans DB guna memastikan bahwa log biner yang dipertahankan tidak memakan terlalu banyak ruang penyimpanan.

## mysql.rds\$1show\$1configuration
<a name="mysql_rds_show_configuration"></a>

Jumlah jam untuk mempertahankan log biner.

### Sintaksis
<a name="mysql_rds_show_configuration-syntax"></a>

 

```
CALL mysql.rds_show_configuration;
```

### Catatan penggunaan
<a name="mysql_rds_show_configuration-usage-notes"></a>

Untuk memverifikasi jumlah jam Amazon RDS mempertahankan log biner, gunakan prosedur tersimpan `mysql.rds_show_configuration`.

### Contoh
<a name="mysql_rds_show_configuration-examples"></a>

Contoh berikut menampilkan periode retensi:

```
call mysql.rds_show_configuration;
                name                         value     description
                binlog retention hours       24        binlog retention hours specifies the duration in hours before binary logs are automatically deleted.
```