関数

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

トピック:

• 集計関数

• 分析関数

• 変換関数

• 日付と時間関数

• 日付抽出関数

• 表示関数

• 評価関数

• 算術関数

• 集計実行関数

• 空間関数

• 文字列関数

• システム関数

• 時系列関数

集計関数

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

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

• デフォルト — セマンティック・モデルと同様に、もしくは分析の最初の作成者によって、デフォルトの集計ルールが適用されます。分析の計算項目には使用できません。

• サーバーの設定を適用 — Oracle BIサーバーによって決定された集計ルール(セマンティック・モデルで定義されたルールなど)が適用されます。集計は、合計、最低および最大などの単純なルールの場合は、Oracle BIサーバー内で実行されます。「レイアウト」ペインのメジャー列または分析の計算項目には使用できません。

• SUM — 結果セットに含まれるすべての値を加算して取得した合計が計算されます。数値を含む項目に使用します。

• MIN — 結果セットに含まれる行の最小値(最も低い数値)が計算されます。数値を含む項目に使用します。

• MAX — 結果セットに含まれる行の最大値(最も高い数値)が計算されます。数値を含む項目に使用します。

• AVG — 結果セットに含まれる項目の平均値が計算されます。数値を含む項目に使用します。表およびピボット表の平均が、近似の整数値に丸められます。

• FIRST — メジャーに関して、結果セットに含まれるその項目のうち、最初に出現するものが選択されます。計算項目の場合は、「選択済」リストの表示に準じて最初のメンバーが選択されます。「列式の編集」ダイアログ・ボックスでは使用できません。

• LAST — 結果セットに含まれるその項目のうち、最後に出現するものが選択されます。計算項目の場合は、「選択済」リストの表示に準じて最後のメンバーが選択されます。「列式の編集」ダイアログ・ボックスでは使用できません。

• COUNT — その項目に関して、結果セットに含まれるnullでない値を持つ行の数が計算されます。通常、項目は列名であり、その場合はその列に対してnull以外の値を持つ行の数が返されます。

• COUNT DISTINCT — COUNT関数に個別処理を追加します。つまり、項目の個別の出現は、1回のみカウントされます。

• なし — 集計は適用されません。分析の計算項目には使用できません。

• サーバー複合集計— Oracle BIサーバーによって決定された集計ルール(セマンティク・モデルで定義されたルールなど)が適用されます。集計は、プレゼンテーション・サービス内ではなく、Oracle BIサーバーによって実行されます。分析の計算項目には使用できません。

• レポートを基準にした合計(適用可能な場合) — 選択を解除すると、メジャーにフィルタが適用される前に、結果セット全体に基づいて、Oracle BIサーバーによって合計が計算されます。「列式の編集」ダイアログ・ボックスまたは分析の計算項目には使用できません。属性列のみに使用できます。

関数	例	説明	構文
AGGREGATE AT	AGGREGATE(sales AT year)	指定したデータ・モデル階層内のレベルに基づいて列を集計します。 measureは、メジャー列の名前です。 levelは、集計するレベルです。 オプションで、複数のレベルを指定できます。1番目の引数で指定したメジャーのメジャー・レベルとして使用されるレベルを含むディメンションのレベルを指定できません。たとえば、monthがyearly_salesのメジャー・レベルとして使用されているのと同じ時間ディメンジョンのものである場合、関数をAGGREGATE(yearly_sales AT month)と指定することはできません。	AGGREGATE(measure AT level [, level1, levelN])
AGGREGATE BY	AGGREGATE(sales BY month, region)	1つ以上のディメンション列に基づいてメジャーを集計します。 measureは、集計するメジャー列の名前です。 columnは、集計するディメンション列です。 複数の列に基づいてメジャーを集計できます。	AGGREGATE(measure BY column [, column1, columnN])
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)

集計関数の使用に関するヒント

ここでは、ワークブックで集計関数を使用する際に、結果を最善のものにするためのヒントをいくつかご紹介します。

ヒント:

• First、Last -100%の積上げ棒グラフでは、FirstおよびLast集計を使用しないでください。Byに現在の日付を追加すると、問合せにグレインが追加され、ビジュアライゼーションのすべての行に加えて、現在の日付がフェッチされます。次に、Last関数によって、その結果セットの最後の行が返されますが、これはデータがソースからどのように返されるかによって変わります。
• Min - 行セット内の最小値を計算するには、Minを使用します。一連の列の最小値を見つけるには、Evaluateを使用します。たとえば:

  evaluate('least(%1,%2,%3)',column date 1,date 2,date 3)

分析関数

分析関数では、予測、トレンド線やクラスタなどのモデルを使用してデータを調査できます。または、分析関数をワークブック・エディタにドラッグ・アンド・ドロップできます。

または、予測、トレンド線およびクラスタをワークブック・エディタのデータ・パネルの「分析」タブで選択して、ワークブックに追加できます。ビジュアライゼーションへの統計分析関数の追加を参照してください。

関数	例	説明	構文
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])
FORECAST	日単位の収益予測の例 この例は日単位の収益予測を選択します。 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	指数平滑法(ETS)または季節性ARMIAやARIMAを使用して、seriesに対して指定されたメジャーの時系列モデルを作成します。この関数は、numPeriods引数で指定された一連の期間の予測を出力します。 次の追加のFORECAST関数のオプションも参照してください。	FORECAST(measure, ([series]), output_column_name, options,[runtime_binded_options])]) 説明: measureは、収益データなど、予測するメジャーを表します。 seriesは、予測モデルの作成に使用される時間粒度を表します。seriesは1つ以上の時間ディメンション列のリストです。seriesを省略すると、問合せから時間の粒度が決定されます。 output_column_nameは、forecast、low、highおよびpredictionIntervalの有効な列名を表します。 optionsは、セミコロン(;)で区切られた名前/値のペアの文字列リストを表します。値にはruntime_binded_optionsで指定される%1 ... %Nを含むことができます。 runtime_binded_optionsは、列およびオプションのカンマ区切りリストを表します。これらの列およびオプションの値は、個別の問合せ実行時に評価および解決されます。 次の追加のFORECAST関数のオプションも参照してください。
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])
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)

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	これは、指数平滑法モデルに固有です。 TRUEの場合、減衰した傾向を使用します。FALSEまたはNULLの場合は、非減衰トレンドを使用します。
errorType	該当なし	これは、指数平滑法モデルに固有です。
trendType	N (なし) A (加算) M (乗算) Z (自動選択)	これは、指数平滑法モデルに固有です
seasonType	N (なし) A (加算) M (乗算) Z (自動選択)	これは、指数平滑法モデルに固有です
modelParamIC	ic_auto ic_aicc ic_bic ic_auto (これがデフォルトです)	モデル選択に使用する情報基準(IC)。

変換関数

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

関数	例	説明	構文
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)

日付と時間関数

日付と時間関数は、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)

日付関数の使用に関するヒント

ここでは、ワークブックで日付関数を使用して会計期間の計算や、文字列から日付への変換、特定のタイム・ゾーンの日時の表示、時間の経過による差異の計算を行う際に、結果を最善のものにするためのヒントをいくつかご紹介します。

会計年度、四半期、月の計算:

サブジェクト領域には通常、時間ディメンションがあるため、会計四半期や会計月、会計週など、事前に構成された期間を使用できます。存在するのが日付フィールドのみの場合は、日付関数を使用すると、これらの期間を自分で計算できます。

次の例では、会計四半期を計算しています:

'FY'||cast(YEAR(TIMESTAMPADD(SQL_TSI_MONTH, 7,<date field>)) as char)||'Q'||cast(QUARTER(TIMESTAMPADD(SQL_TSI_MONTH, 7,<same date field>)) as char)

次の例では、会計年度と会計月を計算しています:

'FY'||cast(YEAR(TIMESTAMPADD(SQL_TSI_MONTH, 7,<date field>)) as char)||cast(MONTHNAME(<same date field>) as char)

ノート:

• ||は値を連結します。
• cast (xxx(date) as char)は、日付フィールドの一部を抽出します。
• TIMESTAMPADDは、日付に期間を加算(または減算)します。この例では、パラメータ値SQL_TSI_MONTHを使用して、月が加算されています。

上の計算は表ではうまく機能しますが、フィルタで使用すると、返された値の間にある間隔が正常に表示されない場合があります。その場合は、次の例に基づいて、より複雑ではありますが、読みやすい計算を使用します:

'FY'||evaluate ('to_char(%1,%2)'as char,(EVALUATE('add_months(%1,%2)' as date,<date field>,7)),'YY')||'-Q'||evaluate ('to_char(%1,%2)'as char,(EVALUATE('add_months(%1,%2)' as date,<same date field>,7)),'Q')

'FY'||evaluate ('to_char(%1,%2)'as char,(EVALUATE('add_months(%1,%2)' as date,<date field>,7)),'YY')||'-'||evaluate ('to_char(%1,%2)'as char,<same date field>,'MON')

文字列を日付に変換:

