JET_param列舉

ESENT 系統參數。

Namespace:Microsoft.Isam.Esent.Interop
裝配: microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

語法

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

成員

成員名稱 說明
SystemPath 這個參數指出將包含 實例之檢查點檔案的資料夾相對或絕對檔案系統路徑。 路徑必須以反斜線字元終止,這表示目標路徑是資料夾。
TempPath 這個參數表示將包含實例暫存資料庫之資料夾或檔案的相對或絕對檔案系統路徑。 如果路徑是包含暫存資料庫的資料夾,則必須以反斜線字元終止。
LogFilePath 這個參數指出將包含實例交易記錄之資料夾的相對或絕對檔案系統路徑。 路徑必須以反斜線字元終止,這表示目標路徑是資料夾。
BaseName 此參數會設定三個字母前置詞,用於資料庫引擎所使用的許多檔案。 例如,檢查點檔案稱為 EDB。CHK 預設為 ,因為 EDB 是預設的基底名稱。
EventSource 此參數會提供應用程式特定字串,以新增至資料庫引擎所發出的任何事件記錄檔訊息。 這可讓您輕鬆地將事件記錄檔訊息與來源應用程式相互關聯。 根據預設,將會使用主應用程式可執行檔名稱。
MaxSessions 此參數會保留要求的會話資源數目,以供實例使用。 會話資源會直接對應至JET_SESID資料類型。 此設定會影響可以同時使用的會話數目。
MaxOpenTables 此參數會保留要求的 B+ 樹狀結構資源數目,以供實例使用。 此設定會影響同時可以使用的資料表數目。
MaxCursors 此參數會保留要求的資料指標資源數目,以供實例使用。 資料指標資源會直接對應至JET_TABLEID資料類型。 此設定會影響可以同時使用的資料指標數目。 資料指標資源無法由不同的會話共用,因此此參數必須設定為夠大的值,讓每個會話可以使用所需的資料指標數目。
MaxVerPages 此參數會保留要求的版本存放區頁面數目,以供實例使用。
MaxTemporaryTables 此參數會保留要求的臨時表資源數目,以供實例使用。 此設定會影響可以同時使用的臨時表數目。 如果這個系統參數設定為零,則不會建立任何暫存資料庫,而且任何需要使用暫存資料庫的活動都會失敗。 如果已知不會使用暫存資料庫,此設定有助於避免建立暫存資料庫所需的 I/O。

使用臨時表也需要資料指標資源。

