Fungsi JetBackupInstance
Berlaku untuk: Windows | Windows Server
Fungsi JetBackupInstance
Fungsi JetBackupInstance melakukan pencadangan streaming instans, termasuk semua database terlampir, ke direktori. Dengan beberapa metode pencadangan yang didukung oleh mesin, ini adalah fungsi yang paling sederhana dan paling terenkapsulasi.
Windows XP: JetBackupInstance diperkenalkan di Windows XP.
JET_ERR JET_API JetBackupInstance(
__in JET_INSTANCE instance,
__in JET_PCSTR szBackupPath,
__in JET_GRBIT grbit,
__in JET_PFNSTATUS pfnStatus
);
Parameter
Sebagai contoh
Instans database yang akan dicadangkan.
szBackupPath
Direktori tempat cadangan disimpan. Jika jalur cadangan NULL untuk menggunakan fungsi akan memotong log, jika memungkinkan.
grbit
Sekelompok bit yang menentukan nol atau lebih dari opsi berikut.
Value |
Makna |
---|---|
JET_bitBackupAtomic |
Membuat cadangan lengkap database. Ini memungkinkan pelestarian cadangan yang ada di direktori yang sama jika pencadangan baru gagal. |
JET_bitBackupIncremental |
Membuat cadangan inkremental dibandingkan dengan pencadangan penuh. Ini berarti bahwa hanya file log yang dibuat sejak pencadangan penuh atau bertahap terakhir yang akan dicadangkan. |
JET_bitBackupSnapshot |
Disiapkan untuk penggunaan masa mendatang. |
pfnStatus
Penunjuk ke fungsi panggilan balik JET_PFNSTATUS , yang menyediakan informasi pemberitahuan tentang kemajuan operasi pencadangan.
Tampilkan Nilai
Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan ESE, lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.
Mengembalikan kode |
Deskripsi |
---|---|
JET_errSuccess |
Operasi berhasil diselesaikan. |
JET_errBackupInProgress |
Pencadangan sudah berlangsung untuk instans yang sama. Beberapa cadangan tidak diperbolehkan secara bersamaan. |
JET_errBackupNotAllowedYet |
Instans belum siap untuk pencadangan karena sedang diinisialisasi. |
JET_errClientRequestToStopJetService |
Operasi tidak dapat diselesaikan karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke JetStopServiceInstance. |
JET_errInstanceUnavailable |
Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP. |
JET_errInvalidBackup |
Pencadangan inkremental tidak diperbolehkan jika pengelogan melingkar aktif. |
JET_errInvalidGrbit |
Opsi yang ditentukan tidak valid. |
JET_errInvalidParameter |
Parameter yang tidak valid diteruskan ke API. |
JET_errInvalidPath |
Jalur tujuan tidak ada. |
JET_errLoggingDisabled |
Instans berjalan tanpa pengelogan. Tidak ada cadangan yang diperbolehkan. |
JET_errLogReadVerifyFailure |
Terjadi kesalahan verifikasi checksum pada file log. |
JET_errLogWriteFail |
Pengelogan untuk instans bersifat sementara atau dinonaktifkan secara permanen karena kesalahan yang tidak terduga. |
JET_errNotInitialized |
Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi. |
JET_errReadVerifyFailure |
Terjadi kesalahan verifikasi checksum pada halaman database. |
JET_errRestoreInProgress |
Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi. |
JET_errSessionSharingViolation |
Sesi yang sama tidak dapat digunakan untuk lebih dari satu utas secara bersamaan. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP. |
JET_errTermInProgress |
Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan. |
Setelah fungsi mengembalikan keberhasilan, di direktori cadangan semua file yang diperlukan untuk pemulihan hingga saat cadangan akan ada. Jika ini adalah cadangan penuh, file akan menjadi file database dan file log yang diperlukan untuk membawa database ke status yang konsisten. Jika ini adalah cadangan inkremental, hanya file log yang akan ditambahkan ke direktori tetapi file yang sudah ada (database dan file log) bersama dengan file log baru akan dapat dipulihkan dan membawa database kembali ke status pada saat pencadangan.
Sebagai efek samping dari cadangan, file log yang tidak lagi diperlukan akan dipotong.
Pada saat yang sama, header database akan diperbarui dengan informasi ketika pencadangan terakhir terjadi.
Jika gagal, tidak akan ada file apa pun di tujuan direktori cadangan sehingga tidak ada pemulihan yang dimungkinkan. Pada saat yang sama, file log saat ini tidak akan dipotong.
Keterangan
Langkah-langkah cadangan yang berbeda akan memiliki entri Log Peristiwa yang dihasilkan termasuk nama file, pemotongan log, dan hasil akhir cadangan.
Pencadangan bertahap dimungkinkan hanya setelah pencadangan penuh diambil. Selain itu, pencadangan bertahap hanya dimungkinkan jika pengelogan melingkar dimatikan. Disarankan agar direktori cadangan tidak boleh berisi file lain kemudian yang terlibat dalam cadangan atau ditambahkan oleh cadangan yang berhasil sebelumnya.
Direktori cadangan harus ada kecuali parameter JET_paramCreatePathIfNotExist diatur untuk instans. Untuk informasi, lihat Parameter Sistem.
Cadangan akan melakukan verifikasi checksum pada semua halaman database yang digunakan dan dimulai dengan Windows Server 2003, pada file log juga. Ini memberikan kesempatan untuk memperkirakan kesehatan database bahkan untuk halaman yang tidak dibaca selama operasi normal. Jika terjadi kerusakan seperti itu, pencadangan akan gagal.
Selama pencadangan, file log saat ini akan selesai dan kami akan memulai pembuatan log baru. Ini akan memungkinkan penyalinan file log yang diperlukan karena yang terakhir diperlukan tidak akan digunakan lagi.
Sangat disarankan agar cadangan tidak boleh digunakan untuk tujuan lain selain cadangan dan dipulihkan di tingkat mesin. Ini akan meminimalkan perubahan mendapatkan kesalahan selama operasi pencadangan dan pemulihan.
Persyaratan
Persyaratan | Value |
---|---|
Klien |
Memerlukan Windows Vista atau Windows XP. |
Server |
Memerlukan Windows Server 2008 atau Windows Server 2003. |
Header |
Dinyatakan dalam Esent.h. |
Pustaka |
Gunakan ESENT.lib. |
DLL |
Memerlukan ESENT.dll. |
Unicode |
Diimplementasikan sebagai JetBackupInstanceW (Unicode) dan JetBackupInstanceA (ANSI). |
Lihat Juga
JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Parameter Sistem
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk