batch

eclipselink.batchを使用してTopLinkにバッチ処理情報を提供すると、関連するオブジェクトに対する後続の問合せがバッチ内で最適化されるため、オブジェクトを1つずつ取得したり、大規模な1つの結合読取りで取得することを回避できます。

値

この問合せヒントでは、単一値のリレーションシップ・パス式を使用できます。

使用方法

eclipselink.batchヒントを使用すると、TopLinkで重複データの読取りが回避されるため、結合よりも効率的です。

SELECT句にオブジェクトが1つしかない問合せについてのみ、バッチ処理を実行できます

有効値は、単一値のリレーションシップ・パス式です。

注意:

ネストされた属性にアクセスするには、ドット表記法を使用します。たとえば、従業員のマネージャのアドレスについてバッチ読取りを実行するには、e.manager.addressを使用します。

例

例4-1に、JPA問合せでこのヒントを使用する方法を示します。

例4-1 JPA問合せでのbatchの使用

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 query.setHint("eclipselink.batch", "e.address");

例4-2に、@QueryHint注釈でこのヒントを使用する方法を示します。

例4-2 @QueryHint注釈でのbatchの使用

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 @QueryHint(name=QueryHints.BATCH, value="e.address");