All Products
Search
Document Center

PolarDB:Unduh file cadangan

Last Updated:Jan 01, 2026

PolarDB memungkinkan Anda mengunduh file cadangan dari set cadangan kluster ke sistem lokal. File-file tersebut dapat digunakan untuk penyimpanan jangka panjang, kueri data historis, transfer cadangan ke layanan lain seperti Object Storage Service (OSS), serta 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 bertahap dan akan diluncurkan secara bertahap.

Penagihan

Fitur unduh file cadangan memungkinkan Anda mengunduh file melalui URL atau mentransfernya ke Object Storage Service (OSS) Anda. File yang diunduh melalui URL disimpan sementara di DBS Storage. Metode penagihan bergantung pada tujuan pengunduhan, sebagaimana dijelaskan pada bagian berikut:

Catatan
  • Jika tugas pengunduhan gagal, tidak ada biaya yang dikenakan.

  • Buka Konsol PolarDB. Di bawah Settings and Management > Backup and Restoration > Backup Download List, Anda dapat melihat Monthly Backup Compute Data Volume dan Monthly Outbound Internet Traffic untuk kluster Anda.

Biaya penyimpanan

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

  • OSS: File ditransfer ke OSS Anda. Untuk informasi lebih lanjut tentang biaya penyimpanan, lihat biaya penyimpanan Object Storage Service.

Biaya konversi set cadangan

Terlepas dari apakah tujuan pengunduhan adalah URL atau OSS, biaya konversi dikenakan untuk mengonversi set cadangan ke format SQL, CSV, Parquet, atau CSV-with-header. Tidak tersedia kuota gratis untuk konversi format. Tarif harga adalah USD 0,03125 per GB.

Biaya trafik

  • URL:

    • Pengunduhan melalui jaringan internal: Gratis.

    • Pengunduhan melalui Internet: Kuota gratis sebesar 500 GB per bulan disediakan untuk setiap kluster. Trafik yang melebihi kuota gratis ditagih berdasarkan metode bayar sesuai penggunaan. Biaya dihitung harian berdasarkan volume data yang diunduh. Untuk informasi lebih lanjut tentang harga, lihat biaya jaringan.

    Catatan

    Anda dapat membeli network plan berlangganan untuk mengimbangi biaya trafik jaringan saat mengunduh cadangan melalui Internet. Network plan dengan kapasitas lebih besar memberikan diskon yang lebih tinggi.

  • OSS: File ditransfer ke OSS Anda. Untuk informasi lebih lanjut tentang biaya trafik, lihat biaya trafik Object Storage Service.

Prasyarat

  • Kluster: Hanya kluster Edisi Perusahaan dari seri Cluster yang mendukung fitur unduh file cadangan.

  • Wilayah: 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 wilayah lain.

  • Lainnya:

    • Pengguna RAM harus memiliki izin untuk mengunduh file cadangan. Untuk informasi lebih lanjut tentang cara memberikan izin kepada pengguna RAM, lihat izin pengguna RAM.

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

    • Satu kluster atau instans hanya dapat memiliki satu tugas pengunduhan dalam satu waktu. Anda tidak dapat memulai tugas baru jika tugas sebelumnya sedang berjalan atau gagal.

Batasan

  • Anda dapat mengekspor sebagian besar struktur tabel. Namun, beberapa informasi struktural tidak dapat diekspor:

    • 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 tingkat tabel atau tingkat database.

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

  • Bidang dengan tipe data spasial tidak didukung. Jika data berisi bidang dengan tipe berikut, tugas konversi akan gagal:

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

  • File yang diekspor tidak mencakup database sistem berikut:

    information_schema, mysql, performance_schema, sys, __recycle_bin__

  • Jika Anda memilih OSS sebagai tujuan pengunduhan, bucket OSS harus menggunakan kelas penyimpanan Standard. Untuk mengonversi kelas penyimpanan, lihat Konversi kelas penyimpanan.

    Catatan

    Anda harus membuat bucket OSS secara manual. Jika Anda telah membuat bucket untuk menyimpan file cadangan, abaikan langkah ini.

  • Fitur unduh file cadangan hanya mendukung pengunduhan data cadangan level-1. Fitur ini tidak mendukung pengunduhan data cadangan level-2.

  • Jika pengarsipan data dingin diaktifkan untuk kluster, Anda tidak dapat mengunduh set cadangan.

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

Prosedur

