列挙JET_param

ESENT システム パラメーター。

名前空間:Microsoft.Isam.Esent.Interop
アセンブリ: Microsoft.Isam.Esent.Interop (Microsoft.Isam.Esent.Interop.dll)

構文

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

メンバー

メンバー名 説明
SystemPath このパラメーターは、インスタンスのチェックポイント ファイルを含むフォルダーの相対ファイル システム パスまたは絶対ファイル システム パスを示します。 パスは円記号で終了する必要があります。これは、ターゲット パスがフォルダーであることを示します。
TempPath このパラメーターは、インスタンスの一時データベースを含むフォルダーまたはファイルの相対ファイル システム パスまたは絶対ファイル システム パスを示します。 パスが一時データベースを含むフォルダーの場合は、バックスラッシュ文字で終了する必要があります。
LogFilePath このパラメーターは、インスタンスのトランザクション ログを含むフォルダーの相対ファイル システム パスまたは絶対ファイル システム パスを示します。 パスは円記号で終了する必要があります。これは、ターゲット パスがフォルダーであることを示します。
BaseName このパラメーターは、データベース エンジンで使用される多くのファイルに使用される 3 文字のプレフィックスを設定します。 たとえば、チェックポイント ファイルは EDB と呼ばれます。EDB が既定の基本名であるため、既定では CHK。
EventSource このパラメーターは、データベース エンジンによって出力されるすべてのイベント ログ メッセージに追加されるアプリケーション固有の文字列を提供します。 これにより、イベント ログ メッセージをソース アプリケーションと簡単に関連付けられます。 既定では、ホスト アプリケーションの実行可能ファイル名が使用されます。
MaxSessions このパラメーターは、インスタンスで使用するために要求されたセッション リソースの数を予約します。 セッション リソースは、JET_SESIDデータ型に直接対応します。 この設定は、同時に使用できるセッションの数に影響します。
MaxOpenTables このパラメーターは、インスタンスで使用するために、要求された数の B+ ツリー リソースを予約します。 この設定は、同時に使用できるテーブルの数に影響します。
MaxCursors このパラメーターは、インスタンスで使用するために要求された数のカーソル リソースを予約します。 カーソル リソースは、JET_TABLEIDデータ型に直接対応します。 この設定は、同時に使用できるカーソルの数に影響します。 カーソル リソースは異なるセッションで共有できないため、各セッションで必要な数のカーソルを使用できるように、このパラメーターを十分な大きさに設定する必要があります。
MaxVerPages このパラメーターは、インスタンスで使用するために要求されたバージョン ストア ページの数を予約します。
MaxTemporaryTables このパラメーターは、インスタンスで使用するために要求された一時テーブル リソースの数を予約します。 この設定は、同時に使用できる一時テーブルの数に影響します。 このシステム・パラメーターがゼロに設定されている場合、一時データベースは作成されません。一時データベースの使用を必要とするアクティビティーは失敗します。 この設定は、一時データベースが使用されないことが判明している場合に、一時データベースの作成に必要な I/O を回避するのに役立ちます。

一時テーブルを使用するには、カーソル リソースも必要です。

