集計関数 aggregation-functions

構文

パラメーター

サポートされているタイプ：

• listInteger
• listDecimal
• 小数
• 整数

シグネチャと戻り値のタイプ

avg(<listInteger>)

avg(<listDecimal>)

avg(<decimal>,<decimal>)

avg(<decimal>,<integer>)

avg(<integer>,<decimal>)

avg(<integer>,<integer>)

小数を返します。

例

avg(@event{BarBeacon.inventory},5)

avg([10,3,8])

7.0 を返します。

avg(10.2, 3)

6.6 を返します。

構文

count(<listAny>)

count(<listObject>)

パラメーター

table 0-row-3 1-row-3
パラメーター	タイプ	説明
listToProcess	listString、listBoolean、listInteger、listDecimal、listDuration、listDateTime、listDateTimeOnly、listDateOnly、listObject のいずれか	処理するリスト。 listObject の場合は、フィールド参照にする必要があります。 listObject に null オブジェクトを含めることはできません。

シグネチャと戻り値のタイプ

count(<listAny>)

整数を返します。

例

count([10,2,10,null])

3 を返します。

count(@event{my_event.productListItems})

指定されたオブジェクト配列内のオブジェクト数を返します（listObject 型）。 注：listObject に null オブジェクトを含めることはできません

構文

パラメーター

table 0-row-2 1-row-2
パラメーター	タイプ
listToProcess	listString、listBoolean、listInteger、listDecimal、listDuration、listDateTime、listDateTimeOnly、listDateOnly

シグネチャと戻り値のタイプ

countOnlyNull(<listAny>)

整数を返します。

例

countOnlyNull([10,2,10,null])

1 を返します。

構文

パラメーター

table 0-row-2 1-row-2
パラメーター	タイプ
listToProcess	listString、listBoolean、listInteger、listDecimal、listDuration、listDateTime、listDateTimeOnly、listDateOnly

シグネチャと戻り値のタイプ

countWithNull(<listAny>)

整数を返します。

例

countWithNull([10,2,10,null])

4 を返します。

構文

パラメーター

table 0-row-3 1-row-3 2-row-3
パラメーター	タイプ	説明
listToProcess	listString、listBoolean、listInteger、listDecimal、listDuration、listDateTime、listDateTimeOnly、listDateOnly、listObject のいずれか	処理するリスト。 listObject の場合は、フィールド参照にする必要があります。
keyAttributeName	文字列	このパラメーターはオプションで、listObject に対してのみ使用できます。 パラメーターを指定しないと、すべての属性の値が同じ場合、オブジェクトは重複していると見なされます。 パラメーターを指定していて、指定された属性が同じ値を持つ場合、オブジェクトは重複していると見なされます。

シグネチャと戻り値のタイプ

distinctCount(<listAny>)

整数を返します。

distinctCount(<listObject>)

distinctCount(<listObject>,<string>)

オブジェクトのリストを返します。

例

distinctCount([10,2,10,null])

2 を返します。

distinctCount(@event{my_event.productListItems})

指定されたオブジェクト配列内の厳密に異なるオブジェクトの数を返します（listObject 型）。

distinctCount(@event{my_event.productListItems}, "SKU")

個別の「SKU」属性値 {} を持つオブジェクトの数を返します。

構文

パラメーター

table 0-row-2 1-row-2
パラメーター	タイプ
listToProcess	listString、listBoolean、listInteger、listDecimal、listDuration、listDateTime、listDateTimeOnly、listDateOnly

シグネチャと戻り値のタイプ

distinctCountWithNull(<listAny>)

整数を返します。

例

distinctCountWithNull([10,2,10,null])

3 を返します。

構文

パラメーター

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• 期間
• 整数
• 小数
• 日時
• dateTimeOnly

シグネチャと戻り値のタイプ

max(<listDuration>)

期間を返します。

max(<listInteger>)

期間を返します。

max(<listDateTimeOnly>)

タイムゾーンを無視して日時を返します。

max(<listDateTime>)

日時を返します。

max(<listDateOnly>)

日付を返します。

max(<listDecimal>)

小数を返します。

max(<decimal>,<decimal>)

小数を返します。

max(<duration>,<duration>)

期間を返します。

max(<dateTime>,<dateTime>)

日時を返します。

max(<dateTimeOnly>,<dateTimeOnly>)

タイムゾーンを無視して日時を返します。

max(<integer>,<integer>)

整数を返します。

例

