19.2. キャッシュストア設定の詳細 （ライブラリモード)

passivation パラメーターは、Red Hat JBoss Data Grid がストアと対話する方法に影響を与えます。オブジェクトがインメモリーキャッシュから削除されると、パッシベーションによりオブジェクトがシステムやデータベースなどの 2 次データストアに書き込まれます。このパラメーターの有効な値は、true と false ですが、passivation はデフォルトで false に設定されます。

shared パラメーターは、異なるキャッシュインスタンスによってキャッシュストアが共有されていることを示します。たとえば、クラスター内のすべてのインスタンスが、同じリモートの共有データベースと通信するために同じ JDBC 設定を使用する場合があります。shared は、デフォルトで false になります。true に設定すると、異なるキャッシュインスタンスによって重複データがキャッシュストアに書き込まれることが避けられます。LevelDB キャッシュストアの場合は、このパラメーターを設定から除外するか、false に設定する必要があります (このキャッシュストアの共有はサポートされていません)。

preload パラメーターはデフォルトで false に設定されます。true に設定されると、キャッシュストアに保存されたデータは、キャッシュの起動時にメモリーにプリロードされます。これにより、キャッシュストアのデータが起動後すぐに利用できるようになり、データのレイジーなロードの結果としてキャッシュ操作の遅れを防ぐことができます。プリロードされたデータは、ノード上でローカルにのみに保存され、プリロードされたデータのレプリケーションや分散は行われません。Red Hat JBoss Data Grid は、エビクションのエントリーの最大設定数までの数のエントリーをプリロードします。

fetch-state パラメーターは、キャッシュの永続ステートを取り込むかどうかを決定し、クラスターに参加する際にこれをローカルキャッシュストアに適用します。キャッシュストアが共有される場合、キャッシュが同じキャッシュストアにアクセスする際に、fetch persistent 状態は無視されます。複数のキャッシュストアでこのプロパティーが true に設定されている場合にキャッシュサービスを起動すると、設定の例外がスローされます。fetch-state プロパティーはデフォルトでは false です。

ルックアップを迅速化するために、単一ファイルキャッシュストアはキーのインデックスとファイル内のそれらの場所を保持します。このインデックスがメモリー消費の問題の原因になるのを避けるために、このキャッシュストアは、max-entries パラメーターで定義される、保存されるエントリーの最大数でバインドすることができます。この制限の上限を上回る場合は、LRU アルゴリズムを使用してエントリーをインメモリーインデックスと基礎となるファイルベースのキャッシュストアの両方から永久的に削除できます。デフォルト値は -1 で、無制限のエントリーを許可します。

singleton パラメーターは、シングルトンストアのキャッシュストアを有効にします。SingletonStore は、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用される委譲するキャッシュストアです。ただし、singleton パラメーターは file-store には推奨されません。デフォルト値は false です。

purge パラメーターは、起動時にキャッシュストアがパージされるかどうかを制御します。

location 設定要素は、ストアが書き込みできるディスクの場所を設定します。

thread-pool-size パラメーターは、変更をストアに同時に適用するスレッドの数を指定します。このパラメーターのデフォルト値は 1 です。

flush-lock-timeout パラメーターは、キャッシュストアに定期的にフラッシュされる状態を保護するロックを取得するための時間を指定します。このパラメーターのデフォルト値は 1 です。

modification-queue-size パラメーターは、非同期ストアの変更キューのサイズを指定します。基礎となるキャッシュストアがこのキューを処理するよりも速く更新される場合に、その期間において非同期ストアは同期ストアのように動作し、キューがさらに要素を許可できるようになるまでブロックします。このパラメーターのデフォルト値は 1024 要素です。

shutdown-timeout パラメーターは、キャッシュストアを停止するのにかかる最大時間を指定します。このパラメーターのデフォルト値は 25000 ミリ秒です。

cache 属性は、リモート Infinispan クラスターで接続するリモートキャッシュの名前を指定します。リモートキャッシュの名前が指定されないと、デフォルトのキャッシュが使用されます。