Oracle Analyticsによりデータがプロファイリングされ、日付の抽出および変換に関するエンリッチメントの推奨が提示されます。文字列を自分で日付に変換する必要がある場合は、次のヒントを参考にしてください。

• ワークブック・デザイナのデータ・ペインで変換する列に移動し、右クリックして「日付に変換」を選択します。日付を構成して、「ステップの追加」をクリックします。
  
  
  図convert-string-date.pngの説明
  
  
• ワークブック・デザイナのデータ・ペインで変換する列に移動し、右クリックして「編集」を選択します。日付を構成して、「ステップの追加」をクリックします。
  
  
  図convert-string-date-2.pngの説明
  
  

  列の名前が青色のテキスト・ボックスで、列名の前にTo_DateTime(を挿入し、使用する日付書式を列名の後に追加して、最後に)を付加し、「ステップの追加」をクリックします。
  
  図convert-string-date-3.pngの説明
  

  「編集」オプションを使用して日付変換関数を作成する際は、Allow_Variable_Digitsを使用して、1桁か2桁の数値の列の値を処理することや、Null_On_Error引数を使用して、必要とされるパターンに一致しない行を破棄することもできます。求められるパターンに一致しないデータを処理する別の方法については、REPLACEおよびCASTも参照してください。

  To_DateTime()を使用するかわりに、CAST()を使用して値のデータ型を変更します。たとえば、CAST(SalesDate AS DATE)のようにします。

  また、「置換」オプションを使用します。ワークブック・デザイナのデータ・ペインで変換する列に移動し、右クリックして「置換」を選択します。必要な置換タイプを構成して、「ステップの追加」をクリックします。

特定のタイムゾーンの日時フィールドの表示:

データベースで、NEW_TIME関数とEVALUATEを一緒に使用します。たとえば:

evaluate ('new_time(%1,%2,%3)' as char, "DV - Pipeline and Forecast"."Opportunity"."Last Updated Date",'GMT','AST')

日付フィールドに時間コンポーネントがあることを確認してください。

経時的な差異の計算:

現在と昨日の差異を数値とパーセンテージで示すには、次の例に基づいて計算を作成します:

• 昨日までのメジャーを計算: filter (Measure using date <= TIMESTAMPADD(SQL_TSI_DAY,-1,CURRENT_DATE))
• 差異を計算: Measure - filter (Measure using date <= TIMESTAMPADD(SQL_TSI_DAY,-1,CURRENT_DATE))
• パーセンテージの差異を計算: 1-(filter (Measure using date <= TIMESTAMPADD(SQL_TSI_DAY,-1,CURRENT_DATE))/Measure display as percentage

ノート:

• これらの例ではSQL_TSI_DAYが使用されていますが、かわりに、WEEKとMONTHを前週比および前月比に使用することができます。
• これらの例は、通常または一般的なカレンダで利用できます。会計月や会計四半期が必要な場合は、TIMESTAMPADDではなく、リポジトリ変数を計算に使用します。または、これと「会計年度、会計四半期、会計月の計算」のヒントを組み合せます。
• 一部のサブジェクト領域には、PY (前年)やPQ (前四半期)など、事前に計算された過去Xのメジャーが含まれており、時間の経過による差異の計算に使用できます。
• かわりに、AGO、PERIODROLLINGおよびTODATEのTIME SERIES関数を使用できます。時系列関数を参照してください。

日付抽出関数

これらの関数は、タイムスタンプ値の計算または切捨てを行って、最も近い指定した期間(時間、日、週、月、四半期など)にします。

計算されたタイムスタンプを使用して、異なるグレインを使用してデータを集計できます。たとえば、EXTRACTDAY()関数を受注日に適用して、注文が発生した日の午前0時のタイムスタンプを計算すると、データを日別に集計できます。

関数	例	説明	構文
日を抽出	EXTRACTDAY("Order Date") 2/22/1967 3:02:01 AMは2/22/1967 12:00:00 AMを返します。 9/2/2022 10:38:21 AMは9/2/2022 12:00:00 AMを返します。	入力値が発生した日の午前0時(午前12時)のタイムスタンプを返します。たとえば、入力タイムスタンプが2月22日午前3時02分01秒の場合、関数は2月22日午前12時00分00秒のタイムスタンプを返します。	EXTRACTDAY(expr)
時間を抽出	EXTRACTHOUR("Order Date") 2/22/1967 3:02:01 AMは2/22/1967 3:00:00 AMを返します。 6/17/1999 11:18:30 PMは6/17/1999 11:00:00 PMを返します。	入力値が発生した時刻の時間の開始のタイムスタンプを返します。たとえば、入力タイムスタンプが午後11時18分30秒の場合、関数は午後11時00分00秒のタイムスタンプを返します。	EXTRACTHOUR (expr)
日の時間を抽出	EXTRACTHOUROFDAY("Order Date") 2014/09/24 10:58:00は2000/01/01 10:00:00を返します。 2014/08/13 11:10:00は2000/01/01 11:00:00を返します。	年、月、日、分および秒のデフォルト値を使用して、時間が入力値の時間と等しいタイムスタンプを返します。	EXTRACTHOUROFDAY(expr)
ミリ秒を抽出	EXTRACTMILLISECOND("Order Date") 1997/01/07 15:32:02.150は1997/01/07 15:32:02.150を返します。 1997/01/07 18:42:01.265は1997/01/07 18:42:01.265を返します。	入力値のミリ秒を含むタイムスタンプを返します。たとえば、入力タイムスタンプが15時32分02.150秒の場合、関数は15時32分02.150秒のタイムスタンプを返します。	EXTRACTMILLISECOND(expr)
分を抽出	EXTRACTMINUTE("Order Date") 6/17/1999 11:18:00 PMは6/17/1999 11:18:00 PMを返します。 9/2/2022 10:38:21 AMは9/2/2022 10:38:00 AMを返します。	入力値が発生した時刻の分の開始のタイムスタンプを返します。たとえば、入力タイムスタンプが午前11時38分21秒の場合、関数は午前11時38分00秒のタイムスタンプを返します。	EXTRACTMINUTE (expr)
月を抽出	EXTRACTMONTH("Order Date") 2/22/1967 3:02:01 AMは2/1/1967 12:00:00 AMを返します。 6/17/1999 11:18:00 PMは6/1/1999 12:00:00 AMを返します。	入力値が発生した月の最初の日のタイムスタンプを返します。たとえば、入力タイムスタンプが2月22日の場合、関数は2月1日のタイムスタンプを返します。	EXTRACTMONTH(expr)
四半期を抽出	EXTRACTQUARTER("Order Date") 2/22/1967 3:02:01 AMは、第1会計四半期の初日である1/1/1967 12:00:00 AMを返します。 6/17/1999 11:18:00 PMは、第2会計四半期の初日である4/1/1999 12:00:00 AMを返します。 9/2/2022 10:38:21 AMは、第3会計四半期の初日である7/1/2022 12:00:00 AMを返します。 ヒント: QUARTER (expr)は、返されたタイムスタンプから四半期の序数のみを計算する場合に使用します。	入力値が発生した四半期の最初の日のタイムスタンプを返します。たとえば、入力タイムスタンプが第3会計四半期に発生した場合、関数は7月1日のタイムスタンプを返します。	EXTRACTQUARTER(expr)
秒を抽出	EXTRACTSECOND("Order Date") 1997/01/07 15:32:02.150は1997/01/07 15:32:02を返します。 1997/01/07 20:44:18.163は1997/01/07 20:44:18を返します。	入力値のタイムスタンプを返します。たとえば、入力タイムスタンプが15時32分02.150秒の場合、関数は15時32分02秒のタイムスタンプを返します。	EXTRACTSECOND(expr)
週を抽出	EXTRACTWEEK("Order Date") 2014/09/24 10:58:00は2014/09/21を返します。 2014/08/13 11:10:00は2014/08/10を返します。	入力値が発生した週の最初の曜日(日曜日)の日付を返します。たとえば、入力タイムスタンプが9月24日水曜日の場合、関数は9月21日日曜日のタイムスタンプを返します。 ノート: 週の最初の日(つまり日曜日)が前年に該当し、集計に悪影響を及ぼす可能性がある場合、関数は前年の週の最初の日ではなく、当年の週の7日目(つまり土曜日)を返します。たとえば、1/1/24、1/2/24および1/3/24はすべてSunday 12/29/23ではなく、Saturday 1/6/24に集約されます。	EXTRACTWEEK(expr)
年を抽出	EXTRACTYEAR("Order Date") 1967/02/22 03:02:01は1967/01/01 00:00:00を返します。 1999/06/17 23:18:00は1999/01/01 00:00:00を返します。	入力値が発生した年の1月1日のタイムスタンプを返します。たとえば、入力タイムスタンプが1967年に発生した場合、関数は1967年1月1日のタイムスタンプを返します。	EXTRACTYEAR (expr)

サブジェクト領域での日付ディメンションの使用に関するヒント

ここでは、サブジェクト領域の日付を計算で使用する際に結果を最善のものにするためのヒントをいくつか示します。

計算へのサブジェクト領域の日付の追加

日付をサブジェクト領域から計算に直接ドラッグし、これを文字列または整数として処理した場合、エラーが発生します。これは、基礎となる日付値がタイムスタンプであるため発生します。

かわりに、「日付抽出関数」のいずれかを使用して、日付を解釈します。

たとえば、次のサブジェクト領域の日付がある場合があります。

図tips-using-dates-1.pngの説明

これらのサブジェクト領域の日付から月を抽出するには、ExtractMonthOfYear関数を使用します。

case when monthname(ExtractMonthOfYear("Date")) in ('Jan' ,'Feb', 'Mar') 
THEN 'Q1' 
ELSE 'Rest of the year' END

表示関数

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

関数	例	説明	構文
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])

表示関数の使用に関するヒント

• FILTER - サブジェクト領域を使用してレポートを作成している場合、計算で階層列を直接フィルタするのではなく、サブジェクト領域で定義されている階層を使用します。つまり、サブジェクト領域にTime\Fiscal Year\Fiscal Quarterの階層がある場合、次を避けます:

  filter (<measure> using fiscal_quarter = 'Q4')

  filter (<measure> using fiscal_quarter = 'Q3')

  filter (<measure> using fiscal_year = 'FY24')

評価関数

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

埋込みデータベース関数には、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)	ある形状が別の形状の内側にあるかどうかを判別します。TRUEまたはFALSEを文字列(varchar)として返します。	GeometryRelate(Shape 1, Shape 2)
GeometryWithinDistance	GeometryWithinDistance(TRIP_START, TRIP_END, 500)	2つの形状が相互に指定された距離内にあるかどうかを判断します。TRUEまたはFALSEを文字列(varchar)として返します。	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は、文字列に評価される任意の式です。ターゲット文字列で検索する文字列を示します。たとえば、"d"です。 expr2は、文字列に評価される任意の式です。検索されるターゲット文字列を示します。たとえば、"abcdef"です。	POSITION(expr1, 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)

文字列関数の使用に関するヒント

ここでは、ワークブックで文字列関数を使用する際に、結果を最善のものにするためのヒントをいくつかご紹介します。

複数の値の連結:

LISTAGGを使用して、複数の値を1つのセルおよび1行に連結します。

listagg(<column to concatenate> by <grouping column>)

結果の文字列が長すぎる場合はon overflow truncateを追加し、値が一意ではない場合はdistinctを追加します。

たとえば:

listagg(distinct City_ID by STATE on overflow truncate)

システム関数

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

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

時系列関数

時系列関数では、時間ディメンションに基づいてデータを集計および予測できます。たとえば、AGO関数を使用して、1年前からの収益を計算できます。

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

関数	例	説明	構文
AGO	SELECT Year_ID, AGO(sales, year, 1)	過去の指定された期間のメジャーの集計値を計算します。たとえば、1年前の月次収益を計算するには、AGO(Revenue, Year, 1, SHIP_MONTH)を使用します。前四半期の四半期収益を計算するには、AGO(Revenue, Quarter, 1)を使用します。	AGO(MEASURE, TIME_LEVEL, OFFSET) 説明: MEASUREは、計算するメジャー(たとえば、収益)を表します。 TIME_LEVELは、期間を表しており、年、四半期、月、週、または日である必要があります。 OFFSETは、さかのぼって計算する期間の数(たとえば、1年の場合は1)を表します。
PERIODROLLING	SELECT Month_ID, PERIODROLLING (monthly_sales, -1, 1)	x単位の時間から始まり、現在の時刻からy単位の時間で終わる期間のメジャーの合計を計算します。たとえば、PERIODROLLINGを使用して、現在の四半期前の四半期で始まり、現在の四半期後の四半期で終わる期間の売上を計算できます。	PERIODROLLING(measure, x [,y]) 説明: MEASUREは、メジャー列の名前を表します。 Xは、現在の時刻からのオフセットを表す整数です。 Yは、この関数が計算する時間単位の数を表す整数です。 HIERARCHYは、YR、MON、DAYなど、時間ウィンドウの計算に使用する時間ディメンション内の階層の名前を表すオプションの引数です。
TODATE	SELECT Year_ID, Month_ID, TODATE (sales, year)	期間の開始から最新の期間までのメジャーの集計値を計算します。たとえば、年度開始から現在の計算。 たとえば、過去1年間の売上を計算するには、TODATE(sales, year)を使用します。	TODATE(MEASURE, TIME_LEVEL) 説明: MEASUREは、少なくとも1つのメジャー列(たとえば、売上)を参照する式を表します。 TIME_LEVELは、期間を表しており、年、四半期、月、週、または日である必要があります。