MAQL式のリファレンス

MAQL 式のリファレンスガイドには、カスタムメトリックエディターの集約、数値、細分性、論理、およびフィルタータブで使用可能な MAQL 関数、演算子およびキーワードの総合リストがあります。

集約

総計機能はシンプルな数学関数で、ファクトに対してメトリックを作成する際に実行されます。 メトリックの例は、個々の売上高を合計して売上高の合計金額を返します。個々の売上高はファクトとして保存されます。

関数説明
AVGセット内のすべての数値の平均値（支払い給与など）を返します。 NULL 値は無視されます。 AVGを参照してください。
RUNAVGファクトまたはメトリックのすべての値の累計平均。 コア関数の累計を参照してください。
CORREL-1 と 1 の間の相関係数を返します。 相関関係は 2 組の値の関連の度合いを示します。 CORRELを参照してください。
COUNTある状況下での属性の固有値を返します。 COUNTを参照してください。
COVAR/COVARP母集団（COVAR）または偏りのある母集団（COVARP）のサンプルに基づき、2 組の値が共にどのように変化するかを示す、統計的分散を返します。 共分散関数を参照してください。
予測既存のデータに基づく最大 10 の将来の期間に対する線形回帰推定値を返します。 2 番目のパラメータは期間数です。既定値は 3 です。 予測 - トレンドラインをレポートに追加するを参照してください。
MAXセット内のすべての数値の最高値を返します（支払い給与など）。
RUNMAXファクトまたはメトリックのすべての値の累計最大値。 コア関数の累計を参照してください。
MEDIANサンプルの中央値を出すための順序統計量である、統計の [中央] 値を計算します。 [中央] 値が 2 つの値の間にある場合、この関数は 2 つの中間値の平均値を返します。 NULL 値は無視されます。 中央値を参照してください。
MINセット内のすべての数値の最小値を返します（支払い給与など）。 MINを参照してください。
RUNMINファクトまたはメトリックのすべての値の累計最小値。 コア関数の累計を参照してください。
PERCENTILE範囲内の値の k 番目のパーセントを返します - k は 10 進数またはパーセントにより、2 番目のパラメータで指定されます。 PERCENTILEを参照してください。
RSQ相関係数の 2 乗を返します。 最小二乗関数を参照してください。
STDEV母集団（STDEV）または偏りのある母集団（STDEVP）のサンプルに基づく、セットにおけるすべての値の統計的な標準偏差を返します。 標準偏差関数を参照してください。
RUNSTDEVファクトまたはメトリック値の集合間の累計標準偏差。 累計統計関数を参照してください。
SUMセット内のすべての数値の合計を返します（支払い給与など）。 SUMを参照してください。
RUNSUMファクトまたはメトリックのすべての値の累計合計。 コア関数の累計を参照してください。
VAR/VARP母集団（VAR）または偏りのある母集団（VARP）のサンプルに基づき、値のセットの分散の程度を示す、統計的分散を返します。 分散は負ではありません。ゼロはすべての値が同じであることを示します。 分散関数を参照してください。
RUNVAR2 組の値の累計分散。 累計統計関数を参照してください。

数値

数値関数は、ファクトまたはメトリックに関する数学演算を実行します。 これらの関数は単純な算数演算子（ 算術演算またはさらに洗練された計算）です。

関数説明
+, -, *, /単純な計算式を計算します。 ゼロで割ると NULL 値が返されます。 算術演算を参照してください。
ABS数値の絶対値を返します（収益など）。 ABSを参照してください。
EXP数値を累乗した e を返します（年次率など）。 EXPを参照してください。
IFNULLNULL 値の代わりに、IFNULL 関数の 2 番目のパラメータで指定された置換値を返します。 式で使用される場合、外部結合がデータレベルで適用されます。 IFNULLを参照してください。
LOG

LOG は LOG 関数の 2 番目のパラメータで指定された所定のベース用の数字の対数を返します。 ベース値が省略された場合、ベース 10 が使用されます。 LOGを参照してください。

