GROUP BY

API バージョン 18.0 以降では、コード内で個々のレコードを処理せずに、データを集計してクエリ結果をロールアップするために、SUM() や MAX() などの集計関数と GROUP BY を共に使用できます。構文は次のとおりです。

fieldGroupByList では、グループ化する項目のカンマ区切りのリストを指定します。SELECT 句の項目リストに集計関数が含まれている場合は、GROUP BY 句に集計関数以外のすべての項目を含める必要があります。

たとえば、GROUP BY を使用せずに、各 LeadSource 値に関連付けられているリードの数を調べるには、次のクエリを実行できます。

次に、クエリ結果を反復するコードを記述し、各 LeadSource 値のカウンタを増分します。GROUP BY を使用すると、追加のコードを記述せずに同じ結果を取得できます。次に例を示します。

SOQL でサポートされる集計関数の一覧は、「集計関数」を参照してください。

オブジェクトのすべての個別値 (null を含む) をクエリするには、集計関数を使用せずに GROUP BY 句を使用できます。次のクエリは、LeadSource 項目に保存されている個別の値セットを返します。

COUNT_DISTINCT() 関数はクエリ条件に一致する、null 以外の個別の項目値の数を返します。