All Products
Search

This Product

    PolarDB:Aktifkan binary logging

    Document Center

    PolarDB:Aktifkan binary logging

    Last Updated:Mar 01, 2026

    PolarDB for MySQL menggunakan redo log yang lebih canggih dibandingkan binary log. Binary logging dinonaktifkan secara default. Aktifkan fitur ini jika Anda memerlukan kompatibilitas dengan ekosistem MySQL, misalnya untuk mereplikasi data melalui Data Transmission Service (DTS), mengalirkan perubahan ke Elasticsearch atau AnalyticDB, atau menyinkronkan data antar kluster.

    Kasus penggunaan

    Batasan

    Kluster yang dibuat sebelum 5 April 2019 harus diperbarui ke versi minor terbaru sebelum mengaktifkan binary logging. Untuk detailnya, lihat Manajemen versi revisi. Kluster yang dibuat pada atau setelah tanggal tersebut mendukung binary logging secara langsung.

    Penagihan

    Log biner mengonsumsi storage space kluster, yang dikenai biaya sesuai laju penyimpanan kluster Anda.

    Metode penagihan penyimpanan Perilaku penagihan
    Subscription Tidak ada biaya tambahan selama total penyimpanan tetap dalam kapasitas yang telah Anda beli
    Pay-as-you-go Ditagih berdasarkan volume penyimpanan aktual yang digunakan oleh data log biner

    Dampak performa

    Binary logging hanya memengaruhi operasi tulis (INSERT, UPDATE, DELETE); performa baca tidak terpengaruh. Dampak umumnya berada di bawah 10%, namun dapat mencapai 40% pada beban kerja ekstrem.

    Commit transaksi besar dapat memblokir transaksi lain dan memperpanjang durasi restart atau perubahan konfigurasi.

    Aktifkan binary logging

    Aktifkan saat pembuatan kluster

    Pilih Enable di bagian Enable Binary Logging saat membuat kluster. Untuk detailnya, lihat Pembelian kustom atau Beli klaster langganan.

    Aktifkan untuk kluster yang sudah ada

    Penting

    Mengaktifkan binary logging memicu restart otomatis kluster yang biasanya memakan waktu 5 hingga 15 menit, dengan gangguan layanan sekitar 40 detik. Waktu pemulihan bervariasi tergantung pada volume data dan jumlah tabel. Lakukan operasi ini selama jam sepi dan pastikan aplikasi Anda mendukung koneksi ulang otomatis.

    Metode 1: Gunakan halaman Binary Logs

    1. Login ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Di pojok kiri atas, pilih wilayah kluster tersebut. Di daftar kluster, temukan kluster dan klik ID-nya untuk membuka halaman Basic Information.

    2. Di panel navigasi sebelah kiri, klik Binary Logs.

    3. Klik Enable Now.

    4. Di kotak dialog Enable Binary Logging, atur parameter Effective Mode menjadi Now atau Scheduled. Jika memilih Scheduled, tentukan kapan binary logging akan diaktifkan.

    5. Klik OK.

    Metode 2: Atur parameter loose_polar_log_bin

    1. Login ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Di pojok kiri atas, pilih wilayah kluster tersebut. Di daftar kluster, temukan kluster dan klik ID-nya untuk membuka halaman Basic Information.

    2. Di panel navigasi sebelah kiri, pilih Settings and Management > Parameters.

    3. Temukan parameter loose_polar_log_bin dan ubah nilainya. Untuk detailnya, lihat bagian "Modify parameters" pada Konfigurasikan parameter kluster dan node.

      Versi MySQL Nilai parameter
      MySQL 5.6 ON_WITH_GTID
      MySQL 5.7 atau 8.0 ON

    Nonaktifkan binary logging

    Metode 1: Gunakan halaman Binary Logs

    1. Login ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Di pojok kiri atas, pilih wilayah kluster tersebut. Di daftar kluster, temukan kluster dan klik ID-nya untuk membuka halaman Basic Information.

    2. Di panel navigasi sebelah kiri, klik Binary Logs.

    3. Klik Disable Binary Logging.

    4. Di kotak dialog Disable Binary Logging, atur parameter Effective Mode menjadi Now atau Scheduled. Jika memilih Scheduled, tentukan kapan binary logging akan dinonaktifkan. Secara opsional, pilih Clear Local Binary Logs.

    5. Klik OK.

    Metode 2: Atur parameter loose_polar_log_bin

    1. Login ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Di pojok kiri atas, pilih wilayah kluster tersebut. Di daftar kluster, temukan kluster dan klik ID-nya untuk membuka halaman Basic Information.

    2. Di panel navigasi sebelah kiri, pilih Settings and Management > Parameters.

    3. Temukan parameter loose_polar_log_bin dan ubah nilainya. Untuk detailnya, lihat Konfigurasikan parameter kluster dan node.

      Versi MySQL Nilai parameter
      MySQL 5.6 OFF_WITH_GTID
      MySQL 5.7 atau 8.0 OFF
    Catatan

    Setelah Anda menonaktifkan binary logging, file log biner yang ada akan dipertahankan secara permanen. Untuk mengosongkan storage space, perpendek periode retensi sebelum menonaktifkan fitur ini. Tunggu hingga log lama secara otomatis dipurge, lalu nonaktifkan binary logging.

    Retensi log biner

    Kebijakan retensi

    Kondisi Retensi default
    Binary logging diaktifkan 3 hari
    Binary logging dinonaktifkan File yang ada dipertahankan secara permanen

    File log biner secara otomatis dihapus setelah periode retensi berakhir.

    Catatan

    • Untuk kluster PolarDB for MySQL yang dibeli sebelum 23 November 2023, file log biner disimpan selama dua minggu (14 hari) secara default.

    • Untuk kluster PolarDB for MySQL yang dibeli sebelum 17 Januari 2024, file log biner disimpan selama satu minggu (tujuh hari) secara default.

    Ubah periode retensi

    Penting

    • Mengubah periode retensi tidak mengganggu koneksi atau memerlukan restart kluster.

    • Jika volume besar log biner (misalnya 10 TB) perlu dipurge, kemungkinan terjadi pengecualian singkat pada operasi tulis. Dalam kasus ini, ubah periode retensi selama jam sepi. Atau, perpendek periode secara bertahap sehingga hanya sebagian log yang dihapus dalam satu waktu.

    • File log biner yang telah dihapus tidak dapat dipulihkan.

    Ubah salah satu parameter berikut berdasarkan versi MySQL Anda:

    Versi MySQL Parameter Nilai valid Unit Default
    5.6 loose_expire_logs_hours 0-2376 Jam 72
    5.7 atau 8.0 binlog_expire_logs_seconds 0-4294967295 Detik 259200 (3 hari)

    Nilai 0 berarti file log biner tidak pernah dihapus secara otomatis.

    Untuk petunjuk mengubah parameter, lihat Konfigurasikan parameter kluster dan node.

    Picu purge segera

    Setelah mengubah parameter retensi, log historis tidak langsung dihapus. Gunakan salah satu metode berikut untuk memicu purge:

    • Tunggu hingga file log biner aktif mencapai ukuran yang ditetapkan oleh max_binlog_size. Saat file tersebut berotasi, semua file yang kedaluwarsa akan dihapus secara otomatis.

    • Jalankan flush binary logs dengan akun istimewa.

    • Restart kluster.

    Hapus log biner saat binary logging dinonaktifkan

    Jika binary logging dinonaktifkan dan Anda ingin menghapus file log yang terakumulasi:

    1. Aktifkan kembali binary logging. Lihat Aktifkan binary logging.

    2. Atur loose_expire_logs_hours atau binlog_expire_logs_seconds ke nilai yang lebih kecil.

    3. Tunggu hingga log yang kedaluwarsa secara otomatis dipurge.

    4. Nonaktifkan kembali binary logging.

    Lihat dan urai log biner

    Gunakan tool mysqlbinlog untuk mengambil dan mengurai log biner dari jarak jauh. Untuk detailnya, lihat Ambil dan urai file log biner kluster PolarDB for MySQL dari jarak jauh.

    Untuk memeriksa waktu penulisan terakhir setiap file log biner, jalankan:

    show full binary logs;

    Perintah ini mengembalikan nama file, ukuran, dan waktu penulisan terakhir untuk setiap file log biner.

    Catatan

    show full binary logs memerlukan salah satu versi revisi minimum berikut:

    • MySQL 8.0.2: revisi 8.0.2.2.0 atau lebih baru

    • MySQL 8.0.1: revisi 8.0.1.1.14 atau lebih baru

    • MySQL 5.7: revisi 5.7.1.0.27 atau lebih baru

    • MySQL 5.6: revisi 5.6.1.0.38 atau lebih baru

    Catatan penggunaan

    • Gunakan Titik Akhir Utama: Saat mengonsumsi log biner melalui DTS atau layanan lain, hubungkan ke Primary Endpoint kluster Anda. Titik akhir ini selalu mengarah ke node utama yang menghasilkan log biner. Untuk menemukan titik akhir utama, lihat bagian "View the endpoint and port" pada Kelola titik akhir kluster.

    • Logging tingkat global vs. session: Parameter loose_polar_log_bin mengontrol binary logging di tingkat global. Untuk kontrol tingkat session, gunakan parameter sql_log_bin (dinonaktifkan secara default). Untuk mengaktifkan sql_log_bin, buka Quota Center, temukan kuota polardb SQL_log_bin parameter permissions, lalu klik Apply di kolom Actions.

    • Pengaktifan otomatis saat migrasi: DTS secara otomatis mengaktifkan binary logging saat melakukan migrasi data dari instans ApsaraDB RDS ke kluster PolarDB.

    FAQ

    Apa arti pesan Could not find first log file name in binary log index file?

    File log biner telah dihapus. File yang dihapus tidak dapat dipulihkan.

    Apakah saya bisa menggunakan Canal untuk change data capture?

    Ya. Setelah mengaktifkan binary logging, Canal dapat menangkap perubahan dari kluster PolarDB for MySQL Anda.

    Mengapa saya tidak bisa melakukan operasi DDL tanpa lock di DMS?

    Operasi DDL tanpa lock di Data Management Service (DMS) memerlukan binary logging yang diaktifkan. Jika Anda tidak ingin mengaktifkannya, gunakan DDL online sebagai gantinya.

    Apakah SHOW BINARY LOGS memengaruhi performa kluster?

    Tidak. Ini adalah kueri metadata yang tidak menulis data. Tidak ada dampak yang terukur pada performa baca atau tulis.

    Bagaimana cara melihat log biner yang dihasilkan pada titik waktu tertentu?

    Pulihkan data ke titik waktu tersebut, lalu urai log biner dari instans yang dipulihkan. Untuk detailnya, lihat Pemulihan database dan tabel: Pulihkan data ke titik waktu sebelumnya.