fetch-state 属性が true に設定されると、リモートキャッシュがクラスターに参加したときに永続状態が取り込まれます。複数のキャッシュストアがチェーン化されている場合、1 つのキャッシュストアだけでこのプロパティーを true に設定できます。この値のデフォルトは false です。

shared 属性は、複数のキャッシュインスタンスがキャッシュストアを共有する場合に true に設定されます。これにより、複数のキャッシュインスタンスが同じ変更内容を個別に書き込むことを防ぐことができます。この属性のデフォルト値は false です。

preload 属性を使用すると、キャッシュストアデータがメモリーにプリロードされ、起動後すぐにアクセス可能になります。これを true に設定すると、起動時間が増加するという不利な点もあります。この属性のデフォルト値は false です。

singleton パラメーターは、SingletonStore の委譲するキャッシュストアを有効にします。これは、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用されます。デフォルト値は false です。

purge 属性を使用すると、キャッシュストアが起動プロセスでパージされます。この属性のデフォルト値は false です。

tcp-no-delay 属性は、TCP NODELAY スタックをトリガーします。この属性のデフォルト値は true です。

ping-on-start 属性は、クラスタートポロジーを取り込むために ping 要求をバックエンドサーバーに送信します。この属性のデフォルト値は true です。

key-size-estimate 属性は、キーサイズの推定値を提供します。この属性のデフォルト値は 64 です。

value-size-estimate 属性は、値をシリアライズおよびデシリアライズする時のバイトバッファーのサイズを指定します。この属性のデフォルト値は 512 です。

force-return-values 属性は、FORCE_RETURN_VALUE をすべての呼び出しに対して有効にするかどうかを設定します。この属性のデフォルト値は false です。

host 属性はホストアドレスを設定します。

port 属性は、リモートキャッシュストアで使用されるポートを設定します。これはデフォルトで 11222 になります。

max-active パラメーターは、一度に各サーバーに設定できるアクティブな接続の最大数を示します。この属性のデフォルト値は -1 であり、これはアクティブな接続の無限な数を示します。

max-idle パラメーターは、一度に各サーバーに設定できるアイドル状態の接続の最大数を示します。この属性のデフォルト値は -1 であり、これはアイドル状態の接続の無限な数を示します。

max-total パラメーターは、組み合わされたサーバーセット内の永続的な接続の最大数を示します。この属性のデフォルト設定は -1 であり、これは接続の無限な数を示します。

min-idle-time パラメーターは、常に利用可能にする必要のある (各サーバーの) アイドル状態の接続の最小数のターゲット値を設定します。パラメーターが正の数値と timeBetweenEvictionRunsMillis > 0 に設定される場合、アイドル状態の接続のエビクションスレッドが実行されるたびに、各サーバーで minIdle アイドルインスタンスを利用できるように十分な数のアイドルインスタンスを作成しようとします。このパラメーターのデフォルト設定は 1 です。

eviction-interval パラメーターは、アイドル接続の検査の「実行」前にエビクションスレッドをスリープ状態にする必要のある時間を示します。正の数値でない場合、エビクションスレッドは起動しません。このパラメーターのデフォルト設定は 120000 ミリ秒、つまり 2 分です。

min-evictable-idle-time パラメーターは、アイドル時間により接続がエビクションの候補となる前にプール内でアイドル状態になる最小時間を指定します。正の数値でない場合、アイドル時間によりプールからドロップされる接続はありません。この設定は timeBetweenEvictionRunsMillis > 0 でない限り影響を与えません。このパラメーターのデフォルト設定は 1800000 つまり (30 分) です。

test-idle パラメーターは、アイドル接続のエビクションの実行時に TCP パケットをサーバーに送信してアイドル状態の接続を検証するかどうかを示します。検証に失敗する接続はプールからドロップします。この設定は timeBetweenEvictionRunsMillis > 0 でない限り影響を与えません。このパラメーターのデフォルト設定は true です。