LNLN は、数字の自然対数を返します。 数が 0 以下の場合は両方の関数が NULL を返します。 LNを参照してください。
POWERべき関数の 2 番目のパラメータとして指定されたベースに上げられた数字を返します（金利、収益など）。 複素数と未定義の結果は NULL に置き換えられます。 POWERを参照してください。
RANKメトリック値について昇順で番付を返します (最小 値を降順または昇順で返します。(最大値が最上位)。 ランクを参照してください。  注意： その他の参照 WITHIN 句。

ROUND

2 番目のパラメーターで指定された小数点以下の桁数にファクトまたはメトリックを丸めます。 ROUNDを参照してください。

FLOOR

入力値をそれよりも小さい最も近い整数に丸めます。 FLOORを参照してください。

CEILING

入力値をそれよりも大きい最も近い整数に丸めます。 CEILINGを参照してください。

TRUNC

2 番目のパラメーターで指定された小数点以下の桁数に基づいて、数値を切り捨てます。 TRUNCを参照してください。
SIGN数値が負の場合は -1 を、数値がゼロの場合は 0 を、数が正の場合は 1 を返します。 SIGNを参照してください。
SQRT数値（収益など）の平方根を返し、負の場合には NULL を返します。 SQRTを参照してください。

*1 つまたは 2 つのパラメータを受け入れる、丸めおよび切り捨て関数で、2 つ目のパラメータは小数点以下の桁数（負であることが可能）。省略されると、数値は最も近い整数に切り捨て/四捨五入されます。 丸め関数における NULL 値はいずれも NULL を返します。

細分性キーワード

以下の細分性キーワードは MAQL 式に対する集約レベルを設定するために使用できます。 メトリックに複数のキーワードが含まれている場合は、アルファベット順にリスト表示する必要があります。

キーワード説明
BYこれは、「別」ステートメントの後の属性により指定された集約レベルでのメトリック値をロックします。 異なるディメンションからのカンマで区切られた複数の属性を指定できます。 BYを参照してください。
BY ALL 属性四半期や年だけでなく、常時の解決時間のパーセントを示すように作成すると仮定します。 日付ディメンションの最上位レベルの属性が年であるため、「BY ALL Year」のコンストラクトが新たに必要です。 BY ALLを参照してください。
BY ALL IN ALL OTHER DIMENSIONSこれは、すべてのディメンションで最高の集約レベルでのメトリックの値をロックします。したがって、これは不可分の総計を返します。 BY ALL IN ALL OTHER DIMENSIONS.
属性別, ALL IN ALL OTHER DIMENSIONSこれは、以前「別」ステートメントで指定されていない他のすべてのディメンションで、メトリックの集約を計算する方法を指定することにより、「別」ステートメントを補完します。 ALL IN ALL OTHER DIMENSIONS を省略すると、メトリックを他のディメンションに特定細分化できるようになります。 BY 属性 ALL IN ALL OTHER DIMENSIONSを参照してください。
FOR Next既定では、両方の関数が 1 期間 後の値を参照します。 これは、関数に 2 番目のパラメーターを追加してカスタマイズできます。 FOR Nextを参照してください。
FOR Previous既定では、両方の関数が 1 期間前からの値を参照します。 これは、関数に 2 番目のパラメータを追加してカスタマイズできます。 FOR Previousを参照してください。
FOR NextPeriod適応可能な関数が手動によりレポートの文脈に適応しない限り、「FOR Next」関数と同様に機能します。 たとえばメトリックが「FOR NextPeriod(Quarter)」として定義されていても、このレポートでは月が最も細分化された日付の属性であるため、関数は次の月からの値を返します。 FOR NextPeriodを参照してください。
FOR PreviousPeriod適応可能な関数が手動によりレポートの文脈に適応しない限り、「FOR Next」と「FOR Previous」関数と同様に機能します。 たとえばメトリックが「FOR PreviousPeriod(Quarter)」として定義されていても、このレポートでは月が最も細分化された日付の属性であるため、関数は前の月からの値を返します。 FOR PreviousPeriodを参照してください。
BY ALL IN ALL OTHER DIMENSIONS EXCEPT (FOR)BY ALL 句に EXCEPT FOR アトリビュートを追加すると、アトリビュートがレポートに含まれている場合、メトリックがアトリビュート（およびその階層）により特定細分化される例外が指定されます。 BY ALL IN ALL OTHER DIMENSIONS EXCEPT FOR 属性を参照してください。
WITHINレポート作成ページの HOW 部分で指定されたレポートのディメンション性を尊重する、または無視する、いわゆるサブグループと呼ばれるものを作成します。 WITHIN 句を参照してください。
ROWS BETWEENこれは、累計関数（RUNAVG など）が計算されるローリング ウィンドウを指定します。 ローリング ウィンドウを参照してください。
OVER...TOOVER...TO 構文は、論理データモデルのデータ権限数と複雑性を減少させることができます。 高度なデータのアクセス権限のユースケースを参照してください。

論理演算子

以下の論理演算子はフィルターを結合し、MAQL 式に条件を適用するために使用することができます。

演算子説明
AND両方の式が真（FALSE や NULL でない）の場合、結果は真になります。 他のすべての場合において、結果は偽 です。AND を使用してフィルターを組み合わせると、メトリックを計算する際に両方のフィルターが適用されます。 ANDを参照してください。
CASECASE は条件ステートメントで、論理試験を複数条件で実行し、条件に適応する値を返します。 CASEを参照してください。
IF/THEN/ELSEステートメントは満たされた条件により、2 つの値の内のどちらかを返すか、2 つの計算のどちらかを実行します ステートメントはメトリックの内部で使用されるため、ステートメントの THEN 部分の数値だけを使用します。 IF THEN ELSEを参照してください。
NOTフィルターを指定して、その前に「NOT」を付けると、フィルターにより指定されているものがすべて計算から除外されます。 NOTを参照してください。
ORいずれかの計算式が真の場合、結果も真です。 両方の式が負（FALSE や NULL でない）の場合、結果は負になります。 「OR」を使ってフィルターを組み合わせる場合、結果は各フィルターごとに個別に計算され、結果が結合されます。 ORを参照してください。

フィルター式

フィルターを使用すると、含めるか除外したい属性値を対象にすることで、メトリックが計算されるデータセットを絞り込むことができます。

たとえば、特定の地域からの売上を示すメトリックなどです。

演算子説明
=（等しい）、<>（等しくない）、>（超える）、<（未満）、>=（以上）、<=（以下）等号演算子、非等値演算子、および他の比較演算子。
BETWEEN属性値、メトリックまたはマクロを用いて、指定された範囲（エンドポイントを含む／含まない）でメトリックを計算します。 BETWEENを参照してください。
NOT BETWEEN属性値、メトリックまたはマクロを用いて、指定された範囲外（エンドポイントを含む／含まない）でメトリックを計算します。 NOT BETWEENを参照してください。
IN複数の属性値を用いてメトリックを計算します。 INを参照してください。
NOT INリストに表示された属性値を除いて、指定された属性でメトリックを計算します。 NOT INを参照してください。
TOP (%)メトリックとして定義された、指定された条件に合うメンバーを返します。 出力設定に一致するメンバーの数は、数値またはパーセンテージで指定することができます。 メトリック値に基づく。 TOP（3）の条件は、その条件に合うすべてのメンバーを返し、これは 3 行以上になる可能性があります TOP ランクと BOTTOM ランクの拡張を参照してください。
BOTTOM (%)

メトリックとして定義された、指定された条件に合うメンバーを返します。 出力設定に一致するメンバーの数は、数値またはパーセンテージで指定することができます。 メトリック値に基づく。 BOTTOM (3) の条件は、その条件に合うすべてのメンバーを帰し、これは 3 行以上になる可能性があります。 TOP ランクと BOTTOM ランクの拡張を参照してください。

WITH PARENT FILTERメトリック（メトリック、レポート、またはダッシュボード）より上のすべてのレベルでフィルターを適用して、メトリックを計算します。 これがデフォルトの挙動です。 PARENTフィルターを参照してください。
WITH PARENT FILTER EXCEPT属性のカンマ区切りリストとして指定された任意のフィルタを除く、すべての親のフィルターが含まれます。 除外属性フィルターは、指定された属性と階層内で高い階層にあるすべての属性に適用されます。 PARENTフィルターを参照してください。
WITHOUT PARENT FILTERメトリックを指定したいずれのフィルターにも無関係にメトリックを計算します。 ご注意： この句では、すべての年の数量（合計など）を計算できます。これは、一部の年が親のメトリック、レポート、またはダッシュボードで除外されている場合にも該当します。 PARENTフィルターを参照してください。
WITHOUT PARENT FILTER EXCEPT属性のカンマ区切りリストとして指定された任意のフィルターを除く、親のフィルターが削除されます。 除外属性フィルターは、指定された属性と階層内で高い階層にあるすべての属性に適用されます。 PARENTフィルターを参照してください。
THISTHIS マクロは、日付ディメンションの指定された属性の現在の値を参照します。 THIS マクロを参照してください。
PREVIOUSPREVIOUS マクロは、現在の値に直前にある日付ディメンションの属性値を選択するために使用されます。 PREVIOUS マクロを参照してください。
NEXTNEXT マクロは、現在の値の直後にある日付ディメンションの属性値を選択するために使用されます。 NEXT マクロを参照してください。
LIKE, NOT LIKE, ILIKE, NOT ILIKEこの条件は特定のパターンに一致する属性ラベルストリング値をフィルタリングします。 このパターンは一つまたはそれ以上のワイルドカード文字を含む可能性があります。 ILIKE は LIKE に相当しますが、一致度は大文字と小文字を区別しません。 パターン内の下線（_）は任意の単一文字にに一致します；パーセント記号（%）は任意の文字に一致します。 パターンは二重引用符（""）内に入っていなければいけません。 LIKE 句を使用してフィルタリングする を参照してください
集約関数