Fungsi JetBackup

Berlaku untuk: Windows | Windows Server

Fungsi JetBackup

Fungsi JetBackup membuat cadangan database saat database online. Fungsi ini terutama untuk kompatibilitas mundur dengan Windows 2000 dan mesin database yang lebih lama, di mana hanya satu instans database yang diizinkan. Dalam hal ini, instans aktif adalah instans yang dicadangkan.

    JET_ERR JET_API JetBackup(
      __in          JET_PCSTR szBackupPath,
      __in          JET_GRBIT grbit,
      __in          JET_PFNSTATUS pfnStatus
    );

Parameter

szBackupPath

Direktori tempat cadangan disimpan. Jika jalur cadangan NULL, fungsi akan memotong log, jika memungkinkan.

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	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 sejak pencadangan penuh atau bertahap terakhir yang akan dicadangkan.

pfnStatus

Arahkan ke fungsi panggilan balik JET_PFNSTATUS , yang menyediakan informasi pemberitahuan tentang kemajuan operasi pencadangan.

Tampilkan Nilai

Fungsi mengembalikan salah satu kode kesalahan JET_ERR . Berikut ini adalah yang paling umum dikembalikan. (Untuk daftar lengkap kesalahan untuk API ini, lihat Kode Kesalahan Mesin Penyimpanan yang Dapat Diperluas.)

Menampilkan 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 JetStopService.
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 yang dikembalikan 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 pencadangan 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 yang dikembalikan ini diperkenalkan di Windows XP.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.

Jika fungsi berhasil, semua file yang diperlukan untuk pemulihan hingga saat cadangan akan terkandung dalam direktori cadangan. Jika ini adalah pencadangan 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 untuk membawa database kembali ke keadaan saat cadangan dimulai.

Sebagai efek samping dari cadangan, file log yang tidak lagi diperlukan akan terpotok.

Pada saat yang sama, header database akan diperbarui dengan informasi ketika pencadangan terakhir terjadi.

Jika fungsi gagal, tidak akan ada file apa pun di tujuan direktori cadangan sehingga tidak ada pemulihan yang dapat dilakukan. Pada saat yang sama, file log saat ini tidak akan dipotok.

Keterangan

Langkah-langkah pencadangan yang berbeda akan memiliki entri Log Peristiwa yang dihasilkan, termasuk nama file, pemotokan log, dan hasil akhir pencadangan.

Pencadangan inkremental dimungkinkan hanya setelah pencadangan penuh diambil. Selain itu, pencadangan inkremental hanya dimungkinkan jika pengelogan melingkar dimatikan. Disarankan agar direktori cadangan tidak boleh berisi file apa pun selain yang digunakan 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 log baru akan dibuat. Dengan cara ini, semua file log yang diperlukan dapat berupa salinan, karena log saat ini tidak akan digunakan lagi.

Sangat disarankan agar cadangan tidak digunakan untuk tujuan apa pun selain pencadangan dan pemulihan di tingkat mesin. Ini akan meminimalkan kemungkinan mendapatkan kesalahan selama operasi pencadangan dan pemulihan.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista, Windows XP, atau Windows 2000 Professional.
Server	Memerlukan Windows Server 2008, Windows Server 2003, atau Windows 2000 Server.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.
Unicode	Diimplementasikan sebagai JetBackupW (Unicode) dan JetBackupA (ANSI).

Lihat juga

File Mesin Penyimpanan yang Dapat Diperluas
JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopService
Parameter Sistem