enumerasi JET_param

Parameter sistem ESENT.

Namespace:Microsoft.Isam.Esent.Interop
Majelis: Microsoft.Isam.Esent.Interop (dalam Microsoft.Isam.Esent.Interop.dll)

Sintaks

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param
public enum JET_param

Anggota

Nama anggota Deskripsi
SystemPath Parameter ini menunjukkan jalur sistem file relatif atau absolut dari folder yang akan berisi file titik pemeriksaan untuk instans. Jalur harus dihentikan dengan karakter garis miring terbalik, yang menunjukkan bahwa jalur target adalah folder.
TempPath Parameter ini menunjukkan jalur sistem file relatif atau absolut dari folder atau file yang akan berisi database sementara untuk instans. Jika jalurnya adalah ke folder yang akan berisi database sementara, jalur tersebut harus dihentikan dengan karakter garis miring terbalik.
LogFilePath Parameter ini menunjukkan jalur sistem file relatif atau absolut dari folder yang akan berisi log transaksi untuk instans. Jalur harus dihentikan dengan karakter garis miring terbalik, yang menunjukkan bahwa jalur target adalah folder.
BaseName Parameter ini menetapkan awalan tiga huruf yang digunakan untuk banyak file yang digunakan oleh mesin database. Misalnya, file titik pemeriksaan disebut EDB. CHK secara default karena EDB adalah nama dasar default.
EventSource Parameter ini menyediakan string khusus aplikasi yang akan ditambahkan ke pesan log peristiwa apa pun yang dipancarkan oleh mesin database. Ini memungkinkan korelasi pesan log peristiwa yang mudah dengan aplikasi sumber. Secara default nama yang dapat dieksekusi aplikasi host akan digunakan.
MaxSessions Parameter ini mencadangkan jumlah sumber daya sesi yang diminta untuk digunakan oleh instans. Sumber daya sesi secara langsung sesuai dengan jenis data JET_SESID. Pengaturan ini akan memengaruhi berapa banyak sesi yang dapat digunakan secara bersamaan.
MaxOpenTables Parameter ini mencadangkan jumlah sumber daya B+ Tree yang diminta untuk digunakan oleh instans. Pengaturan ini akan memengaruhi berapa banyak tabel yang dapat digunakan secara bersamaan.
MaxCursors Parameter ini mencadangkan jumlah sumber daya kursor yang diminta untuk digunakan oleh instans. Sumber daya kursor secara langsung sesuai dengan jenis data JET_TABLEID. Pengaturan ini akan memengaruhi berapa banyak kursor yang dapat digunakan secara bersamaan. Sumber daya kursor tidak dapat dibagikan oleh sesi yang berbeda sehingga parameter ini harus diatur ke nilai yang cukup besar sehingga setiap sesi dapat menggunakan kursor sebanyak yang diperlukan.
MaxVerPages Parameter ini mencadangkan jumlah halaman penyimpanan versi yang diminta untuk digunakan oleh instans.
MaxTemporaryTables Parameter ini mencadangkan jumlah sumber daya tabel sementara yang diminta untuk digunakan oleh instans. Pengaturan ini akan memengaruhi berapa banyak tabel sementara yang dapat digunakan secara bersamaan. Jika parameter sistem ini diatur ke nol, maka tidak ada database sementara yang akan dibuat dan aktivitas apa pun yang memerlukan penggunaan database sementara akan gagal. Pengaturan ini dapat berguna untuk menghindari I/O yang diperlukan untuk membuat database sementara jika diketahui tidak akan digunakan.

Penggunaan tabel sementara juga memerlukan sumber daya kursor.