LogFileSize 此參數會設定交易記錄檔的大小。 每個交易記錄檔都是固定大小。 大小等於此系統參數的設定單位為 1024 個位元組。
LogBuffers 此參數會在將記錄檔寫入交易記錄檔之前,先設定用來快取記錄檔的記憶體數量。 此參數的單位是保留交易記錄檔之磁片區的磁區大小。 磁區大小幾乎一律為 512 個位元組,因此可以放心地假設單位的大小。 此參數會影響效能。 當資料庫引擎負載過重時,此緩衝區可能會非常快速地滿。 交易記錄檔的較大快取大小對於這類高負載狀況下良好的更新效能而言非常重要。 此案例預設已知太小。 請勿將此參數設定為數個緩衝區, (位元組) 超過交易記錄檔大小的一半。
CircularLog 此參數會設定資料庫引擎如何管理交易記錄檔。 當迴圈記錄關閉時,產生的所有交易記錄檔都會保留在磁片上,直到不再需要它們為止,因為已執行資料庫的完整備份。 當迴圈記錄開啟時,只有小於目前檢查點的交易記錄檔會保留在磁片上。 此模式的優點是備份不需要淘汰舊的交易記錄檔。
DbExtensionSize 此參數可控制每次需要成長以容納更多資料時新增至資料庫檔案的空間量。 大小在資料庫頁面中。
PageTempDBMin 此參數會控制暫存資料庫的初始大小。 大小在資料庫頁面中。 大小為零表示應該使用一般資料庫的預設大小。 小型應用程式通常會將暫存資料庫設定為盡可能小。 將此參數設定為 SystemParameters.PageTempDBSmallest 可達到最小的暫存資料庫。
CacheSizeMax 此參數會設定資料庫頁面快取的大小上限。 大小在資料庫頁面中。 如果此參數保留為其預設值,則呼叫 JetInit 時,快取的大小上限會設定為實體記憶體的大小。
CheckpointDepthMax 此參數可控制從資料庫頁面快取排清資料庫頁面的頻率,以將從當機復原所需的時間降到最低。 參數是以位元組為單位的臨界值,用於當機後需要重新執行多少交易記錄檔。 如果使用 JET_param 啟用迴圈記錄。CircularLog 接著,此參數也會控制將保留在磁片上的大約交易記錄檔數量。
OutstandingIOMax 此參數可控制一次主機作業系統中每個磁片可以排入佇列的資料庫檔案 I/O 數目。 此參數的較大值可大幅協助大型資料庫應用程式的效能。
StartFlushThreshold 這個參數可控制資料庫頁面快取何時開始從快取收回頁面,讓未快取的頁面有空間。 當快取中的頁面緩衝區數目低於此臨界值時,背景進程就會開始補充該可用緩衝區的集區。 此臨界值一律與JET_paramCacheSizeMax所設定的快取大小上限相對。 此閾值也必須一律小於JET_paramStopFlushThreshold所設定的停止閾值。 啟動閾值的距離高度會決定資料庫頁面快取在應用程式需要之前必須產生可用緩衝區的回應時間。 高啟動臨界值會讓背景程式有更多時間來回應。 不過,高啟動臨界值表示較高的停止臨界值,這會減少已修改頁面的有效大小, (Windows 2000) 或所有頁面 (Windows XP 和更新版本) 。
StopFlushThreshold 這個參數可控制資料庫頁面快取何時結束從快取收回頁面,讓未快取的頁面有空間。 當快取中的頁面緩衝區數目高於此臨界值時,就會停止啟動啟動補充可用緩衝區集區的背景進程。 此臨界值一律與JET_paramCacheSizeMax所設定的快取大小上限相對。 此閾值也必須一律大於JET_paramStartFlushThreshold所設定的起始閾值。 啟動臨界值與停止臨界值之間的距離會影響背景進程排清資料庫頁面的效率。 較大的間距會使寫入鄰近頁面的可能比較可能合併。 不過,高停止閾值會減少已修改頁面的有效大小, (Windows 2000) 或所有頁面 (Windows XP 和更新版本) 。
復原 此參數是控制實例損毀復原的主要參數。 如果此參數設定為 「On」,則會使用 ARIES 樣式復原,讓實例中的所有資料庫在進程或電腦當機時處於一致狀態。 如果此參數設定為 「Off」,則會管理實例中的所有資料庫,而不需要損毀復原的好處。 也就是說,如果在進程結束之前未使用 JetTerm 完全關閉實例,或電腦關閉,則該實例中所有資料庫的內容將會損毀。
EnableOnlineDefrag 此參數會控制使用 JetDefragment (JET_SESID、JET_DBID、String、Int32、Int32、Int32、DefragGrbit) JetDefragment2 (JET_SESID、JET_DBID、String、Int32、Int32、Int32、JET_CALLBACK、DefragGrbit) 起始的線上重組行為。
CacheSize 此參數可用來控制執行時間的資料庫頁面快取大小。 一般而言,快取會自動調整其大小作為資料庫和電腦活動層級的功能。 如果應用程式將此參數設定為零,則快取會以這種方式調整自己的大小。 不過,如果應用程式將此參數設定為非零值,則快取會自行調整為該目標大小。
EnableIndexChecking 當此參數為 true 時,JetAttachDatabase 時間會檢查每一個資料庫是否有使用作業系統中舊版 NLS 程式庫所建置之 Unicode 索引鍵資料行的索引。 這必須完成,因為資料庫引擎會保存 LCMapStringW 所產生的排序索引鍵,而且這些排序索引鍵的值會從發行變更為發行。 如果偵測到主要索引處於此狀態,JetAttachDatabase 一律會失敗並JET_err。PrimaryIndexCorrupted。 如果偵測到任何次要索引處於此狀態,則會產生兩個可能的結果。 如果 AttachDatabaseGrbit.DeleteCorruptIndexes 已傳遞至 JetAttachDatabase,則會刪除這些索引,JET_wrnCorruptIndexDeleted會從 JetAttachDatabase 傳回。 您的應用程式必須重新建立這些索引。 如果 AttachDatabaseGrbit.DeleteCorruptIndexes 未傳遞至 JetAttachDatabase,則呼叫將會失敗並JET_errSecondaryIndexCorrupted。
EventSourceKey 此參數可用來控制資料庫引擎用於其事件記錄檔訊息的事件記錄檔。 根據預設,所有事件記錄檔訊息都會移至應用程式事件記錄檔。 如果已設定另一個事件記錄檔的登錄機碼名稱,則事件記錄檔訊息會改為前往該處。
NoInformationEvent 當此參數為 true 時,資料庫引擎通常會產生的參考事件記錄檔訊息將會隱藏。
EventLoggingLevel 設定資料庫引擎發出至事件記錄檔的事件記錄訊息詳細層級。 較高的數位會導致更詳細的事件記錄訊息。
DeleteOutOfRangeLogs 刪除在軟體復原期間不符合 (產生) 的記錄檔。
CacheSizeMin 此參數會設定資料庫頁面快取的大小下限。 大小在資料庫頁面中。
PreferredVerPages 此參數代表相對於 MaxVerPages 的臨界值,控制資料庫引擎對版本頁面的任意使用。 如果版本存放區的大小超過此閾值,則只用于選擇性背景工作的任何資訊,例如回收資料庫中已刪除的空間,會改為犧牲,以保留交易資訊的空間。
DatabasePageSize 此參數會設定資料庫的頁面大小。 頁面大小是資料庫檔案可能的空間配置最小單位。 資料庫頁面大小也很重要,因為它會設定資料庫中個別記錄的大小上限。

