「詳細な問合せオプション」ダイアログ・ボックス

次の表を参照して各フィールドにデータを入力し、「OK」をクリックします。

フィールド | 説明
--- | ---
キャッシュの維持 | 問合せのキャッシュを使用するか、またはデータベースの結果からオブジェクトを直接作成するかを選択します。このオプションは、部分オブジェクト問合せ（「部分オブジェクト問合せ」を参照）を実行する場合にのみ使用します。部分オブジェクト問合せの結果はキャッシュできません。 詳細は、「読取り問合せ中のアイデンティティ・マップのキャッシュ更新の無効化」を参照してください。
ラッパー・ポリシーの使用 | このディスクリプタに対して構成したラッパー・ポリシーを名前付き問合せで使用するかどうかを指定します。 詳細は、「ラッパー・ポリシーの構成」を参照してください。

SQL文を一度だけ作成

名前付き問合せの`setShouldPrepare()`を指定します。デフォルトでは、SQLを一度のみ生成するように問合せが最適化されます。次のように、引数に基づく動的SQLを必要とする特定のタイプの問合せの場合は、このオプションを無効にする必要があります。

- `equal`を使用する式。この式では引数の値が`null`になる可能性があります。このため、`= NULL`ではなく`IS NULL`を必要とするデータベースで問題が発生する場合があります。

- `in`およびパラメータ・バインディングを使用する式。`in`値は個別にバインドする必要があるため、問題が発生します。

問合せ結果のキャッシュ | 問合せの `cacheQueryResults`メソッドを指定します。問合せは、最初に実行した場合のみデータベースにアクセスします。その後実行した場合、元の結果がそのまま返されます。 詳細は、「ReadQueryのキャッシュ結果」を参照してください。
リモート・アイデンティティ・マップの問合せ結果のリフレッシュ | 問合せの`refreshRemoteIdentityMapResult`メソッドを指定します。TopLinkでは、問合せの結果オブジェクトの属性をリフレッシュできます。カスケードを使用する場合、オブジェクトのプライベート部分もリフレッシュされます。
排他接続 | 名前付き問合せで排他接続を使用するかどうかを指定します。セッション・レベルで排他接続の取得を構成することもできます（「接続ポリシーの構成」を参照）。
ペシミスティック・ロック | 問合せに対する特定のペシミスティック・ロック・ポリシーを指定するか、ディスクリプタのロック・ポリシーを使用します。
DISTINCT句 | distinctが設定されている場合、`DISTINCT`句が出力されるかどうかを指定します。
問合せタイムアウト | 指定した秒数の経過後、問合せをタイムアウト（強制終了）にするかどうかを指定します。
最大行 | 問合せで結果を指定の行数に制限するかどうかを指定します。問合せが非常に多くのオブジェクトを返す可能性がある場合に、このオプションを使用します。

関連項目

  ディスクリプタ・レベルでの名前付き問合せの構成