列挙JET_param

  • [アーティクル]

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

Namespace: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 このパラメーターは、インスタンスで使用するために要求された一時テーブル リソースの数を予約します。 この設定は、同時に使用できる一時テーブルの数に影響します。 このシステム パラメーターが 0 に設定されている場合、一時データベースは作成されません。一時データベースを使用する必要があるアクティビティは失敗します。 この設定は、一時データベースが使用されないことがわかっている場合に、一時データベースの作成に必要な 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) またはすべてのページ (Windows XP 以降) のデータベース ページ キャッシュの有効サイズが小さくなります。
StopFlushThreshold このパラメーターは、キャッシュされていないページのスペースを作るために、データベース ページ キャッシュがキャッシュからページの削除を終了するタイミングを制御します。 キャッシュ内のページ バッファーの数がこのしきい値を超えると、使用可能なバッファーのプールを補充するために開始されたバックグラウンド プロセスが停止します。 このしきい値は、常に、JET_paramCacheSizeMaxによって設定された最大キャッシュ サイズに対して相対的です。 また、このしきい値は、JET_paramStartFlushThresholdによって設定される開始しきい値を常に超える必要があります。 開始しきい値と停止しきい値の間の距離は、バックグラウンド プロセスによってデータベース ページがフラッシュされる効率に影響します。 ギャップが大きくなると、隣接するページへの書き込みが組み合わされる可能性が高くなります。 ただし、停止しきい値が高い場合、変更されたページ (Windows 2000) またはすべてのページ (Windows XP 以降) のデータベース ページ キャッシュの有効サイズが小さくなります。
Recovery このパラメーターは、インスタンスのクラッシュ回復を制御するマスター スイッチです。 このパラメーターが "オン" に設定されている場合、プロセスまたはマシンがクラッシュした場合にインスタンス内のすべてのデータベースを一貫した状態にするために 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 デリゲートを使用してエンジンを構成します。 このコールバックは、 FreeCursorLS、 FreeTableLS 、 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 名前空間