目前每個進程只支援一個資料庫頁面大小。 這表示,如果您在包含使用資料庫引擎之不同應用程式的單一進程中,則必須全部同意資料庫頁面大小。

ErrorToString 此參數可用來將JET_ERR轉換成字串。 這應該只與 JetGetSystemParameter 搭配使用。
RuntimeCallback 使用 JET_CALLBACK 委派來設定引擎。 基於下列原因,可能會呼叫此回呼: FreeCursorLSFreeTableLSNull。 如需詳細資訊 ,請參閱 JetSetLS (JET_SESID、JET_TABLEID、JET_LS、LsGrbit) 。 目前無法擷取此參數。
CleanupMismatchedLogFiles 當資料庫引擎設定為開始使用磁片上的交易記錄檔時,此參數會控制 JetInit 的結果,其大小與所設定的大小不同。 一般而言, JetInit (JET_INSTANCE) 會成功復原資料庫,但 會因為 LogFileSizeMismatchDatabasesConsistent 而失敗,以指出記錄檔大小設定不正確。 不過,當此參數設定為 true 時,資料庫引擎會以無訊息方式刪除所有舊的記錄檔,使用設定的記錄檔大小來啟動一組新的交易記錄檔。 當應用程式想要以透明方式變更其交易記錄檔大小,但仍在升級和還原案例中以透明方式運作時,此參數會很有用。
ExceptionAction 此參數可控制資料庫引擎擲回例外狀況或資料庫引擎所呼叫程式碼時會發生什麼情況。 當設定為 JET_ExceptionMsgBox 時,任何例外狀況都會擲回至 Windows 未處理的例外狀況篩選器。 這會導致以應用程式失敗的形式處理例外狀況。 其目的是要防止應用程式程式碼錯誤地嘗試攔截並忽略資料庫引擎所產生的例外狀況。 這無法允許,因為資料庫損毀可能會發生。 如果應用程式想要適當地處理這些例外狀況,則可以藉由將此參數設定為 JET_ExceptionNone 來停用保護。
CreatePathIfNotExist 當此參數設定為 true 時,資料庫引擎會以無訊息方式建立檔案系統路徑中遺漏的任何資料夾。 否則,使用遺漏檔案系統路徑的作業將會因為JET_err而失敗。InvalidPath。
OneDatabasePerSession 當此參數為 true 時,一次只能使用 JetOpenDatabase 開啟一個資料庫。 暫存資料庫會從這項限制中排除。
MaxInstances 此參數可控制可在單一進程中建立的實例數目上限。
VersionStoreTaskQueueMax 此參數可控制一次可排入資料庫引擎執行緒集區的背景清除工作專案數目。

另請參閱

參考

Microsoft.Isam.Esent.Interop 命名空間