LogFileSize このパラメーターは、トランザクション ログ ファイルのサイズを構成します。 各トランザクション ログ ファイルは固定サイズです。 サイズは、このシステム パラメーターの設定 (1024 バイト単位) と同じです。
LogBuffers このパラメーターは、トランザクション ログ ファイルに書き込まれる前にログ レコードをキャッシュするために使用されるメモリの量を構成します。 このパラメーターの単位は、トランザクション ログ ファイルを保持するボリュームのセクター サイズです。 セクター サイズは、ほぼ常に 512 バイトであるため、ユニットのサイズを想定しても安全です。 このパラメーターは、パフォーマンスに影響を与えます。 データベース エンジンの更新負荷が高い場合、このバッファーは非常に迅速にいっぱいになる可能性があります。 トランザクション ログ ファイルのキャッシュ サイズを大きくすることは、このような負荷が高い状態で更新のパフォーマンスを向上させるために重要です。 この場合、既定値は小さすぎることがわかっています。 このパラメーターは、トランザクション ログ ファイルのサイズの半分より大きいバッファー (バイト単位) には設定しないでください。
CircularLog このパラメーターは、トランザクション ログ ファイルをデータベース エンジンによって管理する方法を構成します。 循環ログがオフの場合、生成されるすべてのトランザクション ログ ファイルは、データベースの完全バックアップが実行されたため、不要になるまでディスク上に保持されます。 循環ログがオンの場合、現在のチェックポイントより若いトランザクション ログ ファイルのみがディスクに保持されます。 このモードの利点は、古いトランザクション ログ ファイルを削除するためにバックアップを必要としないことです。
DbExtensionSize このパラメーターは、より多くのデータに対応するために拡張する必要があるたびにデータベース ファイルに追加される領域の量を制御します。 サイズはデータベース ページにあります。
PageTempDBMin このパラメーターは、一時データベースの初期サイズを制御します。 サイズはデータベース ページにあります。 サイズが 0 の場合は、通常のデータベースの既定のサイズを使用する必要があることを示します。 多くの場合、小規模なアプリケーションでは、一時データベースをできるだけ小さく構成することが望ましいです。 このパラメーターを SystemParameters.PageTempDBSmallest に設定すると、可能な限り最小の一時データベースが実現されます。
CacheSizeMax このパラメーターは、データベース ページ キャッシュの最大サイズを構成します。 サイズはデータベース ページにあります。 このパラメーターを既定値のままにすると、JetInit の呼び出し時にキャッシュの最大サイズが物理メモリのサイズに設定されます。
CheckpointDepthMax このパラメーターは、クラッシュからの回復にかかる時間を最小限に抑えるために、データベース ページをデータベース ページ キャッシュからフラッシュする頻度を制御します。 このパラメーターは、クラッシュ後に再生する必要があるトランザクション ログ ファイルの数に関するしきい値 (バイト単位) です。 JET_paramを使用して循環ログが有効になっている場合。CircularLog では、このパラメーターによって、ディスクに保持されるトランザクション ログ ファイルのおおよその量も制御されます。
OutstandingIOMax このパラメーターは、ホスト オペレーティング システム内のディスクごとに一度にキューに入れるデータベース ファイル I/O の数を制御します。 このパラメーターの値を大きくすると、大規模なデータベース アプリケーションのパフォーマンスが大幅に向上する可能性があります。
StartFlushThreshold このパラメーターは、キャッシュされていないページのスペースを作るために、データベース ページ キャッシュがキャッシュからページの削除を開始するタイミングを制御します。 キャッシュ内のページ バッファーの数がこのしきい値を下回ると、使用可能なバッファーのプールを補充するためのバックグラウンド プロセスが開始されます。 このしきい値は、JET_paramCacheSizeMaxによって設定された最大キャッシュ サイズに対して常に相対的です。 また、このしきい値は、JET_paramStopFlushThresholdによって設定される停止しきい値よりも常に小さくする必要があります。 開始しきい値の距離の高さは、アプリケーションがバッファーを必要とする前に、データベース ページ キャッシュで使用可能なバッファーを生成するために必要な応答時間を決定します。 開始しきい値が高いほど、バックグラウンド プロセスの反応時間が長くなります。 ただし、開始しきい値が高いほど停止しきい値が高くなります。これにより、変更されたページ (Windows 2000) またはすべてのページ (xp 以降Windows) のデータベース ページ キャッシュの有効サイズが小さくなります。
StopFlushThreshold このパラメーターは、キャッシュされていないページのスペースを作るために、データベース ページ キャッシュがキャッシュからページの削除を終了するタイミングを制御します。 キャッシュ内のページ バッファーの数がこのしきい値を超えると、使用可能なバッファーのプールを補充するために開始されたバックグラウンド プロセスが停止します。 このしきい値は、JET_paramCacheSizeMaxによって設定された最大キャッシュ サイズに対して常に相対的です。 また、このしきい値は、JET_paramStartFlushThresholdによって設定される開始しきい値より常に大きくする必要があります。 開始しきい値と停止しきい値の間の距離は、バックグラウンド プロセスによってデータベース ページがフラッシュされる効率に影響します。 ギャップが大きくなると、隣接するページへの書き込みが結合される可能性が高くなります。 ただし、停止しきい値が高い場合は、変更されたページ (Windows 2000) またはすべてのページ (XP 以降Windows) のデータベース ページ キャッシュの有効サイズが小さくなります。
Recovery このパラメーターは、インスタンスのクラッシュ回復を制御するマスター スイッチです。 このパラメーターが "On" に設定されている場合、ARIES スタイルの回復を使用して、プロセスまたはマシンがクラッシュした場合にインスタンス内のすべてのデータベースが一貫した状態になります。 このパラメーターが "オフ" に設定されている場合、インスタンス内のすべてのデータベースは、クラッシュ回復の利点なしに管理されます。 つまり、プロセスの終了またはマシンのシャットダウンの前に JetTerm を使用してインスタンスがクリーンにシャットダウンされていない場合、そのインスタンス内のすべてのデータベースの内容が破損します。
EnableOnlineDefrag このパラメーターは、 JetDefragment(JET_SESID、JET_DBID、String、Int32、Int32、DefragGrbit)JetDefragment2 (JET_SESID、JET_DBID、String、Int32、Int32、JET_CALLBACK、DefragGrbit) を使用して開始したときのオンライン最適化の動作を制御します。
CacheSize このパラメーターを使用して、実行時のデータベース ページ キャッシュのサイズを制御できます。 通常、キャッシュは、データベースとマシンのアクティビティ レベルの関数として、そのサイズを自動的に調整します。 アプリケーションでこのパラメーターを 0 に設定すると、キャッシュはこの方法で独自のサイズを調整します。 ただし、アプリケーションでこのパラメーターを 0 以外の値に設定すると、キャッシュはそのターゲット サイズに合わせて調整されます。
EnableIndexChecking このパラメーターが true の場合、オペレーティング システムの古いバージョンの NLS ライブラリを使用してビルドされた Unicode キー列のインデックスについては、JetAttachDatabase 時間にすべてのデータベースがチェックされます。 これは、データベース エンジンが LCMapStringW によって生成された並べ替えキーを保持し、これらの並べ替えキーの値がリリースごとに変更されるためです。 プライマリ インデックスがこの状態であることが検出された場合、JetAttachDatabase は常に JET_err で失敗します。PrimaryIndexCorrupted。 セカンダリ インデックスがこの状態であることが検出された場合は、2 つの結果が考えられます。 AttachDatabaseGrbit.DeleteCorruptIndexes が JetAttachDatabase に渡された場合、これらのインデックスは削除され、JetAttachDatabase からJET_wrnCorruptIndexDeletedが返されます。 これらのインデックスは、アプリケーションによって再作成する必要があります。 AttachDatabaseGrbit.DeleteCorruptIndexes が JetAttachDatabase に渡されなかった場合、呼び出しはJET_errSecondaryIndexCorruptedで失敗します。
EventSourceKey このパラメーターを使用して、データベース エンジンがイベント ログ メッセージに使用するイベント ログを制御できます。 既定では、すべてのイベント ログ メッセージがアプリケーション イベント ログに送信されます。 別のイベント ログのレジストリ キー名が構成されている場合、イベント ログ メッセージは代わりにそこに移動します。
NoInformationEvent このパラメーターが true の場合、通常はデータベース エンジンによって生成される情報イベント ログ メッセージは抑制されます。
EventLoggingLevel データベース エンジンによってイベント ログに出力されるイベント ログ メッセージの詳細レベルを構成します。 数値が大きいほど、より詳細なイベント ログ メッセージが生成されます。
DeleteOutOfRangeLogs ソフト リカバリー中に一致しないログ ファイル (生成方法) を削除します。
CacheSizeMin このパラメーターは、データベース ページ キャッシュの最小サイズを構成します。 サイズはデータベース ページにあります。
PreferredVerPages このパラメーターは、データベース エンジンによるバージョン ページの随意使用を制御する MaxVerPages を基準としたしきい値を表します。 バージョン ストアのサイズがこのしきい値を超えた場合、オプションのバックグラウンド タスクにのみ使用される情報 (データベース内の削除された領域を再利用するなど) は、トランザクション情報の領域を保持するために犠牲になります。
DatabasePageSize このパラメーターは、データベースのページ サイズを構成します。 ページ サイズは、データベース ファイルに対して可能な最小の領域割り当ての単位です。 データベースのページ サイズも非常に重要です。これは、データベース内の個々のレコードのサイズの上限を設定するためです。

現時点では、プロセスごとに 1 つのデータベース ページ サイズのみがサポートされています。 つまり、データベース エンジンを使用する異なるアプリケーションを含む 1 つのプロセスでは、データベース ページ サイズにすべて同意する必要があります。

ErrorToString このパラメーターを使用して、JET_ERRを文字列に変換できます。 これは、JetGetSystemParameter でのみ使用する必要があります。
RuntimeCallback JET_CALLBACK デリゲートを使用してエンジン 構成します。 このコールバックは、 FreeCursorLSFreeTableLSまたは Null という理由で呼び出される場合があります。 詳細については、 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 を使用して一度に 1 つのデータベースのみを開くことが許可されます。 一時データベースはこの制限から除外されます。
MaxInstances このパラメーターは、1 つのプロセスで作成できるインスタンスの最大数を制御します。
VersionStoreTaskQueueMax このパラメーターは、データベース エンジン スレッド プールに一度にキューに入れることができるバックグラウンド クリーンアップ作業項目の数を制御します。

関連項目

リファレンス

Microsoft.Isam.Esent.Interop 名前空間