LogFileSize Parameter ini akan mengonfigurasi ukuran file log transaksi. Setiap file log transaksi berukuran tetap. Ukurannya sama dengan pengaturan parameter sistem ini dalam satuan 1024 byte.
LogBuffers Parameter ini akan mengonfigurasi jumlah memori yang digunakan untuk menyimpan rekaman log sebelum ditulis ke file log transaksi. Unit untuk parameter ini adalah ukuran sektor volume yang menyimpan file log transaksi. Ukuran sektor hampir selalu 512 byte, sehingga aman untuk mengasumsikan ukuran itu untuk unit. Parameter ini berdampak pada performa. Ketika mesin database berada di bawah beban pembaruan berat, buffer ini dapat menjadi penuh dengan sangat cepat. Ukuran cache yang lebih besar untuk file log transaksi sangat penting untuk performa pembaruan yang baik dalam kondisi beban yang tinggi. Defaultnya diketahui terlalu kecil untuk kasus ini. Jangan atur parameter ini ke sejumlah buffer yang lebih besar (dalam byte) dari setengah ukuran file log transaksi.
CircularLog Parameter ini mengonfigurasi bagaimana file log transaksi dikelola oleh mesin database. Ketika pengelogan melingkar nonaktif, semua file log transaksi yang dihasilkan disimpan pada disk sampai tidak lagi diperlukan karena pencadangan penuh database telah dilakukan. Ketika pengelogan melingkar aktif, hanya file log transaksi yang lebih muda dari titik pemeriksaan saat ini yang dipertahankan pada disk. Manfaat dari mode ini adalah bahwa cadangan tidak diperlukan untuk menghentikan file log transaksi lama.
DbExtensionSize Parameter ini mengontrol jumlah ruang yang ditambahkan ke file database setiap kali perlu tumbuh untuk mengakomodasi lebih banyak data. Ukurannya ada di halaman database.
PageTempDBMin Parameter ini mengontrol ukuran awal database sementara. Ukurannya ada di halaman database. Ukuran nol menunjukkan bahwa ukuran default database biasa harus digunakan. Seringkali diinginkan bagi aplikasi kecil untuk mengonfigurasi database sementara menjadi sesecil mungkin. Mengatur parameter ini ke SystemParameters.PageTempDBSmallest akan mencapai database sementara terkecil.
CacheSizeMax Parameter ini mengonfigurasi ukuran maksimum cache halaman database. Ukurannya ada di halaman database. Jika parameter ini dibiarkan ke nilai defaultnya, maka ukuran maksimum cache akan diatur ke ukuran memori fisik saat JetInit dipanggil.
CheckpointDepthMax Parameter ini mengontrol bagaimana halaman database secara agresif dihapus dari cache halaman database untuk meminimalkan jumlah waktu yang diperlukan untuk memulihkan dari crash. Parameter adalah ambang batas dalam byte tentang berapa banyak file log transaksi yang perlu diputar ulang setelah crash. Jika pengelogan melingkar diaktifkan menggunakan JET_param. CircularLog kemudian parameter ini juga akan mengontrol perkiraan jumlah file log transaksi yang akan dipertahankan pada disk.
OutstandingIOMax Parameter ini mengontrol berapa banyak I/Os file database yang dapat diantrekan per disk dalam sistem operasi host pada satu waktu. Nilai yang lebih besar untuk parameter ini dapat secara signifikan membantu performa aplikasi database besar.
StartFlushThreshold Parameter ini mengontrol kapan cache halaman database mulai mengusir halaman dari cache untuk memberi ruang bagi halaman yang tidak di-cache. Ketika jumlah buffer halaman dalam cache turun di bawah ambang ini, maka proses latar belakang akan mulai mengisi kembali kumpulan buffer yang tersedia. Ambang ini selalu relatif terhadap ukuran cache maksimum seperti yang ditetapkan oleh JET_paramCacheSizeMax. Ambang batas ini juga harus selalu kurang dari ambang batas berhenti seperti yang ditetapkan oleh JET_paramStopFlushThreshold. Tinggi jarak ambang awal akan menentukan waktu respons yang harus dimiliki cache halaman database untuk menghasilkan buffer yang tersedia sebelum aplikasi membutuhkannya. Ambang batas awal yang tinggi akan memberikan proses latar belakang lebih banyak waktu untuk bereaksi. Namun, ambang awal yang tinggi menyiratkan ambang batas pemberhentian yang lebih tinggi dan itu akan mengurangi ukuran efektif cache halaman database untuk halaman yang dimodifikasi (Windows 2000) atau untuk semua halaman (Windows XP dan yang lebih baru).
StopFlushThreshold Parameter ini mengontrol kapan cache halaman database berakhir dengan mengusir halaman dari cache untuk memberi ruang bagi halaman yang tidak di-cache. Ketika jumlah buffer halaman dalam cache naik di atas ambang batas ini maka proses latar belakang yang mulai mengisi kembali bahwa kumpulan buffer yang tersedia dihentikan. Ambang ini selalu relatif terhadap ukuran cache maksimum seperti yang ditetapkan oleh JET_paramCacheSizeMax. Ambang batas ini juga harus selalu lebih besar dari ambang awal seperti yang ditetapkan oleh JET_paramStartFlushThreshold. Jarak antara ambang awal dan ambang batas berhenti memengaruhi efisiensi dengan halaman database mana yang dibersihkan oleh proses latar belakang. Celah yang lebih besar akan membuatnya lebih mungkin menulis ke halaman tetangga dapat digabungkan. Namun, ambang batas pemberhentian tinggi akan mengurangi ukuran efektif cache halaman database untuk halaman yang dimodifikasi (Windows 2000) atau untuk semua halaman (Windows XP dan yang lebih baru).
Pemulihan Parameter ini adalah sakelar master yang mengontrol pemulihan crash untuk instans. Jika parameter ini diatur ke "Aktif" maka pemulihan gaya ARIES akan digunakan untuk membawa semua database dalam instans ke keadaan yang konsisten jika terjadi proses atau crash mesin. Jika parameter ini diatur ke "Nonaktif" maka semua database dalam instans akan dikelola tanpa manfaat pemulihan crash. Artinya, jika instans tidak dimatikan dengan bersih menggunakan JetTerm sebelum proses keluar atau matikan mesin maka konten semua database dalam instans tersebut akan rusak.
EnableOnlineDefrag Parameter ini mengontrol perilaku defragmentasi online saat dimulai menggunakan JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) dan JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit).
CacheSize Parameter ini dapat digunakan untuk mengontrol ukuran cache halaman database pada durasi. Biasanya, cache akan secara otomatis menyempurnakan ukurannya sebagai fungsi tingkat aktivitas database dan komputer. Jika aplikasi menetapkan parameter ini ke nol, maka cache akan menyetel ukurannya sendiri dengan cara ini. Namun, jika aplikasi menetapkan parameter ini ke nilai bukan nol, maka cache akan menyesuaikan dirinya dengan ukuran target tersebut.
EnableIndexChecking Ketika parameter ini benar, setiap database diperiksa pada waktu JetAttachDatabase untuk indeks melalui kolom kunci Unicode yang dibangun menggunakan versi lama pustaka NLS dalam sistem operasi. Ini harus dilakukan karena mesin database mempertahankan kunci pengurutan yang dihasilkan oleh LCMapStringW dan nilai kunci semacam ini berubah dari rilis ke rilis. Jika indeks utama terdeteksi berada dalam status ini maka JetAttachDatabase akan selalu gagal dengan JET_err. PrimaryIndexCorrupted. Jika ada indeks sekunder yang terdeteksi berada dalam status ini, maka ada dua kemungkinan hasil. Jika AttachDatabaseGrbit.DeleteCorruptIndexes diteruskan ke JetAttachDatabase, indeks ini akan dihapus dan JET_wrnCorruptIndexDeleted akan dikembalikan dari JetAttachDatabase. Indeks ini perlu dibuat ulang oleh aplikasi Anda. Jika AttachDatabaseGrbit.DeleteCorruptIndexes tidak diteruskan ke JetAttachDatabase, panggilan akan gagal dengan JET_errSecondaryIndexCorrupted.
EventSourceKey Parameter ini dapat digunakan untuk mengontrol log peristiwa mana yang digunakan mesin database untuk pesan log peristiwanya. Secara default, semua pesan log peristiwa akan masuk ke log peristiwa Aplikasi. Jika nama kunci registri untuk log peristiwa lain dikonfigurasi, maka pesan log peristiwa akan masuk ke sana sebagai gantinya.
NoInformationEvent Ketika parameter ini benar, pesan log peristiwa informasi yang biasanya akan dihasilkan oleh mesin database akan ditekan.
EventLoggingLevel Mengonfigurasi tingkat detail pesan eventlog yang dipancarkan ke eventlog oleh mesin database. Angka yang lebih tinggi akan menghasilkan pesan eventlog yang lebih rinci.
DeleteOutOfRangeLogs Hapus file log yang tidak cocok (generasi bijaksana) selama pemulihan lunak.
CacheSizeMin Parameter ini mengonfigurasi ukuran minimum cache halaman database. Ukurannya ada di halaman database.
PreferredVerPages Parameter ini mewakili ambang relatif terhadap MaxVerPages yang mengontrol penggunaan diskresi halaman versi oleh mesin database. Jika ukuran penyimpanan versi melebihi ambang batas ini, informasi apa pun yang hanya digunakan untuk tugas latar belakang opsional, seperti merebut kembali ruang yang dihapus dalam database, sebaliknya dikorbankan untuk mempertahankan ruang untuk informasi transaksional.
DatabasePageSize Parameter ini mengonfigurasi ukuran halaman untuk database. Ukuran halaman adalah unit terkecil dari alokasi ruang yang mungkin untuk file database. Ukuran halaman database juga sangat penting karena menetapkan batas atas pada ukuran rekaman individual dalam database.

