All Products
Search
Document Center

ApsaraDB for MongoDB:Unduh file backup

Last Updated:Aug 01, 2026

Anda dapat mengunduh file backup ApsaraDB for MongoDB ke mesin lokal untuk penyimpanan jangka panjang atau memulihkannya ke database yang dikelola sendiri guna pengujian bisnis atau analitik data.

Sebelum memulai

  • Anda tidak dikenai biaya untuk tugas yang gagal.

  • Anda tidak dapat membatalkan tugas unduhan backup setelah dimulai.

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

  • Anda tidak dapat langsung memulihkan instans ApsaraDB for MongoDB dari file backup yang telah diunduh. Untuk memulihkan instans, lihat Pulihkan instans dari file backup.

Penagihan

  • Untuk instans yang menggunakan disk lokal, mengunduh file backup menggunakan Public Connection String atau Private Connection String tidak dikenai biaya.

  • Untuk instans yang menggunakan cloud disk, pengunduhan backup akan dikenai biaya trafik internet arah keluar dan komputasi data backup.

    Biaya trafik

    • Unduhan jaringan internal: Tidak dikenai biaya.

    • Unduhan Internet: Setiap instans memiliki kuota gratis sebesar 500 GB per bulan. Trafik yang melebihi kuota tersebut akan ditagih berdasarkan skema pay-as-you-go. Anda dapat melihat volume trafik yang telah diunduh pada halaman informasi dasar instans ApsaraDB for MongoDB Anda. Untuk informasi lebih lanjut mengenai harga, lihat .

    • Titik penagihan: Penagihan dimulai ketika unduhan aktual dimulai setelah tugas backend berhasil.

    • Penghematan biaya: Untuk unduhan volume besar, pertimbangkan untuk membeli paket jaringan subscription guna mengimbangi biaya trafik.

    • Unduh ke OSS: Dikenai biaya OSS tambahan. Untuk menghindari biaya penyimpanan berkelanjutan, hapus file-file ini secara manual jika sudah tidak diperlukan.

    Biaya komputasi data backup

    Saat Anda mengunduh file backup dari instans cloud disk, cadangan snapshot dikonversi menjadi file BSON, yang menghasilkan biaya komputasi data. Tidak tersedia kuota gratis. Standar penagihan adalah sebagai berikut:

    Wilayah

    Biaya komputasi data (USD/GB)

    Public cloud

    0,03125

    Catatan

    Jika tugas konversi data gagal, Anda tidak dikenai biaya komputasi data backup.

Unduh backup untuk instans cloud disk

Prasyarat

Instans ApsaraDB for MongoDB Anda harus memenuhi persyaratan berikut:

  • Arsitektur: replica set (tidak termasuk instans single-node) atau sharded cluster.

  • Tipe penyimpanan: ESSD cloud disk.

  • Status: Berjalan.

  • Wilayah: Instans berada di salah satu wilayah public cloud yang didukung: Tiongkok (Chengdu), Tiongkok (Guangzhou), Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Shanghai), Tiongkok (Zhangjiakou), Tiongkok (Hangzhou), Tiongkok (Shenzhen), Tiongkok (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta), Jepang (Tokyo), Singapura, Jerman (Frankfurt), AS (Silicon Valley), atau AS (Virginia).

  • Data backup tidak dienkripsi.

  • Jika Anda menggunakan RAM user, pastikan pengguna tersebut memiliki izin yang diperlukan untuk mengunduh file backup.

    Cara memberikan izin kepada RAM user

    1. Masuk ke Konsol RAM menggunakan Akun Alibaba Cloud Anda.

    2. Pada panel navigasi kiri, pilih Permissions > Policies.

    3. Klik Create Policy. Pada tab JSON Editor, masukkan kebijakan berikut, lalu klik Confirm.

      {
        "Statement": [
          {
            "Effect": "Allow",
            "Action": "dds:Describe*",
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "dbs:CreateDownload",
              "dbs:DescribeDBInstanceDownloadSize",
              "dbs:DescribeDownloadSupport"
            ],
            "Resource": "*"
          }
        ],
        "Version": "1"
      }
    4. Pada kotak dialog Create Policy, masukkan Name dan Remarks untuk kebijakan tersebut. Konfirmasi konten kebijakan dan klik Confirm lagi.

    5. Pada panel navigasi kiri, pilih Permissions > Authorize.

    6. Klik Grant Permission dan sambungkan kebijakan yang telah Anda buat ke RAM user tersebut. Untuk informasi lebih lanjut, lihat Berikan izin kepada RAM user pada halaman Authorization.

    7. Klik OK.