(Direkomendasikan) Gunakan konsol

  1. Masuk ke Konsol PolarDB. Di panel navigasi sebelah kiri, klik Clusters. Pilih wilayah tempat kluster berada, lalu klik ID kluster target.

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

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

    image

    Catatan
    • Secara default, konsol menampilkan data cadangan dari 8 hari terakhir. Untuk melihat cadangan yang lebih lama dari 8 hari, ubah rentang waktu.

    • Jika tombol Download Cluster Backup tidak ditampilkan, periksa apakah edisi atau wilayah kluster Anda memenuhi prasyarat.

  4. Pada langkah Download Point-in-time and Backup Set, pilih Download by Point-in-time atau Download by Backup Set, lalu klik Next di pojok kiri bawah halaman.

    image.png

  5. Pada langkah Download Instance and Database/Table, klik Next di pojok kiri bawah halaman. Instance Download dipilih secara default.

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

    Penting
    • Kami menyarankan Anda memilih OSS sebagai tujuan pengunduhan karena lebih cepat.

    • Anda tidak dapat membatalkan tugas pengunduhan cadangan setelah dimulai.

    • Tugas pengunduhan cadangan dikenai biaya. Untuk informasi lebih lanjut, lihat Penagihan.

    (Direkomendasikan) OSS

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

    1. Masukkan nama bucket OSS dan awalan direktori, misalnya xx/xx.

      Catatan
      • Anda harus membuat bucket OSS secara manual. Jika Anda telah membuat bucket untuk menyimpan file cadangan, Anda dapat langsung memasukkan namanya.

      • Kelas penyimpanan bucket OSS harus Standard. Untuk informasi lebih lanjut tentang cara mengonversi kelas penyimpanan, lihat Konversi kelas penyimpanan.

    2. Pilih format pengunduhan. Anda dapat mengatur format pengunduhan menjadi CSV, SQL, Parquet, atau CSV-with-header.

    3. Baca dan centang kotak untuk menyetujui persyaratan. Klik Complete. Halaman akan otomatis dialihkan ke tab Backup Download List. Tunggu hingga tugas pengunduhan selesai.

      Catatan
      • Fitur unduh file cadangan mengharuskan Anda memberikan izin kepada Database Backup Service (DBS) untuk mengakses sumber daya cloud Anda. Jika Anda belum memberikan izin, ikuti petunjuk di konsol untuk mengklik Go to Authorize > Confirm Authorization. Setelah otorisasi berhasil, kembali ke halaman konfigurasi unduhan lanjutan dan selesaikan konfigurasi.

      • Proses konversi bersaing untuk mendapatkan sumber daya komputasi di sisi server. Pengunduhan dapat gagal karena kegagalan alokasi sumber daya sementara. Pengunduhan juga dapat gagal karena format data yang tidak didukung. Jika tugas gagal, Anda dapat mencoba ulang tugas pengunduhan atau menghubungi helpdesk DBS.

      • Tidak ada biaya yang dikenakan untuk tugas yang gagal.

    4. Lihat file cadangan. Jika status tugas adalah Successful, pengunduhan telah selesai. Anda dapat membuka bucket OSS yang sesuai untuk melihat file tersebut.

    URL

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

    Catatan

    Mengunduh melalui URL melibatkan pengemasan data dan memerlukan waktu tunggu tambahan. Waktu yang dibutuhkan bergantung pada ukuran logis set cadangan. Jika ukuran cadangan logis besar, misalnya lebih dari 1 TB, kami menyarankan Anda mengunduh cadangan ke OSS.

    1. Pilih format pengunduhan. Anda dapat mengatur format pengunduhan menjadi CSV, SQL, Parquet, atau CSV-with-header.

    2. Baca dan centang kotak untuk menyetujui persyaratan. Klik Complete. Halaman akan otomatis dialihkan ke tab Backup Download List. Tunggu hingga tugas pengunduhan selesai.

      Catatan
      • Fitur unduh file cadangan mengharuskan Anda memberikan izin kepada DBS untuk mengakses sumber daya cloud Anda. Jika Anda belum memberikan izin, ikuti petunjuk di konsol untuk mengklik Go to Authorize > Confirm Authorization. Setelah otorisasi berhasil, kembali ke halaman konfigurasi unduhan lanjutan dan selesaikan konfigurasi.

      • Proses konversi bersaing untuk mendapatkan sumber daya komputasi di sisi server. Pengunduhan dapat gagal karena kegagalan alokasi sumber daya sementara. Pengunduhan juga dapat gagal karena format data yang tidak didukung. Jika tugas gagal, Anda dapat mencoba ulang tugas pengunduhan atau menghubungi helpdesk DBS.

      • Tidak ada biaya yang dikenakan untuk tugas yang gagal.

    3. Lihat file cadangan. Jika status tugas adalah Successful, pengunduhan telah selesai. Klik Generate Link di kolom Download Destination. Atur Validity Period untuk tautan tersebut dan klik Generate Link. Anda kemudian dapat mengunduh data cadangan menggunakan tautan jaringan internal atau publik yang dihasilkan.

      Catatan
      • Anda dapat memperoleh tautan unduhan dalam waktu tiga hari setelah tugas selesai. Tautan tersebut berlaku selama 5 menit hingga 1 hari. Periode validitas default adalah 2 jam.

      • Tugas yang selesai kedaluwarsa setelah tiga hari, dan tautan unduhan juga kedaluwarsa. Setelah tugas kedaluwarsa, datanya akan dihapus secara otomatis. Jika Anda memerlukan data tersebut, mulai tugas pengunduhan baru untuk mendapatkan tautan baru.

      • Simpan tautan unduhan segera untuk mencegah kebocoran.

      • Menggunakan perangkat lunak pihak ketiga untuk mengunduh file cadangan dapat menyebabkan trafik jaringan tambahan dan mengakibatkan biaya tambahan. Gunakan perangkat lunak tersebut dengan hati-hati. Untuk informasi lebih lanjut tentang metode pengunduhan spesifik, lihat Perintah pengunduhan.