Hanya satu ukuran halaman database yang didukung per proses saat ini. Ini berarti bahwa jika Anda berada dalam satu proses yang berisi aplikasi berbeda yang menggunakan mesin database maka semuanya harus menyetujui ukuran halaman database.

ErrorToString Parameter ini dapat digunakan untuk mengonversi JET_ERR menjadi string. Ini hanya boleh digunakan dengan JetGetSystemParameter.
RuntimeCallback Mengonfigurasi mesin dengan delegasi JET_CALLBACK . Panggilan balik ini dapat dipanggil karena alasan berikut: FreeCursorLS, FreeTableLS , atau Null. Lihat JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit) untuk informasi selengkapnya. Parameter ini saat ini tidak dapat diambil.
CleanupMismatchedLogFiles Parameter ini mengontrol hasil JetInit ketika mesin database dikonfigurasi untuk mulai menggunakan file log transaksi pada disk dengan ukuran yang berbeda dari apa yang dikonfigurasi. Biasanya, JetInit(JET_INSTANCE) akan berhasil memulihkan database tetapi akan gagal dengan LogFileSizeMismatchDatabasesConsistent untuk menunjukkan bahwa ukuran file log salah dikonfigurasi. Namun, ketika parameter ini diatur ke true, maka mesin database akan menghapus semua file log lama secara diam-diam, memulai serangkaian file log transaksi baru menggunakan ukuran file log yang dikonfigurasi. Parameter ini berguna ketika aplikasi ingin mengubah ukuran file log transaksinya secara transparan namun masih berfungsi secara transparan dalam skenario peningkatan dan pemulihan.
ExceptionAction Parameter ini mengontrol apa yang terjadi ketika pengecualian dilemparkan oleh mesin database atau kode yang dipanggil oleh mesin database. Ketika diatur ke JET_ExceptionMsgBox, pengecualian apa pun akan dilemparkan ke filter pengecualian Windows yang tidak tertangani. Ini akan mengakibatkan pengecualian ditangani sebagai kegagalan aplikasi. Tujuannya adalah untuk mencegah kode aplikasi secara keliru mencoba menangkap dan mengabaikan pengecualian yang dihasilkan oleh mesin database. Ini tidak dapat diizinkan karena kerusakan database bisa terjadi. Jika aplikasi ingin menangani pengecualian ini dengan benar, perlindungan dapat dinonaktifkan dengan mengatur parameter ini ke JET_ExceptionNone.
CreatePathIfNotExist Ketika parameter ini diatur ke true maka folder apa pun yang hilang dalam jalur sistem file yang digunakan oleh mesin database akan dibuat secara diam-diam. Jika tidak, operasi yang menggunakan jalur sistem file yang hilang akan gagal dengan JET_err. InvalidPath.
OneDatabasePerSession Ketika parameter ini benar maka hanya satu database yang diizinkan untuk dibuka menggunakan JetOpenDatabase oleh sesi tertentu pada satu waktu. Database sementara dikecualikan dari pembatasan ini.
MaxInstances Parameter ini mengontrol jumlah maksimum instans yang dapat dibuat dalam satu proses.
VersionStoreTaskQueueMax Parameter ini mengontrol jumlah item kerja pembersihan latar belakang yang dapat diantrekan ke kumpulan utas mesin database kapan saja.

Lihat juga

Referensi

Namespace Microsoft.Isam.Esent.Interop