4 式ビルダー関数の理解
式ビルダーは、様々な既存の関数を使用して式を作成できるエディタです。式は、パイプラインの必要な結果を取得する際に役立ちます。
トピック:
ベッセル関数とは
整数に対する数学的円柱関数は、ベッセル関数と呼ばれます。
関数名 | 説明 |
---|---|
|
doubleの引数の階数0の変更済のベッセル関数をdoubleとして返します |
|
doubleの引数の階数0の指数スケールが適用された変更済のベッセル関数をdoubleとして返します |
|
doubleの引数の階数1の変更済のベッセル関数をdoubleとして返します |
|
doubleの引数の階数1の指数スケールが適用された変更済のベッセル関数をdoubleとして返します |
|
引数の階数nの第1種ベッセル関数をdoubleとして返します |
|
引数の階数nの変更済の第3種ベッセル関数をdoubleとして返します |
|
doubleの引数の階数0の指数スケールが適用された変更済の第3種ベッセル関数をdoubleとして返します |
|
doubleの引数の階数1の指数スケールが適用された変更済の第3種ベッセル関数をdoubleとして返します |
|
doubleの引数の階数nの第2種ベッセル関数をdoubleとして返します |
変換関数とは
変換関数は、あるデータ型から他のデータ型に値を変換する際に役立ちます。
このリリースでは、次の変換関数がサポートされます。
関数名 | 説明 |
---|---|
|
指定された値をbigdecimalに変換します |
|
指定された値をlogicalに変換します |
|
指定された値をdatetimeに変換します |
|
指定された値をdoubleに変換します |
|
指定された値をfloatに変換します |
|
指定された値をintegerに変換します |
|
指定された値をlongに変換します |
|
指定された値をstringに変換します |
boolean(value1)
入力引数の値をlogicalに変換します。入力引数には、データ型big integerまたはintegerのいずれかを指定できます。戻り値の型は、Booleanになります。
例
関数 | 結果 |
---|---|
|
TRUE |
|
FALSE |
|
TRUE |
|
TRUE |
|
TRUE |
日付関数とは
このリリースでは、次の日付関数がサポートされます。
関数名 | 説明 |
---|---|
|
日付の曜日を返します |
|
ストリームからイベント・タイムスタンプを返します |
|
日付の時間を返します |
|
日付の分を返します |
|
日付の月を返します |
|
日付のナノ秒を返します |
|
日付の秒を返します |
|
アプリケーションが実行されているシステムのタイムスタンプを返します |
|
指定されたタイムスタンプを適切な時間フォーマットで返します |
|
現在の出力時間を返します |
|
日付の年を返します |
タイムスタンプ値の許容可能なフォーマット
この項では、Oracle Stream Analyticsのタイムスタンプ値の許容可能なフォーマットを示します。
フォーマット | サンプル値 |
---|---|
|
3/21/2018 11:14:23.1111 |
|
3/21/2018 11:14:23.111 |
|
3/21/2018 11:14:23.11 |
|
3/21/2018 11:14:23.1 |
|
3/21/2018 11:14:23 |
|
3/21/2018 11:14 |
|
3/21/2018 11 |
|
3/21/2018 |
|
11-21-2018 11:14:23.1111 |
|
11-21-2018 11:14:23.111 |
|
11-21-2018 11:14:23.11 |
|
11-21-2018 11:14:23.1 |
|
11-21-2018 11:14:23 |
|
11-21-2018 11:14 |
|
11-21-2018 11 |
|
11-21-2018 |
|
11-Jan-18 11.14.23.111111 AM |
|
11-Jan-18 11.14.23.1111 |
|
11-Jan-18 11.14.23.111 |
|
11-Jan-18 11.14.23.11 |
|
11-Jan-18 11.14.23.1 |
|
11-Jan-18 11.14.23 |
|
11-Jan-18 11.14 |
|
11-Jan-18 11 |
|
11-Jan-18 |
|
15/MAR/18 |
|
2018-03-5 15:16:0.756000 +5:30, 2018-03-5 15:16:0.756000 |
|
2018-03-5 15.16.0.756000 +5:30, 2018-03-5 15.16.0.756000 |
|
2018-03-5 15:16:0; 2018-03-5 15:16:0 +5:30 |
|
2018-03-5 15.16.0; 2018-03-5 15.16.0 +5:30 |
|
2018-03-5 15:16; 2018-03-5 15:16 +5:30 |
|
2018-03-5 15.16; 2018-03-5 15.16 +5:30 |
|
2018-03-5 15 |
|
2018-03-5 |
|
11:14:14 PST |
|
2018-03-04T12:08:56.235 |
|
2018-03-04T12:08:56.235-0700 |
|
2018-03-04T12:08:56.235 PDT |
|
2018-03-04T12:08:56 |
|
2018-03-04T12:08:56-0700 |
|
2018-03-04T12:08:56 PDT |
Day(date)
day(date)
関数は、データ型time intervalまたはtimestampのいずれかを引数として使用します。戻り値は、この日付オブジェクトによって表される日時の曜日を示します。この日付によって表される曜日を示す大整数を返します。
例
日曜=0、月曜=1のように続く場合、次のようになります。
関数 | 結果 |
---|---|
|
3 |
|
4 |
hour(date)
hour(date)
関数は、データ型time intervalまたはtimestampのいずれかを引数として使用します。戻り値は、この日付オブジェクトによって表される日時の時間を示します。この日付によって表される日時の時間を示す大整数を返します。
例
関数 | 結果 |
---|---|
|
09 |
|
12 |
minute(date)
minute(date)
関数は、データ型time intervalまたはtimestampのいずれかを引数として使用します。戻り値は、この日付オブジェクトによって表される日時の分を示します。この日付によって表される日時の分を示す大整数を返します。
例
関数 | 結果 |
---|---|
|
15 |
|
45 |
month(date)
month(date)
関数は、データ型time intervalまたはtimestampのいずれかを引数として使用します。戻り値は、この日付オブジェクトによって表される日時のその時点を含むかその時点から始まる年の月を示します。この日付によって表される年の月を示す大整数を返します。
例
関数 | 結果 |
---|---|
|
12 |
|
9 |
ジオメトリ関数とは
ジオメトリ関数により、指定された値を幾何学的形状に変換できます。
このリリースでは、次の間隔関数がサポートされます。
関数名 | 説明 |
---|---|
|
指定された緯度と経度から2次元ポイント・タイプ・ジオメトリを返します。デフォルトのSRIDは、8307です。 戻り値のデータ型は、 |
|
第1セットの緯度、経度の値と、第2セットの緯度、経度の値の間の距離を返します。デフォルトのSRIDは、8307です。 戻り値のデータ型は、 |
間隔関数とは
間隔関数は、指定された値から時間間隔を計算する際に役立ちます。
このリリースでは、次の間隔関数がサポートされます。
関数名 | 説明 |
---|---|
|
指定された値を 戻り値のデータ型は、 |
|
フォーマット 戻り値のデータ型は、 |
数学関数とは
数学関数により、単純なものから複雑なものまで様々な数学的操作および計算を実行できます。
このリリースでは、次の数学関数がサポートされます。
関数名 | 説明 |
---|---|
|
IEEE 754標準に従って、2個の引数について剰余を計算します |
|
数値の絶対値を返します |
|
値のアーク・コサインを返します |
|
値のアーク・サインを返します |
|
値のアーク・タンジェントを返します |
|
点( |
|
指定された指数だけ累乗された基数の二項係数を返します |
|
ビットセット(From, To)付きのビットマスク |
|
指定された値の立方根を返します |
|
上限に丸めます |
|
2番目の浮動小数点引数の符号を付けた、最初の浮動小数点引数を返します |
|
値のコサインを返します |
|
値のコサイン双曲線を返します |
|
値の指数を返します |
|
|
|
自然数の階乗を返します |
|
下限に丸めます |
|
doubleの表現で使用されている、バイアスなしの指数を返します |
|
あらかじめ定義されているシードの(外見上は膨大な)マトリックスから決定論的なシードをintegerとして返します |
|
指定されたdoubleの値に対してintegerのハッシュコードを返します |
|
2つの引数の平方の合計の平方根を返します |
|
このUUIDの128ビット値の最下位64ビットを返します |
|
指定された底に対する指定された引数の対数値を計算します( |
|
数値の自然対数を返します |
|
指定された引数の10を底とする対数値を計算します |
|
指定された引数の2を底とする対数値を計算します |
|
integerの引数の階乗の自然対数(底はe)をdoubleとして返します |
|
integerの引数(範囲はk >= 0 && k < 21)の階乗をlongとして返します |
|
2つの引数の最大値を返します |
|
2つの引数の最小値を返します |
|
数値のモジュロを返します |
|
このUUIDの128ビット値の最上位64ビットを返します |
|
2番目の引数の方向で、最初の引数に隣接する浮動小数点値を返します |
|
負の無限大方向で入力引数に隣接する浮動小数点値を返します |
|
正の無限大方向で入力引数に隣接する浮動小数点値を返します |
|
mのn乗を返します |
|
引数の値にもっとも近く、計算上の整数に等しいdouble値を返します |
|
最も近い整数値に丸めます |
|
double値セットのメンバーに単一の正しく丸められた浮動小数点を掛けることによって実行される場合と同様に、d×2scaleFactorを丸めて返します |
|
引数の符号をdouble値として返します |
|
値のサインを返します |
|
値のサイン双曲線を返します |
|
値の平方根を返します |
|
integerの引数の階乗の自然対数(底はe)におけるスターリングの近似の補正項をdoubleとして返します |
|
値のタンジェントを返します |
|
値のタンジェント双曲線を返します |
|
引数の値を角度(度)に変換します |
|
角度(ラジアン)の測定値を返します |
|
引数のulpのサイズを返します |
maximum(value1, value2)
2つの引数の最大値を返します。第1引数は、第2引数の値と比較する値であり、データ型big integer、double、interval、integer、floatのいずれかを使用できます。第2引数は、第1引数の値と比較する値であり、データ型big integer、double、interval、integer、floatのいずれかを使用できます。
例
関数 | 結果 |
---|---|
|
1999220 |
|
135.50 |
注意:
ユーザーが入力引数として2つの異なるデータ型を指定すると、Stream Analyticsによって、一方の引数が他方の引数の型に暗黙的に変換されます。minimum(value1, value2)
2つの引数の最小値を返します。第1引数は、第2引数の値と比較する値であり、データ型big integer、double、interval、integer、floatのいずれかを使用できます。第2引数は、第1引数の値と比較する値であり、データ型big integer、double、interval、integer、floatのいずれかを使用できます。
例
関数 | 結果 |
---|---|
|
16321 |
|
3.10 |
注意:
ユーザーが引数として2つの異なるデータ型を指定すると、Stream Analyticsによって、一方の引数が他方の引数の型に暗黙的に変換されます。round(value1)
引数の値を最も近い整数値に丸めます。入力引数には、データ型big integer、double、integer、floatのいずれかを指定できます。
例
関数 | 結果 |
---|---|
|
7 |
|
39 |
|
4 |
統計関数とは
統計関数は、様々な値の統計を計算する際に役立ちます。
このリリースでは、次の統計関数がサポートされます。
関数名 | 説明 |
---|---|
|
ベータ密度関数の下の0から |
|
ベータ密度関数の右側末尾( |
|
二項確率密度の項0から |
|
二項確率密度の項 |
|
自由度が |
|
自由度が |
|
正規分布の誤差関数を返します |
|
正規分布の相補誤差関数を返します |
|
引数のガンマ関数を返します |
|
ガンマ確率密度関数の |
|
0から |
|
不完全ガンマ関数を返します |
|
相補不完全ガンマ関数を返します |
|
ガンマ関数の自然対数を返します |
|
負の二項分布の項0から |
|
負の二項分布の項 |
|
負の無限大から |
|
正規(ガウス)確率密度関数の下の領域が引数 |
|
ポアソン分布の最初の |
|
ポアソン分布の項 |
|
自由度が |
|
スチューデントtの確率密度関数の下の領域が |
文字列関数とは
このリリースでは、次の文字列関数がサポートされます。
関数名 | 説明 |
---|---|
|
リストにある最初のNULL以外の式を返します。すべての式がNULLに評価された場合、COALESCE関数はNULLを返します |
|
文字列に変換された値を連結して返します |
|
|
|
指定されたテキスト式の各語の先頭を大文字、それ以外を小文字として返します |
|
指定された文字列の長さを返します |
|
一致するパターンを返します |
|
指定された文字列を小文字に変換します |
|
文字列の左側を一連の特定の文字で埋めます( |
|
文字列の左側から、指定されたすべての文字を削除します |
|
|
|
文字列の右側を一連の特定の文字で埋めます( |
|
文字列の右側から、指定されたすべての文字を削除します |
|
索引が文字列の'from' (包含)から末尾までの間にある場合、'string'の部分文字列を返します |
|
索引が\'from\' (包含)から\'to\' (除外)までの間にある場合、\'string\'の部分文字列を返します |
|
文字列内の一連の文字を、別の文字のセットで置き換えます。ただし、一度に1つの文字のみを置き換えます。 |
|
指定された文字列を大文字に変換します |
coalesce(value1,... )
coalesce
は、式のリストにある最初のNULL以外の式を返します。2つ以上の式を指定する必要があります。すべての式がNULLに評価された場合、coalesce
関数はNULLを返します。
次に例を示します。
coalesce(expr1,expr2)
の場合:
-
expr1
がNULL以外の場合、この関数はexpr1
を返します。 -
expr1
がNULLの場合、この関数はexpr2
を返します。 -
expr1
およびexpr2
がNULLの場合、この関数はNULLを返します。
coalesce(expr1,expr2,......,exprn)
の場合
-
expr1
がNULL以外の場合、この関数はexpr1
を返します。 -
expr1
がNULLの場合、この関数はexpr2
を返します。 -
expr1
およびexpr2
がNULLの場合、この関数は次のNULL以外の式を返します。
length(value1)
入力引数として渡された文字列の文字数を返します。入力引数のデータ型は、textです。戻り値は、文字列の合計長を表す整数です。
value1がNULLの場合、length(value1)
はNULLを返します。
value1が空の文字列の場合、length(value1)
はNULLを返します。
例
関数 | 結果 |
---|---|
|
3 |
|
エラー: 関数のパラメータが無効です。 |
|
4 |
|
NULL |
|
NULL |
|
30 |
lower(value1)
文字列をすべて小文字に変換します。入力引数のデータ型は、textです。戻り値は、指定された文字列の小文字です。
例
関数 | 結果 |
---|---|
|
product |
|
abcdef |
|
abc |
replace(string, match, replacement)
文字列内のすべてのmatch
文字をreplacement
文字に置き換えます。第1の入力引数は、string
で、そのデータ型はtextです。第2引数は、match
で、そのデータ型はtextです。第3引数は、replacement
で、そのデータ型はtextです。戻り値は、第2文字列引数(match
)が第3文字列引数(replacement
)によって置き換えられたテキストです。
文字列内にmatch
が見つからない場合、元の文字列が返されます。
例
関数 | 結果 |
---|---|
|
aabbffdd |
|
aabbffcdd |
|
aabbddee |