Fungsi JetBeginExternalBackup

Berlaku untuk: Windows | Windows Server

Fungsi JetBeginExternalBackup

Fungsi JetBeginExternalBackup memulai pencadangan eksternal saat mesin dan database sedang online dan aktif. JetBeginExternalBackup adalah yang pertama dalam serangkaian fungsi yang harus dipanggil untuk menjalankan pencadangan online yang berhasil (berbasis non-VSS).

Cadangan eksternal dapat digunakan untuk menerapkan pencadangan penuh, inkremental, atau diferensial.

Cadangan akan fuzzy, karena cadangan akan konsisten ke satu titik waktu dalam riwayat transaksi, tetapi mengontrol titik waktu yang tepat tidak dimungkinkan.

    JET_ERR JET_API JetBeginExternalBackup(
      __in          JET_GRBIT grbit
    );

Parameter

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitBackupAtomic	Bendera ini tidak digunakan lagi. Penggunaan bit ini akan mengakibatkan JET_errInvalidgrbit dikembalikan.
JET_bitBackupIncremental	Membuat cadangan inkremental dibandingkan dengan pencadangan penuh. Ini berarti bahwa hanya file log sejak pencadangan penuh atau bertahap terakhir yang akan dicadangkan.
JET_bitBackupSnapshot	Disiapkan untuk penggunaan masa mendatang. Ditentukan untuk Windows XP.

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.

Menampilkan kode	Deskripsi
JET_errSuccess	Operasi berhasil diselesaikan.
JET_errBackupInProgress	Jika cadangan eksternal atau cadangan rekam jepret sudah dalam proses, kesalahan ini akan dikembalikan, hingga JetBeginExternalBackup (atau salah satu variannya) dipanggil. ESE hanya mengizinkan satu pencadangan online pada satu waktu.
JET_errBackupNotAllowedYet	Instans atau mesin database berada dalam pemulihan atau dalam fase pematian atau penghentian.
JET_errCheckpointCorrupt	Pada cadangan penuh, file titik pemeriksaan tidak dapat dibaca, atau file tidak dapat diverifikasi.
JET_errCheckpointFileNotFound	Pada cadangan penuh, file titik pemeriksaan tidak dapat ditemukan.
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 pengembalian ini diperkenalkan di Windows XP.
JET_errInvalidBackup	Pengelogan melingkar diaktifkan dan jenis cadangan yang ditentukan JET_bitBackupIncremental. Lihat JET_paramCircularLog dalam Kesalahan Log Transaksi untuk informasi tentang cara mengontrol pengelogan melingkar atau non-melingkar.
JET_errInvalidgrbit	Satu atau beberapa anggota grbit tidak valid.
JET_errLoggingDisabled	Pemulihan atau pengelogan dinonaktifkan. Anda tidak dapat melakukan pencadangan online jika pencatatan dinonaktifkan. Untuk informasi selengkapnya tentang pengelogan dan pemulihan, lihat JET_paramRecovery.
JET_errLogWriteFail	Mesin berhenti menulis ke drive log, karena log penuh atau kesalahan IO disk.
JET_errMissingFullBackup	Pencadangan inkremental ditentukan (dengan JET_bitBackupIncremental), dan tidak pernah merupakan cadangan lengkap yang diambil untuk salah satu database terlampir untuk kumpulan pengelogan.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi.
JET_errOutOfMemory	Operasi gagal karena memori tidak cukup dapat dialokasikan untuk menyelesaikannya.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errRunningInMultiInstanceMode	Operasi gagal karena upaya dilakukan untuk menggunakan mesin dalam mode warisan (mode kompatibilitas Windows 2000) di mana hanya satu instans yang didukung ketika sebenarnya beberapa instans sudah ada.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.

Jika fungsi berhasil, cadangan eksternal dimulai dan mesin status cadangan diinisialisasi. API berikutnya sekarang dapat dipanggil untuk menyelesaikan urutan cadangan eksternal dan mengalirkan atau membaca file database, file patch database (jika didukung), dan file log. Peristiwa dapat dicatat bahwa pencadangan eksternal telah dimulai.

Jika fungsi gagal, sesi pencadangan tidak akan dimulai. Jika sesi pencadangan lain sedang berlangsung, sesi tersebut tidak akan dibatalkan.

Keterangan

Proses pencadangan eksternal (seperti yang dimulai oleh JetBeginExternalBackup) dirancang untuk memungkinkan pencadangan online transaksi fuzzy dari seluruh instans ke perangkat target sebagai aliran. Cadangan akan berisi semua file database yang dilampirkan ke instans menggunakan JetAttachDatabase (untuk pencadangan penuh), diikuti oleh file patch database terkait (jika didukung), dan akhirnya oleh file log transaksi yang dihasilkan selama proses pencadangan. Hasil akhirnya akan menjadi sekumpulan file yang dapat dipulihkan dari aliran, mungkin dikombinasikan dengan database dan file log yang ada, dan akhirnya dipulihkan ke keadaan yang konsisten.

Urutan umum operasi untuk pencadangan penuh terdiri dari panggilan berikut. Pertama, JetBeginExternalBackup dipanggil untuk memulai proses pencadangan. Kemudian, JetGetAttachInfo dipanggil untuk mendapatkan daftar database yang dilampirkan ke instans yang perlu dicadangkan. Untuk masing-masing database ini, JetOpenFile dipanggil, diikuti oleh sejumlah panggilan JetReadFile , lalu melalui panggilan ke JetCloseFile. Kemudian, JetGetLogInfo dipanggil untuk mendapatkan daftar patch database dan file log yang akan dicadangkan. Untuk masing-masing file ini, urutan lain dari panggilan JetOpenFile, JetReadFile, dan JetCloseFile dilakukan. Kemudian, setiap file log transaksi yang tidak diinginkan dihapus menggunakan JetTruncateLog. Akhirnya, pencadangan berakhir dengan panggilan ke JetEndExternalBackup.

Dimungkinkan juga untuk memodifikasi serangkaian langkah ini untuk melakukan pencadangan instans bertahap. Cadangan inkremental menghitung dan mencadangkan file log. Pencadangan inkremental hanya dimungkinkan jika pengelogan melingkar tidak diaktifkan.

Dimungkinkan juga untuk memodifikasi serangkaian langkah ini untuk memungkinkan pencadangan diferensial instans berikutnya dilakukan. Untuk melakukan pencadangan diferensial, jangan panggil JetTruncateLog di cadangan penuh atau bertahap sebelumnya. Dengan tidak memanggil JetTruncateLog, Anda mengaktifkan pencadangan berikutnya untuk diferensial sehubungan dengan pencadangan penuh atau bertambah bertahap terakhir. Pencadangan diferensial hanya dimungkinkan jika pengelogan melingkar tidak diaktifkan.

File patch database adalah file tambahan khusus yang digunakan untuk menyimpan gambar halaman database dalam keadaan tertentu selama pencadangan. File ini harus ada di lokasi yang sama dengan database terkait selama operasi pemulihan. File ini hanya digunakan di Windows 2000. Akibatnya, aplikasi apa pun yang ditulis untuk bekerja terhadap Windows 2000 dan rilis lainnya harus mendukung file patch database, jika ada, tetapi juga tidak boleh gagal jika tidak ada.

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.

Lihat juga

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackupInstance
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog