JET_param 列舉

ESENT 系統參數。

命名空間: Microsoft. Isam. Interop
元件: (在 Microsoft.Isam.Esent.Interop.dll) 中的 Microsoft。

語法

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

成員

成員名稱 說明
SystemPath 此參數表示將包含實例之檢查點檔案之資料夾的相對或絕對檔案系統路徑。 路徑必須以反斜線字元結束,表示目標路徑是資料夾。
TempPath 此參數表示將包含實例之暫存資料庫之資料夾或檔案的相對或絕對檔案系統路徑。 如果路徑是要包含暫存資料庫的資料夾,則必須以反斜線字元作為結尾。
>logfilepath 此參數表示將包含實例之交易記錄之資料夾的相對或絕對檔案系統路徑。 路徑必須以反斜線字元結束,表示目標路徑是資料夾。
BaseName 此參數會設定用於資料庫引擎所使用之許多檔案的三個字母前置詞。 例如,檢查點檔案稱為「EDB」。因為 EDB 是預設的基底名稱,所以預設為使用 .CHK。
EventSource 此參數會提供應用程式特定的字串,該字串將會新增至 database engine 發出的任何事件記錄檔訊息。 這可讓事件記錄檔訊息與來源應用程式輕鬆相互關聯。 預設會使用主應用程式的可執行檔名稱。
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、DefragGrbit) JetDefragment2 (JET_SESID、JET_DBID、String、int32、int32、JET_CALLBACK、DefragGrbit) 所起始的線上磁碟重組行為。
CacheSize 這個參數可以用來控制執行時間的資料庫頁面快取大小。 一般來說,快取會自動將其大小調整為資料庫和電腦活動層級的功能。 如果應用程式將此參數設定為零,則快取會以這種方式調整其本身的大小。 但是,如果應用程式將此參數設定為非零值,則快取會將本身調整為該目標大小。
EnableIndexChecking 當此參數為 true 時,系統會在 JetAttachDatabase 階段檢查每個資料庫,以取得在作業系統中使用舊版 NLS 程式庫建立的 Unicode 索引鍵資料行的索引。 這必須完成,因為資料庫引擎會保存 LCMapStringW 所產生的排序索引鍵,而這些排序索引鍵的值會從 release 變更為 release。 如果偵測到主要索引處於此狀態,則 JetAttachDatabase 一律會失敗,並 JET_err。PrimaryIndexCorrupted. 如果偵測到任何次要索引處於此狀態,則有兩個可能的結果。 如果將 AttachDatabaseGrbit DeleteCorruptIndexes 傳遞至 JetAttachDatabase,則會刪除這些索引,並從 JetAttachDatabase 傳回 JET_wrnCorruptIndexDeleted。 您的應用程式將需要重新建立這些索引。 如果 AttachDatabaseGrbit 未傳遞至 JetAttachDatabase,則呼叫會失敗,並 JET_errSecondaryIndexCorrupted。
EventSourceKey 這個參數可以用來控制 database engine 針對其事件記錄檔訊息所使用的事件記錄檔。 依預設,所有事件記錄檔訊息都會移至應用程式事件記錄檔。 如果已設定另一個事件記錄檔的登錄機碼名稱,則會改為將事件記錄檔訊息移至該處。
NoInformationEvent 當此參數為 true 時,將會隱藏資料庫引擎通常會產生的資訊事件記錄檔訊息。
EventLoggingLevel 設定資料庫引擎發出給 eventlog 的 eventlog 訊息詳細層級。 較高的數位將會產生更詳細的事件記錄檔訊息。
DeleteOutOfRangeLogs 刪除在軟復原期間 (產生) 不相符的記錄檔。
CacheSizeMin 此參數會設定資料庫頁面快取的大小下限。 大小是在資料庫頁面中。
PreferredVerPages 此參數代表相對於 MaxVerPages 的臨界值,可控制 database engine 任意使用版本頁面。 如果版本存放區的大小超過此臨界值,則只會針對選擇性的背景工作(例如回收資料庫中已刪除的空間)使用任何資訊,而不會犧牲保存交易資訊的空間。
DatabasePageSize 此參數會設定資料庫的頁面大小。 頁面大小是資料庫檔案可能的最小空間配置單位。 資料庫頁面大小也非常重要,因為它會在資料庫中設定個別記錄大小的上限。

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

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

另請參閱

參考

Microsoft. Esent 命名空間