Data yang didukung dan tidak didukung

  • Tidak didukung:

    • Database sistem admin, local, dan config.

    • Koleksi sistem yang namanya diawali dengan system..

    • Views dan fungsi.

    • Koleksi time-series.

    • Tugas unduhan akan gagal jika nama database atau koleksi mengandung garis miring (/).

  • Didukung: Koleksi non-time-series dan informasi indeks.

Prosedur

  1. Buka daftar backup

    1. Buka halaman ApsaraDB for MongoDB Replica Set Instances atau halaman ApsaraDB for MongoDB Sharded Cluster Instances. Pilih kelompok sumber daya dan wilayah, lalu klik ID instans target.

    2. Pada panel navigasi kiri halaman instans target, klik Backup and Restoration.

    3. Pada tab Backup Download List, klik Download Instance Backup File.

  2. Mulai tugas unduhan: Pada tab Backup Download, klik Download Instance Backup File.

  3. Konfigurasikan parameter untuk unduhan backup instans

    1. Pada langkah Point in Time and Backup Set, pilih Backup Set yang ingin diunduh, lalu klik Next.

    2. Pada langkah Instance, Database, and Table, pertahankan pengaturan default untuk mengunduh backup instans, lalu klik Next.

    3. Pada langkah Destination and Format, konfigurasikan tujuan dan format unduhan.

      Tujuan

      Konfigurasi

      OSS (Direkomendasikan)

      1. Pilih Write data to your OSS.

      2. Masukkan nama bucket dan awalan direktori bucket OSS tujuan.

        Hanya kelas penyimpanan Standard yang didukung untuk OSS. Untuk mengubah kelas penyimpanan, lihat Konversi kelas penyimpanan.

      3. Pilih Download Format. Format default adalah BSON.

      4. Jika ini pertama kalinya Anda menggunakan fitur ini, klik Go to Authorize > Agree to Authorization sesuai prompt untuk memberikan izin kepada ApsaraDB for MongoDB mengakses OSS.

      URL

      1. Pilih URL.

      2. Pilih format unduhan.

      3. Setelah tugas berhasil, Anda harus membuat tautan unduhan secara manual. Tautan tersebut hanya berlaku dalam periode terbatas.

  4. Konfirmasi dan jalankan tugas: Baca dan setujui persyaratan, lalu klik Complete. Anda akan diarahkan ke tab Backup Download List, tempat Anda dapat memantau status tugas.

  5. Dapatkan file backup

    • Metode OSS: Tunggu hingga status tugas berubah menjadi Successful. File akan disimpan secara otomatis di bucket dan direktori OSS yang ditentukan.

    • Metode URL: Setelah status tugas berubah menjadi Successful, klik Generate Link pada kolom Destination dalam periode validitas 3 hari. Tetapkan periode validitas tautan (dari 5 menit hingga 1 hari; default 2 jam) untuk mendapatkan URL unduhan. Ketika tugas dan tautan kedaluwarsa, data sementara akan dihapus secara otomatis dan Anda harus memulai tugas unduhan baru.

    Penting

    Tugas unduhan dapat gagal karena kegagalan alokasi resource temporary selama konversi data atau format data yang tidak didukung. Jika tugas gagal, coba ulang atau hubungi tim dukungan teknis Pemulihan Bencana Data.

  6. Gunakan tool command line untuk mengunduh file

    Setelah mendapatkan URL:

    • Kami merekomendasikan Anda menggunakan tool command line, seperti wget atau curl, untuk mengunduh file. Untuk informasi lebih lanjut, lihat Lampiran 1: Perintah unduhan dalam topik ini.

    • Untuk file kecil, Anda dapat menyalin URL internet ke bilah alamat browser untuk mengunduh file tersebut.

Unduh backup untuk instans disk lokal