Operasi API

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

    Catatan

    Jika respons API menunjukkan bahwa fitur tidak didukung, periksa apakah edisi atau wilayah kluster Anda memenuhi prasyarat.

  2. CreateDownload: Buat tugas pengunduhan file cadangan.

    Catatan
    • Fitur unduh file cadangan mengharuskan Anda memberikan izin kepada DBS untuk mengakses sumber daya cloud Anda (izin AliyunDBSDefaultRole). Jika Anda belum memberikan izin, Anda dapat memberikannya terlebih dahulu di konsol.

    • Ketika TargetType (jenis tujuan pengunduhan) diatur ke OSS, Anda harus terlebih dahulu membuat bucket yang sesuai secara manual. Kelas penyimpanan bucket OSS harus Standard.

    • Ketika TargetType (jenis tujuan pengunduhan) diatur ke URL, simpan parameter TaskId (ID tugas) yang dikembalikan untuk memperoleh tautan unduhan.

    • Anda tidak dapat membatalkan tugas pengunduhan cadangan setelah dimulai.

    • Tugas pengunduhan cadangan dikenai biaya. Untuk informasi lebih lanjut, lihat Penagihan.

  3. (Opsional) DescribeDownloadTask: Lihat informasi tentang tugas pengunduhan file cadangan kluster saat ini, termasuk status tugas.

  4. Dapatkan file cadangan:

    • Jika jenis tujuan pengunduhan adalah OSS, sistem akan menulis data langsung ke OSS Anda. Anda dapat melihat data tersebut di bucket yang sesuai.

    • Jika jenis tujuan pengunduhan adalah URL, Anda dapat menggunakan DescribeDownloadBackupSetStorageInfo untuk memperoleh tautan unduhan.

      Catatan
      • Anda dapat memperoleh tautan unduhan dalam waktu tiga hari setelah tugas selesai. Tautan tersebut berlaku selama 5 menit hingga 1 hari. Periode validitas default adalah 2 jam.

      • Tugas yang selesai kedaluwarsa setelah tiga hari, dan tautan unduhan juga kedaluwarsa. Setelah tugas kedaluwarsa, datanya akan dihapus secara otomatis. Jika Anda memerlukan data tersebut, mulai tugas pengunduhan baru untuk mendapatkan tautan baru.

      • Simpan tautan unduhan segera untuk mencegah kebocoran.

      • Menggunakan perangkat lunak pihak ketiga untuk mengunduh file cadangan dapat menyebabkan trafik jaringan tambahan dan mengakibatkan biaya tambahan. Gunakan perangkat lunak tersebut dengan hati-hati. Untuk informasi lebih lanjut tentang metode pengunduhan spesifik, lihat Perintah pengunduhan.

FAQ

Dapatkah saya membatalkan tugas pengunduhan cadangan yang sedang berjalan?

