Mencadangkan dan Memulihkan Data Menggunakan APICompatible with Milvus Backup 0.6.x
Gunakan API HTTP Milvus Backup untuk membuat cadangan, memulihkan koleksi, dan memantau tugas asinkron. Contoh snapshot di bawah ini memerlukan Milvus 3.0.1 atau versi yang lebih baru. Untuk Milvus Backup 0.5.x, gunakan panduan API 0.5.x. Untuk instalasi yang sudah ada, lihat Memperbarui Milvus Backup.
Mendapatkan Milvus Backup
Contoh di bawah ini telah divalidasi dengan Milvus Backup 0.6.0. Unduh dan ekstrak biner yang sesuai dari rilis v0.6.0. Untuk membangun dari sumber, ikuti Mendapatkan Milvus Backup; proses pembangunan memerlukan Go 1.26 atau yang lebih baru.
Siapkan berkas konfigurasi
Buat berk configs/backup.yaml menggunakan contoh v2 di Siapkan berkas konfigurasi. Konfigurasikan akses ke Milvus, penyimpanan instance, dan tujuan pencadangan. Server Milvus juga harus dapat mengakses penyimpanan pencadangan untuk operasi snapshot.
Jika Anda memiliki berkas v1, berkas tersebut masih dapat dimuat. Lihat " Migrasi Konfigurasi " sebelum mengubah skema atau variabel lingkungannya.
Dari direktori yang berisi file biner, periksa konfigurasi dan uji konektivitas:
./milvus-backup config show --config configs/backup.yaml
./milvus-backup check --config configs/backup.yaml
Lanjutkan jika pemeriksaan konektivitas melaporkan " Success!".
Jalankan server API
Jalankan layanan dengan konfigurasi yang telah Anda periksa:
./milvus-backup server --config configs/backup.yaml
Port defaultnya adalah 8080. Untuk memilih port lain, gunakan -p:
./milvus-backup server -p 18080 --config configs/backup.yaml
Jalankan hanya salah satu perintah ini untuk layanan tertentu. Contoh di bawah ini menggunakan port 8080; ubah URL-nya jika Anda memilih port lain. Swagger UI tersedia di http://localhost:8080/api/v1/docs/index.html.
Biarkan layanan tetap berjalan saat melakukan polling tugas. ID tugas dan kemajuan real-time merupakan bagian dari proses layanan; cadangan yang disimpan tetap berada di penyimpanan objek setelah proses berhenti.
Siapkan data
Gunakan koleksi yang sudah ada bernama coll, atau buat koleksi uji dengan 256 entitas dari Siapkan data sampel. Ubah nama koleksi dalam permintaan jika Anda menggunakan data Anda sendiri. Pertahankan data uji tetap tidak berubah saat memverifikasi hasilnya.
Cadangkan data
Kirim permintaan cadangan asinkron:
curl --request POST 'http://localhost:8080/api/v1/create' \
--header 'Content-Type: application/json' \
--data '{
"async": true,
"backup_name": "my_backup",
"collection_names": ["coll"]
}'
Responsnya mencakup nilai ` requestId`. Pengiriman permintaan tidak berarti bahwa pencadangan telah selesai. Salin nilai tersebut ke ` backup_id ` dan lakukan polling:
curl 'http://localhost:8080/api/v1/get_backup?backup_id=BACKUP_REQUEST_ID&backup_name=my_backup'
Tunggu hingga data.state_code berubah menjadi 2. API ini menggunakan status tugas berikut:
state_code | Arti |
|---|---|
0 | Awal |
1 | Sedang dieksekusi |
2 | Berhasil |
3 | Gagal |
4 | Waktu habis |
Periksa baik respons maupun status tugas. Kode HTTP 200 saja tidak cukup: nilai respons ` code ` yang tidak nol menandakan adanya kesalahan. Respons yang berhasil dapat mengabaikan ` code ` karena nilainya nol. Jika suatu tugas gagal atau habis waktu, periksa detail respons dan log server sebelum memulihkan dari cadangan tersebut.
Tampilkan daftar cadangan yang tersimpan dan periksa cadangan yang telah selesai berdasarkan namanya:
curl 'http://localhost:8080/api/v1/list'
curl 'http://localhost:8080/api/v1/get_backup?backup_name=my_backup'
get_backup mengembalikan metadata JSON, termasuk collection_backups; perintah ini tidak mengunduh berkas cadangan. Untuk cadangan yang dibuat oleh proses lain, kueri berdasarkan nama saja dapat mengembalikan metadata tanpa menampilkan kemajuan tugas yang sedang berjalan. Gunakan ID tugas dari respons create layanan saat ini saat memantau cadangan yang aktif.
Format defaultnya adalah auto, yang memilih snapshot pada Milvus 3.0. Untuk secara eksplisit meminta binlog, tambahkan "format": "binlog" ke badan permintaan create. Preset --for pada CLI bukanlah bidang permintaan HTTP.
Untuk menyimpan atau memindahkan cadangan, salin seluruh direktori ke penyimpanan objek. Lihat panduan transfer versi 0.6.0.
Memulihkan data
Pastikan bahwa coll_bak belum ada. Kirimkan permintaan pemulihan dengan sufiks:
curl --request POST 'http://localhost:8080/api/v1/restore' \
--header 'Content-Type: application/json' \
--data '{
"async": true,
"backup_name": "my_backup",
"collection_names": ["coll"],
"collection_suffix": "_bak"
}'
Bidang HTTP ` collection_names ` memilih nama-nama dalam cadangan, sebelum sufiks diterapkan. Permintaan ini memilih ` coll ` dan membuat ` coll_bak`. Sebaliknya, opsi ` --filter ` pada CLI mencocokkan nama tujuan setelah penggantian nama; jangan mengganti ` coll_bak ` ke dalam bidang HTTP ini.
Salin data.id dari respons pemulihan dan periksa status tugas:
curl 'http://localhost:8080/api/v1/get_restore?id=RESTORE_TASK_ID'
Tunggu hingga data.state_code: 2 dan periksa collection_restore_tasks untuk melihat kumpulan target yang diharapkan. Tugas yang telah dikirimkan belum berarti pemulihan telah diverifikasi.
Pemulihan dengan nama asli
Gunakan instance target di mana coll tidak ada. Mulai layanan API cadangan terpisah yang dikonfigurasi untuk target tersebut dan lokasi cadangan yang telah selesai, lalu kirim permintaan ini ke layanan target:
curl --request POST 'http://localhost:8080/api/v1/restore' \
--header 'Content-Type: application/json' \
--data '{
"async": true,
"backup_name": "my_backup",
"collection_names": ["coll"],
"collection_suffix": ""
}'
Periksa get_restore pada layanan yang sama menggunakan ID tugas yang dikembalikan. Konfigurasikan milvus.* untuk target pemulihan dan backup.storage untuk cadangan yang ada. Lihat Siapkan berkas konfigurasi.
Verifikasi data yang dipulihkan
Setelah tugas pemulihan berhasil, sambungkan ke instance Milvus tujuan dan verifikasi bahwa koleksi dan data yang diharapkan ada. Untuk koleksi uji 256 entitas, gunakan pemeriksaan skalar, vektor, dan pencarian lengkap di "Verifikasi hasil".
Ubah coll_bak menjadi coll saat Anda memulihkan dengan nama asli. Kode verifikasi membaca data yang dipulihkan tanpa menghapusnya. Untuk data produksi, bandingkan dengan baseline yang diambil pada saat pencadangan.