All Products
Search

This Product

    PolarDB:Unduh file cadangan

    Document Center

    PolarDB:Unduh file cadangan

    Last Updated:Jun 22, 2026

    PolarDB memungkinkan Anda mengunduh file cadangan dari set cadangan kluster ke mesin lokal untuk penyimpanan jangka panjang, mengkueri data historis, mentransfer cadangan (misalnya, ke OSS), dan audit.

    Catatan

    Anda tidak dapat langsung memulihkan data cadangan yang diunduh ke kluster PolarDB for MySQL. Anda dapat memulihkan file cadangan yang diunduh ke database MySQL yang dikelola sendiri.

    Tanggal rilis

    24 November 2023

    Catatan

    Fitur unduh file cadangan sedang dalam rilis canary dan akan diluncurkan secara bertahap.

    Penagihan

    Anda dapat mengunduh file cadangan melalui URL (disimpan sementara di DBS) atau mentransfernya ke OSS Anda. Biaya bervariasi tergantung pada tujuan unduhan:

    Catatan

    • Jika tugas unduhan gagal, tidak ada biaya yang dikenakan.

    • Di Konsol PolarDB, buka Settings and Management > Backup and Restoration > Backup Download List untuk kluster Anda guna melihat monthly backup conversion volume dan monthly outbound internet traffic.

    Biaya penyimpanan

    • URL: File disimpan sementara di penyimpanan bawaan DBS. Tidak ada biaya penyimpanan yang dikenakan.

    • OSS: File ditransfer ke bucket OSS Anda. Untuk informasi lebih lanjut tentang biaya penyimpanan OSS, lihat OSS storage fees.

    Biaya konversi set cadangan

    Mengonversi set cadangan ke format SQL, CSV, Parquet, atau CSV-with-header akan dikenai biaya konversi, baik tujuannya berupa URL maupun OSS. Tidak tersedia kuota gratis untuk konversi ini. Harganya adalah USD 0,03125 per GB.

    Biaya traffic

    • URL:

      • Unduh melalui jaringan internal: Gratis.

      • Unduh melalui internet: Kuota gratis sebesar 500 GB per kluster per bulan disediakan. Transfer data yang melebihi kuota gratis tersebut ditagih dengan skema pay-as-you-go. Biaya dihitung harian berdasarkan jumlah data yang diunduh. Untuk informasi harga, lihat Network fees.

      Catatan

      Kami menyarankan Anda membeli data transfer plan berlangganan untuk menutupi biaya network traffic saat mengunduh cadangan melalui internet. Semakin besar kapasitas data transfer plan, semakin tinggi diskon yang didapat.

    • OSS: File ditransfer ke bucket OSS Anda. Untuk informasi tentang biaya traffic, lihat OSS traffic fees.

    Prasyarat

    • Kluster: Fitur ini hanya tersedia untuk Cluster Edition kluster Enterprise Edition.

    • Region: China (Chengdu), China (Guangzhou), China (Qingdao), China (Beijing), China (Shanghai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta), Jepang (Tokyo), Singapura, AS (Silicon Valley), AS (Virginia), dan Jerman (Frankfurt).

      Catatan

      Fitur ini akan segera tersedia di region lain.

    • Lainnya:

      • Pengguna RAM harus memiliki izin untuk mengunduh file cadangan. Untuk memberikan izin kepada pengguna RAM, lihat RAM user permissions.

      • Data cadangan tidak dienkripsi. Anda tidak dapat mengunduh file cadangan dari kluster PolarDB yang dienkripsi.

      • Hanya satu tugas unduhan (berjalan atau gagal) yang diizinkan per kluster atau instans dalam satu waktu.

    Batasan

    • Proses unduhan mengekspor sebagian besar, tetapi tidak semua, struktur tabel:

      • Didukung untuk ekspor: informasi kolom, indeks kunci primer, indeks non-kunci primer, indeks unik, informasi tabel partisi, mesin tabel, serta set karakter dan aturan pengurutan di tingkat tabel atau database.

      • Tidak didukung untuk ekspor: indeks ekspresi, kunci asing, kolom yang dihasilkan, kolom tersembunyi, view, fungsi, prosedur tersimpan, variabel sistem, dan pemicu.

    • Tugas konversi akan gagal jika data Anda mencakup bidang dengan tipe data spasial berikut:

      GEOMETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION

    • File yang diekspor tidak menyertakan database sistem berikut:

      information_schema, mysql, performance_schema, sys, __recycle_bin__

    • Jika Anda memilih OSS sebagai tujuan unduhan, kelas penyimpanan bucket OSS harus berupa Standard. Untuk mengubah kelas penyimpanan, lihat Convert storage classes.

      Catatan

      Anda harus membuat bucket OSS secara manual. Anda dapat melewati langkah ini jika sudah membuat bucket untuk menyimpan file cadangan.

    • Anda hanya dapat mengunduh data dari level-1 backup. Data dari level-2 backup tidak dapat diunduh.

    • Jika cold data archiving diaktifkan untuk kluster, Anda tidak dapat mengunduh set cadangan.

    • Jika nama database atau tabel yang akan diunduh mengandung garis miring (/), tugas unduhan akan gagal.

    Prosedur

    (Direkomendasikan) Gunakan konsol

    1. Masuk ke PolarDB console. Di panel navigasi kiri, klik Clusters. Pilih region tempat kluster berada, lalu klik ID kluster untuk membuka halaman detail kluster.

    2. Di panel navigasi kiri, klik Settings and Management > Backup and Restoration.

    3. Di tab Data Backups, temukan set cadangan target dan klik Download Cluster Backup di kolom Actions.

      Catatan

      • Secara default, konsol menampilkan cadangan dari delapan hari terakhir. Untuk melihat cadangan yang lebih lama, Anda harus mengubah rentang waktu.

      • Jika tombol Download Cluster Backup tidak ditampilkan, pastikan versi produk atau region kluster Anda memenuhi prasyarat.

    4. Pada langkah Point in Time and Backup Set, pilih Download by Point in Time atau Download by Backup Set, lalu klik Next.

      Jika Anda memilih By Backup Set, pilih set cadangan target dari daftar drop-down Backup Set.

    5. Pada langkah Instance, Database, and Table, klik Next. Opsi Instance Download telah dipilih sebelumnya dan tidak dapat diubah.

    6. Pada langkah Destination and Format, pilih tujuan dan format unduhan, lalu lengkapi konfigurasi.

      Penting

      • Kami menyarankan Anda memilih OSS sebagai tujuan unduhan untuk menghemat waktu.

      • Tugas unduhan cadangan tidak dapat dibatalkan setelah dimulai.

      • Tugas unduhan cadangan dikenai biaya. Untuk informasi lebih lanjut, lihat Billing.

      (Direkomendasikan) OSS

      Jika Anda memilih OSS sebagai tujuan unduhan, data akan ditulis langsung ke bucket OSS Anda. Anda dapat menghapus data tersebut sesuai kebutuhan setelah unduhan selesai.

      1. Masukkan Nama Bucket OSS Anda dan awalan direktori, misalnya xx/xx.

        Catatan

      2. Pilih format unduhan. Anda dapat mengatur format unduhan menjadi CSV, SQL, Parquet, atau CSV-with-header. Pilih format sesuai kebutuhan bisnis Anda.

      3. Baca dan setujui persyaratan, lalu klik Complete. Anda akan diarahkan ke tab Backup Download List. Tunggu hingga tugas unduhan selesai.

        Catatan

        • Fitur unduhan cadangan memerlukan otorisasi DBS untuk mengakses sumber daya cloud Anda. Jika Anda belum memberikan izin akses, ikuti petunjuk di konsol untuk mengklik Authorize > Submit. Setelah otorisasi berhasil, Anda dapat kembali ke halaman konfigurasi unduhan lanjutan dan memasukkan informasi yang diperlukan seperti dijelaskan pada langkah-langkah sebelumnya.

        • Konversi format membutuhkan banyak sumber daya. Unduhan dapat gagal jika sumber daya server sementara tidak tersedia. Format data khusus yang tidak didukung juga dapat menyebabkan kegagalan unduhan. Jika tugas gagal, kami menyarankan Anda mencoba ulang tugas unduhan atau menghubungi dukungan teknis DBS.

        • Tidak ada biaya yang dikenakan untuk tugas yang gagal.

      4. Setelah status tugas berubah menjadi Successful, Anda dapat melihat file cadangan di bucket OSS yang sesuai.

      URL

      Jika Anda memilih URL sebagai tujuan unduhan, sistem akan menyimpan data yang dikonversi secara sementara di penyimpanan bawaan DBS. Tidak ada biaya penyimpanan yang dikenakan untuk proses ini.

      Catatan

      Mengunduh dari URL melibatkan pengemasan data, yang memerlukan waktu tambahan. Waktu yang dibutuhkan terkait dengan ukuran logis set cadangan. Jika set cadangan besar (misalnya, lebih dari 1 TB), kami menyarankan Anda mengunduh ke OSS.

      1. Pilih format unduhan. Anda dapat mengatur format unduhan menjadi CSV, SQL, Parquet, atau CSV-with-header. Pilih format sesuai kebutuhan bisnis Anda.

      2. Baca dan setujui persyaratan, lalu klik Complete. Anda akan diarahkan ke tab Backup Download List. Tunggu hingga tugas unduhan selesai.

        Catatan

        • Fitur unduhan cadangan memerlukan otorisasi DBS untuk mengakses sumber daya cloud Anda. Jika Anda belum memberikan izin akses, ikuti petunjuk di konsol untuk mengklik Authorize > Submit. Setelah otorisasi berhasil, Anda dapat kembali ke halaman konfigurasi unduhan lanjutan dan memasukkan informasi yang diperlukan seperti dijelaskan pada langkah-langkah sebelumnya.

        • Konversi format membutuhkan banyak sumber daya. Unduhan dapat gagal jika sumber daya server sementara tidak tersedia. Format data khusus yang tidak didukung juga dapat menyebabkan kegagalan unduhan. Jika tugas gagal, kami menyarankan Anda mencoba ulang tugas unduhan atau menghubungi dukungan teknis DBS.

        • Tidak ada biaya yang dikenakan untuk tugas yang gagal.

      3. Lihat file cadangan: Jika status tugas unduhan adalah Successful, unduhan telah selesai. Di kolom Download Destination, klik Generate URL, atur Validity Period, lalu klik Generate URL. Anda kemudian dapat menggunakan URL internal atau publik yang dihasilkan untuk mengunduh data cadangan.

        Catatan

        • Anda dapat memperoleh tautan unduhan dalam waktu tiga hari setelah tugas selesai. Periode validitas tautan dapat diatur dari 5 menit hingga 1 hari. Periode validitas default adalah 2 jam.

        • Tugas yang selesai kedaluwarsa setelah tiga hari, sehingga tautan unduhan juga kedaluwarsa. Data dari tugas yang kedaluwarsa akan dihapus secara otomatis setelah kedaluwarsa. Jika Anda masih memerlukan data tersebut, Anda harus memulai tugas unduhan baru untuk mendapatkan tautan unduhan baru.

        • Simpan tautan unduhan dan jaga kerahasiaannya untuk mencegah kebocoran data.

        • Menggunakan alat unduhan pihak ketiga mungkin menimbulkan traffic unduhan tambahan dan menyebabkan biaya tambahan. Gunakan alat ini dengan hati-hati. Untuk informasi tentang metode unduhan yang direkomendasikan, lihat Download commands.

    Gunakan API

    1. DescribeDownloadSupport: menanyakan apakah kluster Anda mendukung fitur unduh file cadangan.

      Catatan

      Jika respons API menunjukkan bahwa fitur tidak didukung, pastikan versi produk dan region kluster Anda memenuhi prasyarat.

    2. CreateDownload: membuat tugas unduh file cadangan.

      Catatan

      • Fitur unduhan cadangan mengharuskan Anda memberikan izin AliyunDBSDefaultRole kepada DBS untuk mengakses sumber daya cloud Anda. Jika Anda belum memberikan izin ini, Anda dapat memberikannya terlebih dahulu melalui konsol.

      • Saat TargetType (jenis tujuan unduhan) adalah OSS, Anda harus terlebih dahulu membuat bucket tujuan secara manual dan memastikan kelas penyimpanannya adalah Standard.

      • Saat TargetType (jenis tujuan unduhan) adalah URL, Anda harus menyimpan TaskId (ID tugas) yang dikembalikan untuk mengambil tautan unduhan.

      • Tugas unduhan cadangan tidak dapat dibatalkan setelah dimulai.

      • Tugas unduhan cadangan dikenai biaya. Untuk informasi lebih lanjut, lihat Billing.

    3. (Opsional) DescribeDownloadTask: Lihat status dan detail lain dari tugas unduhan cadangan kluster Anda.

    4. Dapatkan file cadangan:

      • Jika tujuan unduhan adalah OSS, sistem akan menulis data langsung ke bucket OSS Anda, tempat Anda dapat melihatnya.

      • Jika tujuan unduhan adalah URL, Anda dapat memanggil operasi DescribeDownloadBackupSetStorageInfo untuk mendapatkan tautan unduhan.

        Catatan

        • Anda dapat memperoleh tautan unduhan dalam waktu tiga hari setelah tugas selesai. Periode validitas tautan dapat diatur dari 5 menit hingga 1 hari. Periode validitas default adalah 2 jam.

        • Tugas yang selesai kedaluwarsa setelah tiga hari, sehingga tautan unduhan juga kedaluwarsa. Data dari tugas yang kedaluwarsa akan dihapus secara otomatis setelah kedaluwarsa. Jika Anda masih memerlukan data tersebut, Anda harus memulai tugas unduhan baru untuk mendapatkan tautan unduhan baru.

        • Simpan tautan unduhan dan jaga kerahasiaannya untuk mencegah kebocoran data.

        • Menggunakan alat unduhan pihak ketiga mungkin menimbulkan traffic unduhan tambahan dan menyebabkan biaya tambahan. Gunakan alat ini dengan hati-hati. Untuk informasi tentang metode unduhan yang direkomendasikan, lihat Download commands.

    FAQ

    Bisakah saya membatalkan tugas unduhan cadangan yang sedang berjalan?

    Tidak. Tugas unduhan cadangan tidak dapat dibatalkan setelah dimulai.

    Bagaimana cara menggunakan file cadangan data dan cadangan log yang diunduh?

    Anda dapat memulihkan file cadangan yang diunduh ke database MySQL yang dikelola sendiri.

    Mengapa saya menerima error ERROR 1148 (42000): The used command is not allowed with this MySQL version saat memulihkan file cadangan yang diunduh ke database MySQL lokal?

    Jalankan kueri show variables like 'local_infile'; pada database MySQL Anda. Jika hasilnya OFF, jalankan pernyataan berikut untuk mengaktifkan impor file: set global local_infile = 1;. Setelah itu, jalankan kembali skrip impor.

    Mengapa ukuran cadangan yang ditampilkan di konsol berbeda dengan ukuran aktual file cadangan yang diunduh?

    File cadangan yang diunduh dikompresi dan biasanya lebih kecil daripada ukuran cadangan yang ditampilkan di konsol. Anda dapat memulihkan file tersebut untuk memeriksa kelengkapan datanya.

    Bisakah saya langsung memulihkan file cadangan yang diunduh ke kluster PolarDB lain?

    Tidak, Anda tidak dapat langsung memulihkan file cadangan yang diunduh ke kluster PolarDB lain. Anda harus terlebih dahulu memulihkan file cadangan ke database MySQL yang dikelola sendiri, lalu menggunakan Data Transmission Service (DTS) untuk memigrasikan data dari database MySQL yang dikelola sendiri ke PolarDB for MySQL.

    Lampiran

    Izin pengguna RAM

    Fitur ini menggunakan RAM untuk mengelola izin. Anda dapat mengonfigurasi izin ini untuk mengontrol pengguna RAM mana yang dapat memperoleh tautan unduhan.

    Berikan izin unduhan kepada pengguna RAM

    Jika Anda tidak dapat menggunakan fitur unduhan cadangan (misalnya, tidak dapat membuat atau menanyakan tugas unduhan), periksa apakah pengguna RAM Anda memiliki izin manajemen untuk pemulihan bencana data (AliyunDBSFullAccess). Untuk informasi lebih lanjut tentang cara memberikan izin, lihat Manage RAM user permissions.

    Blokir tautan unduhan untuk pengguna RAM

    Jika pengguna RAM memerlukan izin untuk menggunakan fitur pencadangan dan pemulihan tetapi harus dicegah agar tidak memperoleh tautan unduhan file cadangan, Anda dapat membuat kebijakan kustom untuk menolak izin pengguna RAM memanggil operasi API yang mengambil tautan unduhan. Skrip berikut adalah contoh kebijakan:

    {
    "Version": "1",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "dbs:DescribeDownloadBackupSetStorageInfo",
            "Resource": "*"
        }
    ]
}

    Setelah membuat kebijakan kustom, attach kebijakan tersebut ke pengguna RAM. Pengguna RAM tersebut kemudian diblokir dari memperoleh tautan unduhan.

    Izinkan pengguna read-only untuk mengunduh cadangan

    Untuk alasan keamanan, pengguna RAM yang hanya memiliki izin read-only untuk PolarDB (AliyunPolardbReadOnlyAccess) tidak dapat mengunduh file cadangan.

    Dalam kasus ini, jika pengguna RAM memerlukan izin untuk mengunduh file cadangan, Anda dapat memberikan izin read-only untuk pemulihan bencana data (AliyunDBSReadOnlyAccess). Setelah izin ini diberikan, pengguna RAM dapat melihat tautan unduhan untuk tugas cadangan yang telah selesai. Untuk informasi lebih lanjut tentang cara memberikan izin, lihat Manage RAM user permissions.

    Perintah unduhan

    Catatan

    • Jika kecepatan unduhan kurang dari 64 KB/detik, unduhan mungkin terputus. Pastikan Anda memiliki koneksi jaringan yang stabil selama proses unduhan.

    • Jika Anda mengunduh file cadangan ke disk yang dipasang dengan ossfs, Anda mungkin perlu menyesuaikan parameter multipart_size untuk ossfs. Secara default, parameter ini mendukung file hingga ukuran 100 GB. Jika file cadangan lebih besar dari 100 GB, unduhan akan gagal. Untuk informasi lebih lanjut tentang ossfs dan parameternya, lihat ossfs dan Mount options.

    • Kami menyarankan Anda menggunakan perintah wget dan curl untuk mengunduh file cadangan. Jika Anda menggunakan alat pihak ketiga lainnya, unduhan ganda mungkin terjadi, artinya jumlah data yang diunduh lebih besar daripada ukuran file cadangan. Anda juga akan dikenai biaya untuk transfer data berlebih karena unduhan menggunakan traffic jaringan publik.

    wget

    nohup wget -c -t 0 "backup_file_download_URL" -O /path/to/destination_filename > /path/to/download.log &

    Parameter

    Parameter

    Deskripsi

    nohup

    Memastikan unduhan tetap berjalan meskipun terminal ditutup atau sesi terputus. Proses akan keluar secara otomatis setelah unduhan selesai.

    -c

    Mengaktifkan unduhan yang dapat dilanjutkan.

    -t

    Menentukan jumlah percobaan ulang. Jika parameter ini diatur ke 0, jumlah percobaan ulang tidak terbatas.

    -O

    Menentukan jalur tujuan dan nama file untuk file yang diunduh.

    Contoh

    nohup wget -c -t 0 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -O /backup/examplebackup.tar.gz > /tmp/download.log &

    curl

    nohup curl -C - --retry 10 "backup_file_download_URL" -o custom_filename > /path/to/download.log &

    Parameter

    Parameter

    Deskripsi

    nohup

    Memastikan unduhan tetap berjalan meskipun terminal ditutup atau sesi terputus. Proses akan keluar secara otomatis setelah unduhan selesai.

    -C -

    Otomatis mengaktifkan unduhan yang dapat dilanjutkan.

    --retry

    Menentukan jumlah percobaan ulang. Jika parameter ini diatur ke 10, perintah akan mencoba ulang sebanyak 10 kali.

    -o

    Menentukan jalur tujuan dan nama file untuk file yang diunduh.

    Contoh

    nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &