関数

式で使用できる関数には様々なタイプがあります。

トピック:

集計関数

集計関数は、複数の値に対して演算を実行し、サマリー結果を作成します。

次のリストに、列およびメジャー列で使用できる集計ルールを示します。リストには、分析の計算項目の作成時に使用できる関数も含まれています。

デフォルト - Oracle BI Repositoryと同様に、もしくは分析の最初の作成者によって、デフォルトの集計ルールが適用されます。分析の計算項目には使用できません。
サーバーの設定を適用 - Oracle BIサーバーによって決定された集計ルール(Oracle BI Repositoryで定義されたルールなど)が適用されます。集計は、合計、最低および最大などの単純なルールの場合は、Oracle BIサーバー内で実行されます。「レイアウト」ペインのメジャー列または分析の計算項目には使用できません。
SUM - 結果セットに含まれるすべての値を加算して取得した合計が計算されます。数値を含む項目に使用します。
MIN - 結果セットに含まれる行の最小値(最も低い数値)が計算されます。数値を含む項目に使用します。
MAX - 結果セットに含まれる行の最大値(最も高い数値)が計算されます。数値を含む項目に使用します。
AVG - 結果セットに含まれる項目の平均値が計算されます。数値を含む項目に使用します。表およびピボット表の平均が、近似の整数値に丸められます。
FIRST - メジャーに関して、結果セットに含まれるその項目のうち、最初に出現するものが選択されます。計算項目の場合は、「選択済」リストの表示に準じて最初のメンバーが選択されます。「列式の編集」ダイアログでは使用できません。
LAST - 結果セットに含まれるその項目のうち、最後に出現するものが選択されます。計算項目の場合は、「選択済」リストの表示に準じて最後のメンバーが選択されます。「列式の編集」ダイアログでは使用できません。
COUNT - その項目に関して、結果セットに含まれるnullでない値を持つ行の数が計算されます。通常、項目は列名であり、その場合はその列に対してnull以外の値を持つ行の数が返されます。
COUNT DISTINCT - COUNT関数に個別処理を追加します。つまり、項目の個別の出現は、1回のみカウントされます。
なし - 集計は適用されません。分析の計算項目には使用できません。
サーバー複合集計 - Oracle BIサーバーによって決定された集計ルール(Oracle BI Repositoryで定義されたルールなど)が適用されます。集計は、プレゼンテーション・サービス内ではなく、Oracle BIサーバーによって実行されます。分析の計算項目には使用できません。
レポートを基準にした合計(適用可能な場合) - 選択を解除すると、メジャーにフィルタが適用される前に、結果セット全体に基づいて、Oracle BIサーバーによって合計が計算されます。「列式の編集」ダイアログや分析の計算項目には使用できません。属性列のみに使用できます。

関数	例	説明	構文
AGGREGATE AT	`AGGREGATE(sales AT month, region)`	指定するレベルに基づいて列を集計します。 measureはメジャー列の名前で、levelは集計するレベルです。オプションで、複数のレベルを指定できます。1番目の引数で指定したメジャーのメジャー・レベルとして使用されるレベルを含むディメンションのレベルを指定できません。たとえば、monthはyearly_salesのメジャー・レベルとして使用される同じ時間ディメンションからのものであるため、この関数でAGGREGATE(yearly_sales AT month)と指定することはできません。	`AGGREGATE(measure AT level [, level1, levelN])`
AVG	`Avg(Sales)`	数値の平均を計算します。	`AVG(expr)`
AVGDISTINCT		式のすべての個別値の平均を計算します。	`AVG(DISTINCT expr)`
BIN	`BIN(revenue BY productid, year WHERE productid > 2 INTO 4 BINS RETURNING RANGE_LOW)`	指定された数値式を、指定された数の等幅バケットに分類します。この関数は、ビン番号、またはビン間隔の2つのエンドポイントのいずれかを返すことができます。numeric_exprはビンに対するメジャーまたは数値属性です。BY grain_expr1,…, grain_exprNは、numeric_exprが計算されるグレインを定義する式のリストです。BYは、メジャー式の場合は必須で、属性式の場合はオプションです。WHEREは、数値がビンに割り当てられる前にnumeric_exprに適用されるフィルタです。INTO number_of_bins BINSは、返すビンの数です。BETWEEN min_value AND max_valueは、最も外側のビンのエンドポイントに使用する最小値と最大値です。RETURNING NUMBERは、戻り値をビン番号(1、2、3、4など)にすることを示しています。これはデフォルトです。RETURNING RANGE_LOWは、ビン間隔の下限値を示します。RETURNING RANGE_HIGHは、ビン間隔の上限値を示します。	`BIN(numeric_expr [BY grain_expr1, ..., grain_exprN] [WHERE condition] INTO number_of_bins BINS [BETWEEN min_value AND max_value] [RETURNING {NUMBER \| RANGE_LOW \| RANGE_HIGH}])`
BottomN		式引数の最下位のnの値を1からn番目までランク付けします。1が最下位の数値です。 exprは、数値に評価される任意の式です。integerは、任意の正の整数です。結果セットに表示されるランキングの最下位数を表し、1が最低ランクです。	`BottomN(expr, integer)`
COUNT	`COUNT(Products)`	非NULL値を含むアイテムの数を特定します。	`COUNT(expr)`
COUNTDISTINCT		個別の処理をCOUNT関数に追加します。 exprは任意の式です。	`COUNT(DISTINCT expr)`
COUNT*	`SELECT COUNT(*) FROM Facts`	行の数をカウントします。	`COUNT(*)`
最初	`First(Sales)`	式引数のnull以外の最初の戻り値を選択します。`First`関数は、明示的に定義されたディメンションで指定される最も詳細なレベルで動作します。	`First([NumericExpression)]`
最後	`Last(Sales)`	式の最後の非NULLの戻り値を選択します。	`Last([NumericExpression)]`
MAVG		現在の行を含めて、結果セットのデータの最後のn行の移動平均を計算します。 exprは、数値に評価される任意の式です。integerは、任意の正の整数です。最後のn行のデータ平均を表します。	`MAVG(expr, integer)`
MAX	`MAX(Revenue)`	数値式の引数を満たす行の最大値(最も高い数値)を計算します。	`MAX(expr)`
MEDIAN	`MEDIAN(Sales)`	数値式の引数を満たす行の中央(中間)値を計算します。偶数の行がある場合、中央値は2つの中間行の平均です。この関数は常にdoubleを返します。	`MEDIAN(expr)`
MIN	`MIN(Revenue)`	数値式の引数を満たす行の最小値(最も低い数値)を計算します。	`MIN(expr)`
NTILE		ユーザーの指定範囲における値のランクを決定します。範囲のランクを示す整数を返します。numTiles=100を指定したNTILEは、一般に「パーセンタイル」(1から100までの範囲の数値で、100がこの分割の最高値)と呼ばれる値を返します。 exprは、数値に評価される任意の式です。numTilesは、タイルの数を表す、nullではない正の整数です。	`NTILE(expr, numTiles)`
PERCENTILE		数式の引数を満たす各値のパーセンタイル・ランクを計算します。パーセンタイル・ランクの範囲は、0 (0番目のパーセンタイル)から1 (100番目のパーセンタイル)です。 exprは、数値に評価される任意の式です。	`PERCENTILE(expr)`
RANK	`RANK(chronological_key, null, year_key_columns)`	数値式の引数を満たす各値のランクを計算します。最も高い数値にはランク1が割り当てられ、次に続くランクには2、3、4などの連続した整数が割り当てられます。ある値が等しい場合、同じランクが割り当てられます(たとえば、1、1、1、4、5、5、7...)。 exprは、数値に評価される任意の式です。	`RANK(expr)`
STDDEV	`STDDEV(Sales) STDDEV(DISTINCT Sales)`	値セットの標準偏差を返します。戻り型は常にdoubleです。	`STDDEV(expr)`
STDDEV_POP	`STDDEV_POP(Sales) STDDEV_POP(DISTINCT Sales)`	母分散および標準偏差の計算式を使用して、値セットの標準偏差を返します。	`STDDEV_POP([NumericExpression])`
SUM	`SUM(Revenue)`	数値式の引数を満たすすべての値を加算して得られる合計を計算します。	`SUM(expr)`
SUMDISTINCT		数式の引数を満たすすべての個別値を加算して得られる合計を計算します。 exprは、数値に評価される任意の式です。	`SUM(DISTINCT expr)`
TOPN		式引数の最上位のnの値を1からn番目までランク付けします。1が最上位の数値です。 exprは、数値に評価される任意の式です。integerは、任意の正の整数です。結果セットに表示されるランキングの最上位数を表し、1が最高ランクです。	`TOPN(expr, integer)`

分析関数

分析関数では、トレンド線やクラスタなどのモデルを使用してデータを調査できます。

関数	例	説明	構文
TRENDLINE	`TRENDLINE(revenue, (calendar_year, calendar_quarter, calendar_month) BY (product), 'LINEAR', 'VALUE')`	ビジュアライゼーションを表示する際に、「統計の追加」プロパティを使用してトレンド線を適用することをお薦めします。可視化プロパティの調整を参照してください。線形、多項式または指数モデルに適合させて、適合した値またはモデルを返します。numeric_exprはトレンドのY値を表し、series (時間列)はX値を表します。	`TRENDLINE(numeric_expr, ([series]) BY ([partitionBy]), model_type, result_type)`
CLUSTER	`CLUSTER((product, company), (billed_quantity, revenue), 'clusterName', 'algorithm=k-means;numClusters=%1;maxIter=%2;useRandomSeed=FALSE;enablePartitioning=TRUE', 5, 10)`	K平均法または階層的クラスタリングを使用する1つ以上の入力式に基づいてレコード・セットをグループに集めます。	`CLUSTER((dimension_expr1 , ... dimension_exprN), (expr1, ... exprN), output_column_name, options, [runtime_binded_options])`
OUTLIER	`OUTLIER((product, company), (billed_quantity, revenue), 'isOutlier', 'algorithm=kmeans')`	K平均法、階層的クラスタリングまたは多変量外れ値検出アリゴリズムを使用する1つ以上の入力式に基づいて、レコードを外れ値として分類します。	`OUTLIER((dimension_expr1 , ... dimension_exprN), (expr1, ... exprN), output_column_name, options, [runtime_binded_options])`
REGR	`REGR(revenue, (discount_amount), (product_type, brand), 'fitted', '')`	線形モデルに適合させて、適合した値またはモデルを返します。この関数は、2つのメジャーに線形曲線を適合するために使用できます。	`REGR(y_axis_measure_expr, (x_axis_expr), (category_expr1, ..., category_exprN), output_column_name, options, [runtime_binded_options])`

カレンダ関数

カレンダ関数は、暦年に基づいてデータ型DATEおよびDATETIMEのデータを操作します。

関数	例	説明	構文
CURRENT_Date	`CURRENT_DATE`	現在の日付を返します。日付は、Oracle BIを実行しているシステムによって決定されます。	`CURRENT_DATE`
CURRENT_TIME	`CURRENT_TIME(3)`	HH:MM:SS.SSSなど、指定した精度の桁数で現在の時刻を返します。引数を指定しない場合、関数はデフォルトの精度を返します。	`CURRENT_TIME(expr)`
CURRENT_TIMESTAMP	`CURRENT_TIMESTAMP(3)`	現在の日付/タイムスタンプを指定された精度の桁数で返します。	`CURRENT_TIMESTAMP(expr)`
DAYNAME	`DAYNAME(Order_Date)`	指定された日付式の曜日名を返します。	`DAYNAME(expr)`
DAYOFMONTH	`DAYOFMONTH(Order_Date)`	指定された日付式について、月の通算日に対応する数字を返します。	`DAYOFMONTH(expr)`
DAYOFWEEK	`DAYOFWEEK(Order_Date)`	指定された日付式について、曜日に対応する1から7の数字を返します。たとえば、1は日曜日、2は月曜日に対応し、同様に続いて7は土曜日に対応します。	`DAYOFWEEK(expr)`
DAYOFYEAR	`DAYOFYEAR(Order_Date)`	指定された日付式について、年の通算日に対応する数字(1から366)を返します。	`DAYOFYEAR(expr)`
DAY_OF_QUARTER	`DAY_OF_QUARTER(Order_Date)`	指定された日付式について、四半期の通算日に対応する数字(1から92)を返します。	`DAY_OF_QUARTER(expr)`
HOUR	`HOUR(Order_Time)`	指定された時刻式について、時間に対応する数字(0から23)を返します。たとえば、0は午前12時に対応し、23は午後11時に対応します。	`HOUR(expr)`
MINUTE	`MINUTE(Order_Time)`	指定された時刻式について、分に対応する数字(0から59)を返します。	`MINUTE(expr)`
MONTH	`MONTH(Order_Time)`	指定された日付式について、月に対応する数字(1から12)を返します。	`MONTH(expr)`
MONTHNAME	`MONTHNAME(Order_Time)`	指定された日付式の月の名前を返します。	`MONTHNAME(expr)`
MONTH_OF_QUARTER	`MONTH_OF_QUARTER(Order_Date)`	指定された日付式について、四半期の通算月に対応する数字(1から3)を返します。	`MONTH_OF_QUARTER(expr)`
NOW	`NOW()`	現在のタイムスタンプを返します。`NOW`関数は、`CURRENT_TIMESTAMP`関数と同じです。	`NOW()`
QUARTER_OF_YEAR	`QUARTER_OF_YEAR(Order_Date)`	指定された日付式について、年の四半期に対応する数字(1から4)を返します。	`QUARTER_OF_YEAR(expr)`
SECOND	`SECOND(Order_Time)`	指定された時刻式について、秒に対応する数字(0から59)を返します。	`SECOND(expr)`
TIMESTAMPADD	`TIMESTAMPADD(SQL_TSI_MONTH, 12,Time."Order Date")`	指定された間隔の数をタイムスタンプに加算し、単一のタイムスタンプを返します。間隔のオプションは、SQL_TSI_SECOND、SQL_TSI_MINUTE、SQL_TSI_HOUR、SQL_TSI_DAY、SQL_TSI_WEEK、SQL_TSI_MONTH、SQL_TSI_QUARTER、SQL_TSI_YEARです	`TIMESTAMPADD(interval, expr, timestamp)`
TIMESTAMPDIFF	`TIMESTAMPDIFF(SQL_TSI_MONTH, Time."Order Date",CURRENT_DATE)`	2つのタイムスタンプ間の指定された間隔の合計数を返します。 TIMESTAMPADDと同じ間隔を使用します。	`TIMESTAMPDIFF(interval, expr, timestamp2)`
WEEK_OF_QUARTER	`WEEK_OF_QUARTER(Order_Date)`	指定された日付式について、四半期の通算週に対応する数字(1から13)を返します。	`WEEK_OF_QUARTER(expr)`
WEEK_OF_YEAR	`WEEK_OF_YEAR(Order_Date)`	指定された日付式について、年の通算週に対応する数字(1から53)を返します。	`WEEK_OF_YEAR(expr)`
YEAR	`YEAR(Order_Date)`	指定された日付式の年を返します。	`YEAR(expr)`

変換関数

変換関数は、ある形式から別の形式に値を変換します。

関数	例	説明	構文
CAST	`CAST(hiredate AS CHAR(40)) FROM employee`	式またはNULLリテラルのデータ型を別のデータ型に変更します。たとえば、customer_name (`CHAR`または`VARCHAR`のデータ型)またはbirthdate (日時リテラル)をキャストできます。 Dateデータ型に変更する場合は、`CAST`を使用します。 `TODATE`は使用しないでください。	`CAST(expr AS type)`
IFNULL	`IFNULL(Sales, 0)`	式がNULL値と評価されるかどうかをテストし、評価される場合は、指定された値をその式に割り当てます。	`IFNULL(expr, value)`
INDEXCOL	`SELECT INDEXCOL(VALUEOF (NQ_SESSION.GEOGRAPHY_LEVEL), Country, State, City), Revenue FROM Sales`	外部情報を使用して、ログインしているユーザーが参照できるように適切な列を返します。	`INDEXCOL([integer literal], [expr1] [, [expr2], ?-])`
NULLIF	`SELECT e.last_name, NULLIF(e.job_id, j.job_id) "Old Job ID" FROM employees e, job_history j WHERE e.employee_id = j.employee_id ORDER BY last_name, "Old Job ID";`	2つの式を比較します。それらが等しい場合、関数によりNULLが戻されます。それらが等しくない場合、最初の式が戻されます。最初の式には、リテラルのNULLを指定できません。	`NULLIF([expression], [expression])`
To_DateTime	`SELECT To_DateTime ('2009-03-0301:01:00', 'yyyy-mm-dd hh:mi:ss') FROM sales`	DateTime書式の文字列リテラルをDateTimeデータ型に変換します。	`To_DateTime([expression], [literal])`
VALUEOF	`SalesSubjectArea.Customer.Region = VALUEOF("Region Security"."REGION")`	フィルタでセマンティック・モデル変数の値を参照します。 expr変数を`VALUEOF`関数の引数として使用します。静的モデル変数は名前で参照します。	`VALUEOF(expr)`

表示関数

表示関数は、問合せの結果セットを操作します。

関数	例	説明	構文
BottomN	`BottomN(Sales, 10)`	最下位から最上位までランク付けされた式の、最下位のnの値を返します。	`BottomN([NumericExpression], [integer])`
FILTER	`FILTER(Sales USING Product = 'widget')`	特定の事前集計フィルタを使用して式を計算します。	`FILTER(measure USING filter_expr)`
MAVG	`MAVG(Sales, 10)`	現在の行を含めて、結果セットのデータの最後のn行の移動平均を計算します。	`MAVG([NumericExpression], [integer])`
MSUM	`SELECT Month, Revenue, MSUM(Revenue, 3) as 3_MO_SUM FROM Sales`	現在の行を含めて、データの最後のn行の移動合計を計算します。最初の行の合計は、最初の行の数値式と同じです。2番目の行の合計は、最初の2つの行のデータの合計を取得することで計算され、それ以降も同様です。n 番目の行に到達すると、合計は最後のn行のデータに基づいて計算されます。	`MSUM([NumericExpression], [integer])`
NTILE	`NTILE(Sales, 100)`	ユーザーの指定範囲における値のランクを決定します。範囲のランクを示す整数を返します。例では、1から100の範囲で、1が販売の最小値、100が販売の最高値となります。	`NTILE([NumericExpresssion], [integer])`
PERCENTILE	`PERCENTILE(Sales)`	数値式の引数を満たす各値のパーセント・ランクを計算します。パーセンタイル・ランクの範囲は、0 (1番目のパーセンタイル)から1 (100番目のパーセンタイル)です。	`PERCENTILE([NumericExpression])`
RANK	`RANK(Sales)`	数値式の引数を満たす各値のランクを計算します。最も高い数値にはランク1が割り当てられ、次に続くランクには2、3、4などの連続した整数が割り当てられます。ある値が等しい場合、同じランクが割り当てられます(たとえば、1、1、1、4、5、5、7...)。	`RANK([NumericExpression])`
RCOUNT	`SELECT month, profit, RCOUNT(profit) FROM sales WHERE profit > 200`	入力として一連のレコードを取得し、これまでに発生したレコード数をカウントします。	`RCOUNT([NumericExpression])`
RMAX	`SELECT month, profit, RMAX(profit) FROM sales`	入力として一連のレコードを取得し、これまでに発生したレコードに基づいて最大値を示します。指定するデータ型は順序付けできるものである必要があります。	`RMAX([NumericExpression])`
RMIN	`SELECT month, profit, RMIN(profit) FROM sales`	入力として一連のレコードを取得し、これまでに発生したレコードに基づいて最小値を示します。指定するデータ型は順序付けできるものである必要があります。	`RMIN([NumericExpression])`
RSUM	`SELECT month, revenue, RSUM(revenue) as RUNNING_SUM FROM sales`	これまでに発生したレコードに基づいて累計を計算します。最初の行の合計は、最初の行の数値式と同じです。2番目の行の合計は、最初の2つの行のデータの合計を取得することで計算され、それ以降も同様です。	`RSUM([NumericExpression])`
TOPN	`TOPN(Sales, 10)`	最上位から最下位までランク付けされた式の、最上位のnの値を返します。	`TOPN([NumericExpression], [integer])`

評価関数

評価関数は、式を通して高度な計算を行うために使用できるデータベース関数です。

埋込みデータベース関数には、1つ以上の列が必要になる場合があります。これらの列は、関数内で%1 ... %Nによって参照されます。実際の列は、関数の後にリストする必要があります。

関数	例	説明	構文
EVALUATE	`SELECT EVALUATE('instr(%1, %2)', address, 'Foster City') FROM employees`	指定のデータベース関数を、パラメータとしてオプションの参照列を指定し、評価のためにデータベースに渡します。	`EVALUATE([string expression], [comma separated expressions])`
EVALUATE_AGGR	`EVALUATE_AGGR('REGR_SLOPE(%1, %2)', sales.quantity, market.marketkey)`	指定のデータベース関数を、パラメータとしてオプションの参照列を指定し、評価のためにデータベースに渡します。この関数は、`GROUP BY`句を使用する集計関数を対象としています。	`EVALUATE_AGGR('db_agg_function(%1...%N)' [AS datatype] [, column1, columnN])`

算術関数

この項で説明する数学関数は、数学演算を実行します。

関数	例	説明	構文
ABS	`ABS(Profit)`	数値式の絶対値を計算します。 exprは、数値に評価される任意の式です。	`ABS(expr)`
ACOS	`ACOS(1)`	数値式の逆余弦を計算します。 exprは、数値に評価される任意の式です。	`ACOS(expr)`
ASIN	`ASIN(1)`	数値式の逆正弦を計算します。 exprは、数値に評価される任意の式です。	`ASIN(expr)`
ATAN	`ATAN(1)`	数値式の逆正接を計算します。 exprは、数値に評価される任意の式です。	`ATAN(expr)`
ATAN2	`ATAN2(1, 2)`	y /xのアーク・タンジェントを計算します。ここでyは最初の数値式、xは2番目の数値式です。	`ATAN2(expr1, expr2)`
CEILING	`CEILING(Profit)`	整数以外の数値式を最も近い整数に切り上げます。数式が整数に評価される場合、`CEILING`関数はその整数を返します。	`CEILING(expr)`
COS	`COS(1)`	数値式の余弦を計算します。 exprは、数値に評価される任意の式です。	`COS(expr)`
COT	`COT(1)`	数値式の余接を計算します。 exprは、数値に評価される任意の式です。	`COT(expr)`
DEGREES	`DEGREES(1)`	式をラジアンから度に変換します。 exprは、数値に評価される任意の式です。	`DEGREES(expr)`
EXP	`EXP(4)`	値を指定された値でべき乗します。eのn乗を計算します。ここでeは自然対数の底です。	`EXP(expr)`
ExtractBit	`Int ExtractBit(1, 5)`	整数内の特定の位置にあるビットを取得します。そのビットの位置に対応する0または1の整数を返します。	`ExtractBit([Source Number], [Digits])`
FLOOR	`FLOOR(Profit)`	整数以外の数値式を最も近い整数に切り下げます。数式が整数に評価される場合、`FLOOR`関数はその整数を返します。	`FLOOR(expr)`
LOG	`LOG(1)`	式の自然対数を計算します。 exprは、数値に評価される任意の式です。	`LOG(expr)`
LOG10	`LOG10(1)`	式の基数10の対数を計算します。 exprは、数値に評価される任意の式です。	`LOG10(expr)`
MOD	`MOD(10, 3)`	最初の数値式を2番目の数値式で除算し、商の余りを返します。	`MOD(expr1, expr2)`
PI	`PI()`	パイの定数値を返します。	`PI()`
POWER	`POWER(Profit, 2)`	最初の数値式を取得し、2番目の数値式で指定された値でべき乗します。	`POWER(expr1, expr2)`
RADIANS	`RADIANS(30)`	式を度からラジアンに変換します。 exprは、数値に評価される任意の式です。	`RADIANS(expr)`
RAND	`RAND()`	0から1の疑似乱数を返します。	`RAND()`
RANDFromSeed	`RAND(2)`	シード値に基づいた疑似乱数を返します。特定のシード値に対して、乱数の同一セットが生成されます。	`RAND(expr)`
ROUND	`ROUND(2.166000, 2)`	数値式をn桁の精度で丸めます。 exprは、数値に評価される任意の式です。 integerは、丸める精度の桁数を表す任意の正の整数です。	`ROUND(expr, integer)`
SIGN	`SIGN(Profit)`	次の値が返されます。数値式が正数に評価される場合は1を返します。数値式が負数に評価される場合は-1を返します。数値式がゼロに評価される場合は0を返します。	`SIGN(expr)`
SIN	`SIN(1)`	数値式の正弦を計算します。	`SIN(expr)`
SQRT	`SQRT(7)`	数値式の引数の平方根を計算します。数値式は、負数ではない数値に評価される必要があります。	`SQRT(expr)`
TAN	`TAN(1)`	数値式の正接を計算します。 exprは、数値に評価される任意の式です。	`TAN(expr)`
TRUNCATE	`TRUNCATE(45.12345, 2)`	小数を切り捨てて、小数点から指定された桁数の数値を返します。 exprは、数値に評価される任意の式です。 integerは、小数位の右側から返す文字数を表す任意の正の整数です。	`TRUNCATE(expr, integer)`

集計実行関数

集計実行関数は、複数の値に対して操作を実行しサマリー結果を作成します。

関数	例	説明	構文
MAVG		現在の行を含めて、結果セットのデータの最後のn行の移動平均を計算します。 exprは、数値に評価される任意の式です。integerは正の整数です。最後のn行のデータ平均を表します。	`MAVG(expr, integer)`
MSUM	`select month, revenue, MSUM(revenue, 3) as 3_MO_SUM from sales_subject_area`	現在の行を含めて、データの最後のn行の移動合計を計算します。 exprは、数値に評価される任意の式です。integerは正の整数です。最後のn行のデータの合計を表します。	`MSUM(expr, integer)`
RSUM	`SELECT month, revenue, RSUM(revenue) as RUNNING_SUM from sales_subject_area`	これまでに発生したレコードに基づいて累計を計算します。 exprは、数値に評価される任意の式です。	`RSUM(expr)`
RCOUNT	`select month, profit, RCOUNT(profit) from sales_subject_area where profit > 200`	入力として一連のレコードを取得し、これまでに発生したレコード数をカウントします。 exprは、任意のデータ型の式です。	`RCOUNT(expr)`
RMAX	`SELECT month, profit,RMAX(profit) from sales_subject_area`	入力として一連のレコードを取得し、これまでに発生したレコードに基づいて最大値を示します。 exprは、任意のデータ型の式です。	`RMAX(expr)`
RMIN	`select month, profit,RMIN(profit) from sales_subject_area`	入力として一連のレコードを取得し、これまでに発生したレコードに基づいて最小値を示します。 exprは、任意のデータ型の式です。	`RMIN(expr)`

空間関数

空間関数を使用すると、管理ツールを使用してデータをモデル化するときに地理的分析を実行できます。たとえば、(形状または多角形と呼ばれる) 2つの地理的領域間の距離を計算できます。

ノート:

これらの空間関数は、ビジュアライゼーション・ワークブックのカスタム計算では使用できません。

関数	例	説明	構文
GeometryArea	`GeometryArea(Shape)`	形状が占有する領域を計算します。	`GeometryArea(Shape)`
GeometryDistance	`GeometryDistance(TRIP_START, TRIP_END)`	2つの形状間の距離を計算します。	`GeometryDistance(Shape 1, Shape 2)`
GeometryLength	`GeometryLength(Shape)`	形状の円周を計算します。	`GeometryLength(Shape)`
GeometryRelate	`GeometryRelate(TRIP_START, TRIP_END)`	ある形状が別の形状の内側にあるかどうかを判別します。文字列(varchar)として'TRUE'または'FALSE'を返します。	`GeometryRelate(Shape 1, Shape 2)`
GeometryWithinDistance	`GeometryWithinDistance(TRIP_START, TRIP_END, 500)`	2つの形状が相互に指定された距離内にあるかどうかを判断します。文字列(varchar)として'TRUE'または'FALSE'を返します。	`GeometryWithinDistance(Shape1, Shape2, DistanceInFloat)`

文字列関数

文字列関数は、様々な文字操作を実行します。これらは文字列に対して動作します。

関数	例	説明	構文
ASCII	`ASCII('a')`	単一文字列を0から255の対応するASCIIコードに変換します。文字式が複数の文字に評価される場合は、式の最初の文字に対応するASCIIコードが返されます。 exprは、文字列に評価される任意の式です。	`ASCII(expr)`
BIT_LENGTH	`BIT_LENGTH('abcdef')`	指定された文字列の長さをビット単位で返します。各Unicode文字の長さは2バイトです(16ビットに相当)。 exprは、文字列に評価される任意の式です。	`BIT_LENGTH(expr)`
CHAR	`CHAR(35)`	0から255の数値をASCIIコードに対応する文字値に変換します。 exprは、0から255までの数値に評価される任意の式です。	`CHAR(expr)`
CHAR_LENGTH	`CHAR_LENGTH(Customer_Name)`	指定した文字列の長さを文字数で返します。先頭と末尾の空白は、文字列の長さとして計算されません。 exprは、文字列に評価される任意の式です。	`CHAR_LENGTH(expr)`
CONCAT	`SELECT DISTINCT CONCAT ('abc', 'def') FROM employee`	2つの文字列を連結します。 exprsは、カンマで区切られた文字列に評価される式です。 `CONCAT`では、フォーマットされたデータではなくRAWデータを使用する必要があります。	`CONCAT(expr1, expr2)`
INSERT	`SELECT INSERT('123456', 2, 3, 'abcd') FROM table`	指定された文字列を別の文字列の指定された場所に挿入します。 expr1は、文字列に評価される任意の式です。ターゲットの文字列を示します。 integer1は、2番目の文字列が挿入される、ターゲットの文字列の先頭からの文字数を表す任意の正の整数です。 integer2は、2番目の文字列によって置換される、ターゲットの文字数を表す任意の正の整数です。 expr2は、文字列に評価される任意の式です。ターゲットの文字列に挿入される文字列を示します。	`INSERT(expr1, integer1, integer2, expr2)`
LEFT	`SELECT LEFT('123456', 3) FROM table`	文字列の左側から指定された文字数を返します。 exprは、文字列に評価される任意の式です integerは、文字列の左側から返す文字数を表す任意の正の整数です。	`LEFT(expr, integer)`
LENGTH	`LENGTH(Customer_Name)`	指定した文字列の長さを文字数で返します。末尾の空白文字を除いた長さを返します。 exprは、文字列に評価される任意の式です。	`LENGTH(expr)`
LOCATE	`LOCATE('d' 'abcdef')`	別の文字列での文字列の数値位置を返します。文字列が検索される文字列で見つからない場合、関数は値0を返します。 expr1は、文字列に評価される任意の式です。検索する文字列を示します。 expr2は、文字列に評価される任意の式です。検索される文字列を示します。	`LOCATE(expr1, expr2)`
LOCATEN	`LOCATEN('d' 'abcdef', 3)`	LOCATEと同様に、別の文字列での文字列の数値位置を返します。LOCATENには、検索の開始位置を指定できる整数の引数が含まれます。 expr1は、文字列に評価される任意の式です。検索する文字列を示します。 expr2は、文字列に評価される任意の式です。検索される文字列を示します。 integerは、文字列の検索を開始する位置を表す任意の正(ゼロ以外)の整数です。	`LOCATEN(expr1, expr2, integer)`
LOWER	`LOWER(Customer_Name)`	文字列を小文字に変換します。 exprは、文字列に評価される任意の式です。	`LOWER(expr)`
OCTET_LENGTH	`OCTET_LENGTH('abcdef')`	指定された文字列のバイト数を返します。 exprは、文字列に評価される任意の式です。	`OCTET_LENGTH(expr)`
POSITION	`POSITION('d', 'abcdef')`	文字式でのstrExpr1の数値位置を返します。strExpr1が見つからない場合、関数は0を返します。 expr1は、文字列に評価される任意の式です。ターゲット文字列で検索する文字列を示します。 expr2は、文字列に評価される任意の式です。検索されるターゲット文字列を示します。	`POSITION(expr1 IN expr2)`
REPEAT	`REPEAT('abc', 4)`	指定した式をn回繰り返します。 exprは、文字列に評価される任意の式です integerは、文字列を繰り返す回数を表す任意の正の整数です。	`REPEAT(expr, integer)`
REPLACE	`REPLACE('abcd1234', '123', 'zz')`	指定された文字式の1つ以上の文字を別の1つ以上の文字で置換します。 expr1は、文字列に評価される任意の式です。これは、文字が置換される文字列です。 expr2は、文字列に評価される任意の式です。この2番目の文字列は、1番目の文字列で置換される文字を示します。 expr3は、文字列に評価される任意の式です。この3番目の文字列は、1番目の文字列内に代入する文字を指定します。	`REPLACE(expr1, expr2, expr3)`
RIGHT	`SELECT RIGHT('123456', 3) FROM table`	文字列の右側から指定された文字数を返します。 exprは、文字列に評価される任意の式です。 integerは、文字列の右側から返す文字数を表す任意の正の整数です。	`RIGHT(expr, integer)`
SPACE	`SPACE(2)`	空白を挿入します。 integerは、挿入する空白の数を示す任意の正の整数です。	`SPACE(expr)`
SUBSTRING	`SUBSTRING('abcdef' FROM 2)`	元の文字列内に固定された文字数から始まる新しい文字列を作成します。 exprは、文字列に評価される任意の式です。 startPosは、文字列の左の先頭(結果の先頭)からの文字数を表す任意の正の整数です。	`SUBSTRING([SourceString] FROM [StartPostition])`
SUBSTRINGN	`SUBSTRING('abcdef' FROM 2 FOR 3)`	SUBSTRINGと同様に、固定文字数から元の文字列の新しい文字列を作成します。 SUBSTRINGNには、新しい文字列の長さを文字数で指定できる整数の引数が含まれます。 exprは、文字列に評価される任意の式です。 startPosは、文字列の左の先頭(結果の先頭)からの文字数を表す任意の正の整数です。	`SUBSTRING(expr FROM startPos FOR length)`
TrimBoth	`Trim(BOTH '_' FROM '_abcdef_')`	指定された先頭文字および末尾文字を文字列から削除します。 charは、任意の単一文字です。文字の指定(および必須の一重引用符)を省略すると、空白文字がデフォルトで使用されます。 exprは、文字列に評価される任意の式です。	`TRIM(BOTH char FROM expr)`
TRIMLEADING	`TRIM(LEADING '_' FROM '_abcdef')`	指定された先頭文字を文字列から削除します。 charは、任意の単一文字です。文字の指定(および必須の一重引用符)を省略すると、空白文字がデフォルトで使用されます。 exprは、文字列に評価される任意の式です。	`TRIM(LEADING char FROM expr)`
TRIMTRAILING	`TRIM(TRAILING '_' FROM 'abcdef_')`	指定された末尾文字を文字列から削除します。 charは、任意の単一文字です。文字の指定(および必須の一重引用符)を省略すると、空白文字がデフォルトで使用されます。 exprは、文字列に評価される任意の式です。	`TRIM(TRAILING char FROM expr)`
UPPER	`UPPER(Customer_Name)`	文字列を大文字に変換します。 exprは、文字列に評価される任意の式です。	`UPPER(expr)`

システム関数

USERシステム関数は、セッションに関連する値を返します。たとえば、サインインしたユーザーのユーザー名です。

関数	例	説明	構文
DATABASE		ログオンしているサブジェクト領域の名前を返します。	`DATABASE()`
USER		ログオンしているセマンティック・モデルのユーザー名を返します。	`USER()`

時系列関数

時系列関数は、時間ディメンションを操作する集計関数です。

時間ディメンションのメンバーは、関数のレベル以下である必要があります。そのため、特定のレベル以下のメンバーを一意に識別する1つ以上の列を問合せに投影する必要があります。

関数例説明構文

関数	例	説明	構文
AGO	`SELECT Year_ID, AGO(sales, year, 1)`	現在の時刻から指定された過去の期間までのメジャーの集計値を計算します。たとえば、`AGO`を使用すると、現四半期の各月の売上および対応する1つ前の四半期の売上を生成できます。	`AGO(expr, time_level, offset)`
PERIODROLLING	`SELECT Month_ID, PERIODROLLING (monthly_sales, -1, 1)`	x単位の時間から始まり、現在の時刻からy単位の時間で終わる期間のメジャーの合計を計算します。たとえば、`PERIODROLLING`を使用して、現在の四半期前の四半期で始まり、現在の四半期後の四半期で終わる期間の売上を計算できます。 measureは、メジャー列の名前です。 xは、現在の時刻からのオフセットを指定する整数です。 yは、この関数が計算する時間単位の数を指定します。 hierarchyは、yr、mon、dayなど、時間ウィンドウの計算に使用する時間ディメンション内の階層の名前を指定するオプションの引数です。	`PERIODROLLING(measure, x [,y])`
TODATE	`SELECT Year_ID, Month_ID, TODATE (sales, year)`	指定された期間の最初から現在の表示時刻までのメジャーを集計します。たとえば、この関数では過去1年間の売上を計算できます。 exprは、1つ以上のメジャー列を参照する式です。 time_levelは、四半期、月、年などの期間のタイプです。	`TODATE(expr, time_level)`

AGO

SELECT Year_ID, AGO(sales, year, 1)

現在の時刻から指定された過去の期間までのメジャーの集計値を計算します。たとえば、AGOを使用すると、現四半期の各月の売上および対応する1つ前の四半期の売上を生成できます。

AGO(expr, time_level, offset)

PERIODROLLING

SELECT Month_ID, PERIODROLLING (monthly_sales, -1, 1)

x単位の時間から始まり、現在の時刻からy単位の時間で終わる期間のメジャーの合計を計算します。たとえば、PERIODROLLINGを使用して、現在の四半期前の四半期で始まり、現在の四半期後の四半期で終わる期間の売上を計算できます。

measureは、メジャー列の名前です。

xは、現在の時刻からのオフセットを指定する整数です。

yは、この関数が計算する時間単位の数を指定します。

hierarchyは、yr、mon、dayなど、時間ウィンドウの計算に使用する時間ディメンション内の階層の名前を指定するオプションの引数です。

PERIODROLLING(measure, x [,y])

TODATE

SELECT Year_ID, Month_ID, TODATE (sales, year)

指定された期間の最初から現在の表示時刻までのメジャーを集計します。たとえば、この関数では過去1年間の売上を計算できます。

exprは、1つ以上のメジャー列を参照する式です。

time_levelは、四半期、月、年などの期間のタイプです。

TODATE(expr, time_level)

FORECAST関数

指数平滑法(ETS)または季節性ARMIAやARIMAを使用して、seriesに対して指定されたメジャーの時系列モデルを作成します。この関数は、numPeriods引数で指定された一連の期間の予測を出力します。

構文 FORECAST(numeric_expr, ([series]), output_column_name, options,[runtime_binded_options])])

説明:

numeric_exprは、予測するメジャー、たとえば予測する収益データを示します。
seriesは、予測モデルの作成に使用される時間粒度を示しています。seriesは1つ以上の時間ディメンション列のリストです。seriesを省略すると、問合せから時間の粒度が決定されます。
output_column_nameは、forecast、low、highおよびpredictionIntervalの有効な列名を示しています。
optionsは、セミコロン(;)で区切られた名前/値のペアの文字列リストを示します。値にはruntime_binded_optionsで指定される%1 ... %Nを含むことができます。
runtime_binded_optionsは、列およびオプションのカンマ区切りリストを示しています。これらの列およびオプションの値は、個別の問合せ実行時に評価および解決されます。

FORECAST関数のオプション次の表は、FORECAST関数とともに使用できるオプションを示しています。

オプション名	値	説明
numPeriods	整数	予測する時間間隔の数
predictionInterval	0から100(値が大きいほど信頼度が高くなります)	予測の信頼度レベル。
modelType	ETS SeasonalArima ARIMA	予測に使用するモデル。
useBoxCox	TRUE FALSE	TRUEの場合、Box-Cox変換を使用します。
lambdaValue	該当なし	Box-Cox変換パラメータ。 NULLまたは`useBoxCox`がFALSEである場合に無視します。それ以外の場合、モデルを予測する前にデータが変換されます。
trendDamp	TRUE FALSE	これはETSモデルのパラメータです。 TRUEの場合、減衰した傾向を使用します。FALSEまたはNULLの場合は、非減衰トレンドを使用します。
errorType	該当なし	これはETSモデルのパラメータです。
trendType	N (なし) A (加算) M (乗算) Z (自動選択)	これはETSモデルのパラメータです。
seasonType	N (なし) A (加算) M (乗算) Z (自動選択)	これはETSモデルのパラメータです。
modelParamIC	ic_auto ic_aicc ic_bic ic_auto (これがデフォルトです)	モデル選択に使用する情報基準(IC)。

日単位の収益予測の例

この例は日単位の収益予測を選択します。

FORECAST("A - Sample Sales"."Base Facts"."1- Revenue" Target,
("A - Sample Sales"."Time"."T00 Calendar Date"),'forecast', 'numPeriods=30;predictionInterval=70;') ForecastedRevenue

年および四半期単位の収益予測の例

この例は年単位および四半期単位の収益予測を選択します。

FORECAST("A - Sample Sales"."Base Facts"."1- Revenue",
("A - Sample Sales"."Time"."T01 Year" timeYear, "A - Sample Sales"."Time"."T02 Quarter" TimeQuarter),'forecast', 'numPeriods=30;predictionInterval=70;') ForecastedRevenue