relative-to パラメーターは、キャッシュ状態を格納するためのベースディレクトリーを指定します。

path パラメーターはキャッシュ状態を格納するための relative-to パラメーター内の位置を指定します。

shared パラメーターは、キャッシュストアを共有するかどうかを指定します。LevelDB キャッシュストアのこのパラメーターについてサポートされる唯一の値は false です。

preload パラメーターは、キャッシュストアをプリロードするかどうかを指定します。有効な値は true と false です。

block-size パラメーターはキャッシュストアのブロックサイズを定義します。

singleton パラメーターは、SingletonStore の委譲するキャッシュストアを有効にします。これは、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用されます。デフォルト値は false です。

cache-size パラメーターはキャッシュストアのキャッシュサイズを定義します。

clear-threshold パラメーターはキャッシュストアのキャッシュクリアのしきい値を定義します。

persistence-unit 属性は、JPA キャッシュストアの名前を指定します。

entity-class 属性は、キャッシュエントリー値を格納するために使用する JPA エントリーの完全修飾クラス名を指定します。

batch-size (オプション) 属性は、キャッシュストアストリーミングのバッチサイズを指定します。この属性のデフォルト値は 100 です。

store-metadata (オプション) 属性は、キャッシュストアがメタデータ (失効やバージョンに関する情報など) を保持するかどうかを指定します。この属性のデフォルト値は true です。

singleton パラメーターは、SingletonStore の委譲するキャッシュストアを有効にします。これは、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用されます。デフォルト値は false です。

fetch-state パラメーターは、クラスターへ参加する時に永続状態が取り込まれるかを決定します。クラスター環境でレプリケーションとインバリデーションを使用している場合は、これを true に設定します。さらに、複数のキャッシュストアがチェーン化されている場合、1 つのキャッシュストアのみがこのプロパティーを有効に設定できます。共有キャッシュストアが使用されている場合、キャッシュは、このプロパティーが true に設定されているにも関わらず、永続状態の転送を許可しません。fetch-state パラメーターはデフォルトでは false に設定されます。

singleton パラメーターは、SingletonStore の委譲するキャッシュストアを有効にします。これは、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用されます。デフォルト値は false です。

purge パラメーターは、初回の起動時にキャッシュストアをパージするかどうかを指定します。

key-to-string-mapper パラメーターは、キーをデータベーステーブルの文字列にマップするために使用されるクラス名を指定します。

connection-url パラメーターは、JDBC ドライバー固有の接続 URL を指定します。

username パラメーターには、connection-url で接続するために使用されるユーザー名が含まれます。

password には、connection-url で接続する際に使用するパスワードが含まれます。

driver パラメーターは、データベースに接続するために使用されるドライバーのクラス名を指定します。

prefix 属性は、キャッシュバケットテーブルの名前を作成する際に、ターゲットキャッシュの名前に付与される文字列を定義します。

drop-on-exit パラメーターは、シャットダウン時にデータベーステーブルがドロップされるかどうかを指定します。

create-on-start パラメーターは、スタートアップ時にストアによってデータベーステーブルが作成されるかどうかを指定します。

fetch-size パラメーターは、このテーブルからクエリーを実行する際に使用するサイズを指定します。このパラメーターを使用し、クエリーのサイズが大きくなった場合のヒープメモリーの消費を防ぎます。

batch-size パラメーターは、このテーブルの変更時に使用されるバッチサイズを指定します。

name パラメーターは、使用される列の名前を指定します。

type パラメーターは、使用される列のタイプを指定します。

class パラメーターは、キャッシュストア実装のクラス名を指定します。

preload パラメーターは、起動中にエントリーをキャッシュにロードするかどうかを指定します。このパラメーターの有効な値は true と false です。

shared パラメーターは、キャッシュストアを共有するかどうかを指定します。これは、複数のキャッシュインスタンスがキャッシュストアを共有する場合に使用されます。このパラメーターに有効な値は true と false です。

name 属性は、プロパティーの名前を指定します。