JET_param 列挙型

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

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

構文

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

メンバー

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

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

LogFileSize このパラメーターにより、トランザクションログファイルのサイズが構成されます。 各トランザクションログファイルのサイズは固定されています。 サイズは、1024バイト単位のこのシステムパラメーターの設定に相当します。
LogBuffers このパラメーターは、ログレコードがトランザクションログファイルに書き込まれる前に、ログレコードをキャッシュするために使用されるメモリの量を構成します。 このパラメーターの単位は、トランザクションログファイルを保持するボリュームのセクターサイズです。 セクターサイズは、ほぼ常に512バイトであるため、ユニットのサイズを想定するのは安全です。 このパラメーターは、パフォーマンスに影響します。 データベースエンジンの更新負荷が高い場合、このバッファーはすぐにいっぱいになる可能性があります。 このような高負荷の状態では、更新のパフォーマンスを向上させるために、トランザクションログファイルのキャッシュサイズを大きくすることが重要です。 既定値は、この場合には小さすぎることがわかっています。 このパラメーターには、トランザクションログファイルのサイズの半分よりも大きい (バイト単位の) バッファー数を設定しないでください。
CircularLog このパラメーターは、トランザクションログファイルがデータベースエンジンによってどのように管理されるかを構成します。 循環ログがオフになっていると、データベースの完全バックアップが実行されているために必要なくなるまで、生成されるすべてのトランザクションログファイルがディスクに保持されます。 循環ログをオンにすると、現在のチェックポイントよりも前のトランザクションログファイルのみがディスクに保持されます。 このモードの利点は、古いトランザクションログファイルを削除するためにバックアップを必要としないことです。
DbExtensionSize このパラメーターは、より多くのデータを格納するために拡張する必要があるたびに、データベースファイルに追加される領域のサイズを制御します。 サイズはデータベースページにあります。
PageTempDBMin このパラメーターは、一時データベースの初期サイズを制御します。 サイズはデータベースページにあります。 サイズがゼロの場合は、通常のデータベースの既定のサイズを使用する必要があることを示します。 多くの場合、小規模なアプリケーションでは、一時データベースができるだけ小さくなるように構成することをお勧めします。 このパラメーターを SystemParameters. PageTempDBSmallest に設定すると、可能な限り最小の一時データベースが実現されます。
CacheSizeMax このパラメーターは、データベースページキャッシュの最大サイズを構成します。 サイズはデータベースページにあります。 このパラメーターを既定値のままにした場合、JetInit が呼び出されると、キャッシュの最大サイズが物理メモリのサイズに設定されます。
CheckpointDepthMax このパラメーターは、クラッシュからの復旧にかかる時間を最小限に抑えるために、データベースページキャッシュからデータベースページをどれだけ積極的にフラッシュするかを制御します。 パラメーターは、クラッシュ後に再生する必要があるトランザクションログファイルの数について、バイト単位のしきい値です。 JET_param を使用して循環ログが有効になっている場合。CircularLog このパラメーターは、ディスクに保持されるトランザクションログファイルのおおよその量も制御します。
Outスタンド Ingiomax このパラメーターは、ホストオペレーティングシステムのディスクごとに、一度にキューに入れることができるデータベースファイル i/o の数を制御します。 このパラメーターの値を大きくすると、大規模なデータベースアプリケーションのパフォーマンスを大幅に向上させることができます。
StartFlushThreshold このパラメーターは、キャッシュされていないページの領域を確保するために、データベースページキャッシュがキャッシュからページの作成を開始するタイミングを制御します。 キャッシュ内のページバッファーの数がこのしきい値を下回ると、バックグラウンドプロセスが開始され、使用可能なバッファーのプールが補充されます。 このしきい値は、常に JET_paramCacheSizeMax によって設定された最大キャッシュサイズに対して相対的です。 また、このしきい値は、JET_paramStopFlushThreshold によって設定された停止しきい値未満である必要があります。 開始しきい値の距離の高さによって、アプリケーションが必要とする前に、データベースページキャッシュが使用可能なバッファーを生成するために必要な応答時間が決まります。 高開始しきい値を指定すると、バックグラウンドプロセスが反応するまでの時間が長くなります。 ただし、開始しきい値が高い場合は、停止しきい値が高いことを意味します。これにより、変更されたページ (Windows 2000) またはすべてのページ (Windows XP 以降) のデータベースページキャッシュの有効なサイズが減少します。
StopFlushThreshold このパラメーターは、キャッシュされていないページの領域を確保するために、データベースページキャッシュがキャッシュからページの作成を終了するタイミングを制御します。 キャッシュ内のページバッファーの数がこのしきい値を超えた場合、使用可能なバッファーのプールを補充するために開始されたバックグラウンドプロセスは停止されます。 このしきい値は、常に JET_paramCacheSizeMax によって設定された最大キャッシュサイズに対して相対的です。 また、このしきい値は、JET_paramStartFlushThreshold によって設定された開始しきい値よりも大きくする必要があります。 開始しきい値と停止しきい値の間の距離は、バックグラウンドプロセスによってデータベースページがフラッシュされる効率に影響します。 大きなギャップがあると、隣接するページへの書き込みが結合される可能性が高くなります。 ただし、上限しきい値を大きくすると、変更されたページ (Windows 2000) またはすべてのページ (Windows XP 以降) のデータベースページキャッシュの有効なサイズが減少します。
Recovery このパラメーターは、インスタンスのクラッシュ復旧を制御するマスタースイッチです。 このパラメーターが On に設定されている場合は、 " " プロセスまたはマシンがクラッシュしたときに、インスタンス内のすべてのデータベースを一貫性のある状態にするために、このパラメーターが使用されます。 このパラメーターが Off に設定されている場合、 " " インスタンス内のすべてのデータベースが管理されます。クラッシュ復旧の利点はありません。 つまり、プロセスの終了またはコンピューターのシャットダウンの前に、JetTerm を使用してインスタンスがクリーンにシャットダウンされていない場合、そのインスタンス内のすべてのデータベースの内容が破損することになります。
Enableオンラインデフラグ このパラメーターは、 JetDefragment (JET_SESID、JET_DBID、文字列、int32、int32、DefragGrbit) および JetDefragment2 (JET_SESID、JET_DBID、文字列、int32、int32、JET_CALLBACK、DefragGrbit)を使用して開始されたときのオンライン最適化の動作を制御します。
CacheSize このパラメーターを使用すると、実行時にデータベースページキャッシュのサイズを制御できます。 通常、キャッシュのサイズは、データベースとマシンのアクティビティレベルの機能として自動的に調整されます。 アプリケーションでこのパラメーターを0に設定すると、キャッシュはこの方法で独自のサイズを調整します。 ただし、アプリケーションがこのパラメーターを0以外の値に設定すると、キャッシュはそのターゲットサイズに合わせて調整されます。
EnableIndexChecking このパラメーターが true の場合、オペレーティングシステムで古いバージョンの NLS ライブラリを使用して構築された Unicode キー列に対するインデックスについて、すべてのデータベースが JetAttachDatabase 時にチェックされます。 これは、LCMapStringW によって生成された並べ替えキーがデータベースエンジンによって保持され、これらの並べ替えキーの値がリリースからリリースに変更されるためです。 プライマリインデックスがこの状態であることが検出された場合、JetAttachDatabase は常に JET_err で失敗します。PrimaryIndexCorrupted。 この状態になっていることが検出されたセカンダリインデックスがある場合は、2つの結果が得られます。 DeleteCorruptIndexes が JetAttachDatabase に渡された場合、これらのインデックスは削除され JET_wrnCorruptIndexDeleted、JetAttachDatabase から返されます。 これらのインデックスは、アプリケーションによって再作成される必要があります。 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. Interop 名前空間