Prasyarat

  1. Anda hanya dapat mengunduh file backup untuk instans disk lokal yang menjalankan MongoDB 4.2 atau versi sebelumnya.

  2. Hanya file Physical Backup dan Logical Backup yang dapat diunduh. Backup Snapshot Backup tidak dapat diunduh. Untuk mengunduh file backup dari instans lain, lihat Apa yang harus saya lakukan jika instans saya tidak mendukung pengunduhan file backup?.

Prosedur

  1. Buka daftar backup

    1. Buka halaman ApsaraDB for MongoDB Replica Set Instances atau halaman ApsaraDB for MongoDB Sharded Cluster Instances. Pilih kelompok sumber daya dan wilayah, lalu klik ID instans target.

    2. Pada panel navigasi kiri halaman instans target, klik Backup and Restoration.

  2. Mulai tugas unduhan

    1. Pada tab Full Backup, temukan file backup yang ingin diunduh dan klik Download pada kolom Actions.

    2. Pada kotak dialog Download Backup, Copy dan catat Public Connection String atau Private Connection String sesuai kebutuhan.

    3. Klik Confirm.

  3. Gunakan tool command line untuk mengunduh file

    Setelah mendapatkan URL:

    • Kami merekomendasikan Anda menggunakan tool command line, seperti wget atau curl, untuk mengunduh file. Untuk informasi lebih lanjut, lihat Lampiran 1: Perintah unduhan dalam topik ini.

    • Untuk file kecil, Anda dapat menyalin URL internet ke bilah alamat browser untuk mengunduh file tersebut.

Lampiran 1: Perintah unduhan

Catatan

Jika koneksi jaringan Anda tidak stabil, pengunduhan melalui Public Connection String dapat timeout. Untuk mengatasi masalah ini:

  • Jika instance ECS dan instans ApsaraDB for MongoDB Anda berada di wilayah yang sama dan keduanya menggunakan jaringan klasik, atau berada di VPC yang sama (dengan ID VPC yang sama), unduh file backup ke instance ECS melalui Private Connection String.

  • Gunakan client yang mendukung unduhan yang dapat dilanjutkan. Di Linux, Anda dapat menggunakan perintah wget seperti di bawah ini.

Unduh di Windows atau macOS

Tempelkan URL unduhan ke bilah alamat browser Anda dan tekan Enter untuk mengunduh file backup.

Unduh di Linux

Jalankan perintah berikut untuk mengunduh file backup:

wget -c '<Download URL of the backup file>' -O <Custom filename><Suffix>

Parameter:

  • -c: mengaktifkan mode unduhan yang dapat dilanjutkan.

  • -O: menyimpan file yang diunduh dengan nama file yang ditentukan.

  • <Suffix>: Ekstensi file biasanya berupa _qp.xb atau .tar.gz. Pastikan ekstensi tersebut sama dengan yang ada di URL unduhan.

Contoh:

wget -c 'http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins5475****/hins1907****_data_20210906103710_qp.xb?Expires=......' -O backupfile._qp.xb

FAQ

Pengunduhan backup yang tidak didukung

Jika instans Anda tidak mendukung pengunduhan file backup, pertimbangkan alternatif berikut:

Unduhan terputus

Di Linux, Anda dapat menambahkan parameter -t 0 ke perintah wget bersama dengan parameter -c. Jika unduhan terputus, wget akan mencoba ulang tanpa batas dan melanjutkan unduhan. Di Windows dan macOS, Anda biasanya dapat melanjutkan unduhan dari halaman manajemen unduhan browser Anda.

Error 403 Forbidden

Verifikasi bahwa perintah unduhan sudah benar. Sertakan URL unduhan dalam tanda kutip tunggal (').

Bagaimana cara mengunduh data dari instans yang kedaluwarsa atau terkunci?

Saat instans subscription kedaluwarsa, instans tersebut akan dikunci dan Anda tidak dapat terhubung ke database. Untuk mengunduh data dari instans tersebut, perpanjang terlebih dahulu instansnya, lalu gunakan salah satu metode berikut:

  • Gunakan utilitas mongodump untuk terhubung ke instans dan mengunduh data. mongodump berfungsi dengan semua jenis instans. Untuk informasi lebih lanjut, lihat mongodump.

  • Gunakan fitur unduhan backup yang dijelaskan dalam topik ini. Fitur ini hanya tersedia untuk instans replica set dan sharded cluster berbasis ESSD. Untuk informasi lebih lanjut, lihat Cakupan penerapan di atas.