第1章 Data Grid キャッシュのインデックス作成

Data Grid 設定は、インデックスの保存および構築方法を制御します。

インデックスストレージ

Data Grid がインデックスを保存する方法を設定できます。

<distributed-cache>
  <indexing storage="filesystem" path="${java.io.tmpdir}/baseDir">
    <!-- Indexing configuration goes here. -->
  </indexing>
</distributed-cache>

<distributed-cache>
  <indexing storage="local-heap">
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

インデックスパス

ストレージが 'filesystem' の場合、インデックスのファイルシステムパスを指定します。値は相対パスまたは絶対パスになります。相対パスは、設定済みの永続的なグローバルのロケーションを起点に作成されます。または、グローバルの状態が無効の場合は現在の作業ディレクトリーを起点に作成されます。

デフォルトでは、キャッシュ名はインデックスパスの相対パスとして使用されます。

インデックス起動モード

Data Grid がキャッシュを開始すると、操作を実行して、インデックスがキャッシュ内のデータと一致していることを確認できます。デフォルトでは、キャッシュの開始時にインデックス作成操作は行われませんが、Data Grid を次のように設定できます。

<distributed-cache>
  <indexing storage="filesystem" startup-mode="purge">
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

<distributed-cache>
  <indexing storage="local-heap" startup-mode="reindex">
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

インデックス化モード

indexing-mode は、キャッシュ操作がインデックスに伝播される方法を制御します。

indexing-mode を manual に設定します。

<distributed-cache>
  <indexing indexing-mode="manual">
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

インデックスリーダー

インデックスリーダーは、クエリーを実行するためにインデックスへのアクセスを提供する内部コンポーネントです。インデックスのコンテンツが変更されると、Data Grid はリーダーを更新し、検索結果が最新の状態になるようにする必要があります。インデックスリーダーの更新間隔を設定できます。デフォルトでは、インデックスが最終更新以降に変更された場合、各クエリーの前に Data Grid はインデックスを読み取ります。

<distributed-cache>
  <indexing storage="filesystem" path="${java.io.tmpdir}/baseDir">
    <!-- Sets an interval of one second for the index reader. -->
    <index-reader refresh-interval="1000"/>
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

インデックスライター

インデックスライターは、パフォーマンスを改善するために時間の経過とともにマージできる 1 つ以上のセグメント (サブインデックス) で構成されるインデックスを構築する内部コンポーネントです。インデックスリーダーの操作では、すべてのセグメントを考慮する必要があるため、通常、セグメントが少ないということは、クエリー中のオーバーヘッドが少ないことを意味します。

Data Grid は Apache Lucene を内部的に使用し、メモリーとストレージという 2 つの層でエントリーにインデックスを付けます。新規エントリーは、最初にメモリーインデックスに移動してから、フラッシュが実行されると、設定されたインデックスストレージに移動します。定期的なコミット操作は、フラッシュしたデータからセグメントを作成し、すべてのインデックス変更を永続化します。

<distributed-cache>
  <indexing storage="filesystem" path="${java.io.tmpdir}/baseDir">
    <index-writer commit-interval="2000"
                  low-level-trace="false"
                  max-buffered-entries="32"
                  queue-count="1"
                  queue-size="10000"
                  ram-buffer-size="400"
                  thread-pool-size="2">
      <index-merge calibrate-by-deletes="true"
                   factor="3"
                   max-entries="2000"
                   min-size="10"
                   max-size="20"/>
    </index-writer>
    <!-- Additional indexing configuration goes here. -->
  </indexing>
</distributed-cache>

Data Grid がインデックスセグメントをマージする方法を設定するには、index-merge サブ要素を使用します。

インデックスシャーディング

大量のデータがある場合は、Data Grid を設定して、インデックスデータをシャードと呼ばれる複数のインデックスに分割できます。シャード間でのデータ分散を有効にすると、パフォーマンスが向上します。デフォルトでは、シャーディングは無効になっています。

インデックスの数を設定するには、shards 属性を使用します。シャードの数は 1 より大きくなければなりません。

<distributed-cache>
  <indexing>
    <index-sharding shards="6" />
  </indexing>
</distributed-cache>