Anda tidak dapat membatalkan tugas pengunduhan cadangan setelah dimulai.

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

Saat saya memulihkan file cadangan yang diunduh ke database MySQL lokal, muncul error ERROR 1148 (42000): The used command is not allowed with this MySQL version.

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

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

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

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

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

Lampiran

Izin pengguna RAM

Otentikasi untuk fitur unduh file cadangan bergantung pada pengelolaan izin di Resource Access Management (RAM). Anda dapat mengonfigurasi izin untuk akun Anda guna memperoleh string tautan unduhan menggunakan RAM.

Berikan izin kepada pengguna RAM untuk mengunduh file cadangan

Jika Anda tidak dapat menggunakan fitur unduh cadangan, seperti membuat atau mengkueri tugas pengunduhan, periksa apakah pengguna RAM Anda telah diberikan izin untuk mengelola Pemulihan Bencana Data (AliyunDBSFullAccess). Untuk informasi lebih lanjut tentang cara memberikan izin, lihat Mengelola izin pengguna RAM.

Tolak izin pengguna RAM untuk mendapatkan tautan unduhan file cadangan

Jika pengguna RAM Anda memerlukan izin untuk menggunakan fitur pencadangan dan pemulihan tetapi harus ditolak izin untuk mendapatkan tautan unduhan file cadangan, Anda dapat membuat kebijakan izin kustom untuk menolak pengguna RAM memanggil operasi API yang mendapatkan tautan unduhan. Skrip contoh berikut dapat dijadikan referensi:

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

Setelah membuat kebijakan kustom, berikan kebijakan tersebut kepada pengguna RAM Anda. Dengan demikian, pengguna RAM tersebut ditolak izin untuk memperoleh tautan unduhan.

Izinkan pengguna RAM read-only untuk mengunduh file cadangan

Untuk alasan keamanan, jika pengguna RAM hanya memiliki izin read-only pada sumber daya PolarDB (AliyunPolardbReadOnlyAccess), pengguna tersebut tidak dapat mengunduh file cadangan.

Dalam kasus ini, jika pengguna RAM memerlukan izin untuk mengunduh file cadangan, Anda dapat memberikan izin read-only pada Pemulihan Bencana Data (AliyunDBSReadOnlyAccess). Setelah otorisasi, pengguna RAM tersebut dapat melihat tautan unduhan untuk tugas pengunduhan cadangan yang telah dibuat. Untuk informasi lebih lanjut tentang cara memberikan izin, lihat Mengelola izin pengguna RAM.

image.png

Perintah pengunduhan

Catatan
  • Jika kecepatan unduhan jaringan lebih rendah dari 64 KB/dtk, pengunduhan mungkin terputus. Pastikan koneksi jaringan stabil selama pengunduhan.

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

  • Kami menyarankan Anda menggunakan perintah wget dan curl yang disediakan dalam topik ini untuk mengunduh file cadangan. Jika Anda menggunakan alat pihak ketiga lainnya, suatu file mungkin diunduh beberapa kali. Hal ini dapat menyebabkan volume data yang diunduh sebenarnya lebih besar daripada ukuran file cadangan. Anda akan dikenai biaya untuk lalu lintas Internet keluar yang dihasilkan oleh data berlebih tersebut.

wget

nohup wget -c -t 0 "Download URL of the backup file" -O Path and file name of the destination file > Path to which the download log is output &

Deskripsi metrik

Parameter

Deskripsi

nohup

Mencegah pengunduhan terputus jika Anda secara tidak sengaja melakukan operasi copy atau terminal terputus. Setelah pengunduhan selesai, proses akan keluar secara otomatis.

-c

Mengaktifkan unduhan yang dapat dilanjutkan.

-t

Jumlah percobaan ulang. Jika Anda mengatur parameter ini ke 0, jumlah percobaan ulang tidak terbatas.

-O

Menentukan path dan nama file tujuan.

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 > download_output_log_file &

Deskripsi metrik

Parameter

Deskripsi

nohup

Mencegah pengunduhan terputus jika Anda secara tidak sengaja melakukan operasi copy atau terminal terputus. Setelah pengunduhan selesai, proses akan keluar secara otomatis.

-C -

Mengaktifkan unduhan yang dapat dilanjutkan secara otomatis.

--retry

Jumlah percobaan ulang. Jika Anda mengatur parameter ini ke 10, sistem akan mencoba ulang sebanyak 10 kali.

-o

Menentukan path dan nama file tujuan.

Contoh

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