max(@event{BarBeacon.inventory},5)

max([10,3,8])

10 を返します。

max([10,null,8])

10 を返します。

構文

パラメーター

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• 期間
• 整数
• 小数
• 日時
• dateTimeOnly

シグネチャと戻り値のタイプ

min(<listDuration>)

期間を返します。

min(<listInteger>)

期間を返します。

min(<listDateTimeOnly>)

タイムゾーンを無視して日時を返します。

min(<listDateTime>)

日時を返します。

min(<listDateOnly>)

日付を返します。

min(<listDecimal>)

小数を返します。

min(<decimal>,<decimal>)

小数を返します。

min(<duration>,<duration>)

期間を返します。

min(<dateTime>,<dateTime>)

日時を返します。

min(<dateTimeOnly>,<dateTimeOnly>)

タイムゾーンを無視して日時を返します。

min(<integer>,<integer>)

整数を返します。

例

min(@event{BarBeacon.inventory},5)

min([10,3,8])

3 を返します。

min([10,null,8])

8 を返します。

構文

パラメーター

• listInteger
• listDecimal
• 期間
• 整数
• 小数

シグネチャと戻り値のタイプ

sum(<listDecimal>)

小数を返します。

sum(<listInteger>)

整数を返します。

sum(<integer>,<integer>)

整数を返します。

sum(<decimal>,<decimal>)

小数を返します。

例

sum(@event{BarBeacon.inventory},5)

sum([10,3,8])

21 を返します。

sum([10.5,null,8.1])

18.6 を返します。

AI ナレッジリファレンス

このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。

理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。

• TL;DR:​このページでは、AJO ジャーニー式で使用できるすべての集計関数について説明します。リストと配列の平均値、合計、最小値/最大値、カウント、および異なるカウントを計算する方法について説明します。

インテント：

• avgを使用して数値のリストの平均を計算します
• リスト内またはsumを使用したイベントフィールドからの数値の合計
• minまたはmaxを使用して、リスト内の最小値または最大値を検索します
• count、countOnlyNullまたはcountWithNullを使用して、null以外、nullのみ、またはリスト内のすべての要素をカウントします
• distinctCountまたはdistinctCountWithNullを使用して、ヌルの有無にかかわらず、リスト内の個別の値をカウントします
• キーパラメーターでdistinctCountを使用して、listObject内の一意のオブジェクトを特定のキー属性でフィルタリングします

用語集：

• listObject：複雑なオブジェクト （フィールド参照）のリスト。null オブジェクト （製品固有）​を含めることはできません
• listAny：サポートされているスカラー型（文字列、ブール値、整数、10進数、デュレーション、dateTime、dateTimeOnly、dateOnly） （製品固有）
• Null値: リスト内の要素が存在しないか、定義されていない要素。ほとんどの集計関数は、関数が明示的に処理しない限り、Nullを無視します（例：countOnlyNull、countWithNull、distinctCountWithNull）。

ガードレール：

• countOnlyNull、countWithNullおよびdistinctCountWithNullは、<listObject> パラメーター型をサポートしていません
• listObjectのdistinctCountでは、リストをインラインリテラルではなくフィールド参照にする必要があります
• listObjectのcountでは、リストをフィールド参照にする必要があります。listObjectにnull オブジェクトを含めることはできません

用語：

• 正規名：集計関数 – Acronym: none — バリアント：集計関数、コレクション関数
• 同義語：“count” = “count non-null要素をカウント”; “countWithNull” = “count all elements including nulls”
• 混同しないでください：“distinctCount” （nullを無視） ≠ “distinctCountWithNull” （nullを一意の値として含む）

FAQ:

• Q: avgの計算にnull値が含まれていますか？ – いいえ、avgはnull値を自動的に無視します。
• Q: countとcountWithNullの違いは何ですか？ — countは合計からnull値を除外し、countWithNullはnullを含むすべての要素をカウントします。
• Q: listObjectでcountOnlyNullを使用できますか？ – いいえ、<listObject>はcountOnlyNull、countWithNull、またはdistinctCountWithNullではサポートされていません。
• Q：特定の属性に基づいて配列内の個別のオブジェクトをカウントするにはどうすればよいですか？ — キー属性名を2番目のパラメーターとして指定するdistinctCount(@event{...}, "attributeName")を使用します。
• Q: リストにnullが含まれている場合、maxは何を返しますか？ — maxはnull値を無視し、null以外の要素の最大値を返します。