SOQL クエリおよび SOSL クエリでの Apex 変数の使用

Apex の SOQL ステートメントと SOSL ステートメントは、前にコロン (:) がある場��、Apex コード変数と式を参照できます。このように SOQL ステートメントまたは SOSL ステートメント内でローカルコード変数を使用することを、バインドと呼びます。Apex パーサーは、SOQL ステートメントまたは SOSL ステートメントを実行する前に、最初にコードコンテキスト内のローカル変数を評価します。バインド式は、次のように使用できます。

• FIND 句の検索文字列
• WHERE 句の条件リテラル
• WHERE 句の IN 演算子または NOT IN 演算子の値。値の動的セットを絞り込むことができます。いずれのデータ型のリストでも機能しますが、特に ID または String のリストで使用されます。
• WITH DIVISION 句のディビジョン名
• LIMIT 句の数値
• OFFSET 句の数値

バインド式は INCLUDES などの他の句と共に使用することはできません。

次に例を示します。