SOQL および SOSL リファレンス
jCOUNT() および COUNT(fieldName)
クエリが返す行数を取得するには、集計関数 COUNT() を SOQL クエリの SELECT ステートメントで使用します。
COUNT()
COUNT() は絞り込み条件に一致する行数を返します。
次に例を示します。
COUNT() の場合、QueryResult オブジェクトの size 項目は、クエリで取得された行数を返します。records 項目は null を返します。
COUNT() を使用するときは、次の点に注意してください。
- COUNT() は SELECT リストの唯一の要素であることが必要です。
- COUNT() が返す行数には、クエリの絞り込み条件に一致する null 値が含まれます。
- COUNT() と LIMIT 句を一緒に使用できます。
- COUNT() と ORDER BY 句は一緒に使用できません。
COUNT(fieldName)
COUNT(fieldName) は絞り込み条件に一致し、fieldName の値が null 以外の行数を返します。
次に例を示します。
COUNT(fieldName) の場合、records 項目の オブジェクトが行数を返します。size 項目にはこの数が反映されません。次に例を示します。
この数は、集計項目の暗黙的別名の expr0 で返されます。
SELECT 句には複数の COUNT(fieldName) 項目を含めることができます。たとえば次のクエリは、商談の数およびキャンペーンに関連付けられている商談の数を返します。
GROUP BY 句と COUNT(fieldName) を一緒に使用して、レコードを分析し、サマリーレポート情報を返すことができます。たとえば、次のクエリは各 LeadSource の値のリード数を返します。