| Oracle® Fusion Middleware Oracle CQL言語リファレンス 12cリリース(12.2.1.2.0) E82647-01 |
|
 前へ |
 次へ |
この章では、Oracle Continuous Query Language (Oracle CQL)の基本部分(データ型、リテラル、nullなど)のリファレンスを提供します。Oracle CQLは、Oracle Stream Analyticsアプリケーションで使用される問合せ言語です。
この章の内容は次のとおりです。
「Oracle CQLの使用」で説明されている文を使用する前に、この章で説明する概念を理解しておく必要があります。
Oracle Stream Analyticsによって操作される値には、それぞれデータ型があります。値のデータ型により、固定された一連のプロパティが値に関連付けられます。これらのプロパティにより、Oracle Event Processingでは、あるデータ型の値が別のデータ型の値とは異なる処理をされます。たとえば、INTEGERデータ型の値は加算できますが、CHARデータ型の値は加算できません。ストリームを作成するときは、その要素ごとにデータ型を指定する必要があります。ユーザー定義関数を作成するときは、その引数ごとにデータ型を指定する必要があります。これらのデータ型によって、各要素または各引数が含むことのできる値の範囲を定義します。たとえば、データ型としてTIMESTAMPを持つ属性は、値「2月29日」(うるう年を除く)や、値「2」または「SHOE」を保持できません。Oracle CQLでは、多くの組込みデータ型を使用できます。Oracle CQLデータ型の構文は、後続の図に記載されています。
Oracle CQLでサポートされていないデータ型をイベントで使用する場合は、Oracle CQLデータ・カートリッジまたはユーザー定義関数を使用して、Oracle CQL問合せでそのデータ型を評価できます。
詳細は、次を参照してください。
datatype::=
variable_length_datatype::=
fixed_length_datatype::=
表2-1は、Oracle CQL組込みデータ型の概要を示しています。構文要素については、前の項の構文を参照してください。
イベント・タイプを定義するときは、これらのデータ型およびデータ型リテラルの制限を検討します。
表2-1 Oracle CQL組込みデータ型の概要
| Oracle CQLデータ型 | 説明 |
|---|---|
|
Java 詳細は、「数値リテラル」を参照してください。 |
|
Java |
|
長さが 詳細は、「数値リテラル」を参照してください。 |
Oracle CQLでは1次元配列のみをサポートしています。 |
長さが 詳細は、「テキスト・リテラル」を参照してください。 |
|
Java 詳細は、「数値リテラル」を参照してください。 |
|
Java 詳細は、「数値リテラル」を参照してください。 |
|
Java 詳細は、「数値リテラル」を参照してください。 |
|
固定長の 詳細は、「期間リテラル」を参照してください。 |
|
固定長の 詳細は、「日時リテラル」を参照してください。 |
|
このデータ型は、XMLデータを含むストリーム要素に使用します。最大長は4096文字です。
詳細は、「SQL/XML (SQLX)」を参照してください。 |
|
任意のJavaオブジェクト(つまり、 Oracle Event Processingエンジンでは 通常、この型はアダプタから宛先に値をそのまま渡す場合に使用します。Oracle Event Processingエンジンではこれらの値を解釈する必要はありませんが( |
Oracle CQLでサポートされていないデータ型をイベントで使用する場合は、Oracle CQLデータ・カートリッジを使用して、Oracle CQL問合せでそのデータ型を評価できます。
Oracle CQLでサポートされていないデータ型をイベントで使用する場合は、ユーザー定義関数を作成して、Oracle CQL問合せでそのデータ型を評価できます。
package com.oracle.app;
public enum ProcessStatus {
OPEN(1),
CLOSED(0)}
}
package com.oracle.app;
import com.oracle.capp.ProcessStatus;
public class ServiceOrder {
private String serviceOrderId;
private String electronicSerialNumber;
private ProcessStatus status;
...
}
package com.oracle.app;
import com.oracle.capp.ProcessStatus;
public class CheckIfStatusClosed {
public boolean execute(Object[] args) {
ProcessStatus arg0 = (ProcessStatus)args[0];
if (arg0 == ProcessStatus.OPEN)
return Boolean.FALSE;
else
return Boolean.TRUE;
}
}
<wlevs:processor id="testProcessor"> <wlevs:listener ref="providerCache"/> <wlevs:listener ref="outputCache"/> <wlevs:cache-source ref="testCache"/> <wlevs:function function-name="statusClosed" exec-method="execute" /> <bean class="com.oracle.app.CheckIfStatusClosed"/> </wlevs:function> </wlevs:processor>
<query id="rule-04"><![CDATA[ SELECT meter.electronicSerialNumber, meter.exceptionKind FROM MeterLogEvent AS meter, ServiceOrder AS svco WHERE meter.electronicSerialNumber = svco.electronicSerialNumber and svco.serviceOrderId IS NULL OR statusClosed(svco.status) ]]></query>
詳細は、「ユーザー定義」を参照してください。
この項では、Oracle Stream Analyticsでの各データ型の値の比較方法について説明します。
後の日付は前の日付よりも大きいと見なされます。たとえば、'29-MAR-2005'に等しい日付は'05-JAN-2006'に等しい日付より小さく、'05-JAN-2006 1:35pm'は'05-JAN-2005 10:09am'より大きくなります。
Oracle CQLでは辞書順に基づいた辞書的ソートがサポートされています。
内部的には、Oracle CQLではcharの数値が比較されます。使用するエンコーディングに応じて数値は異なりますが、通常は、比較する際に違いはありません。次に例を示します。
'a' < 'b' 'aa' < 'ab' 'aaaa' < 'aaaab'
通常、式では異なるデータ型の値を使用できません。たとえば、算術式で5 × 10の乗算の後に'JAMES'を加算することはできません。ただし、Oracle Stream Analyticsでは、あるデータ型から別のデータ型への暗黙的および明示的な値の変換がサポートされています。
暗黙的または自動的な変換に依存するかわりに、Oracleでは明示的な変換の指定をお薦めします。これは、次の理由によります。
明示的なデータ型変換関数を使用すると、Oracle CQL文が読みやすくなります。
暗黙的なデータ型変換はパフォーマンスに悪影響を及ぼす可能性があります。
暗黙的な変換はその変換が行われるコンテキストに依存し、どんな場合でも同様に機能するとはかぎりません。
暗黙的な変換のアルゴリズムはソフトウェア・リリース間やOracle製品間で変更される場合があります。明示的な変更では、動作がより安定しています。
この項の内容は、次のとおりです。
Oracle Stream Analyticsでは、変換が合理的な場合に、あるデータ型から別のデータ型に値が自動的に変換されます。
表2-2は、Oracleの暗黙的な変換を示しています。この表は、使用可能なすべての変換を示しています(Xマークが付けられています)。サポートされていない変換には--マークが付けられています。
|
表2-2 暗黙的な型変換のマトリックス
|
次の規則は、Oracle Stream Analyticsで暗黙的なデータ型変換が行われる方向を決定します。
SELECT FROM操作で、Select句に算術式または条件の評価が含まれている場合は、Oracle Stream Analyticsによりストリームのデータがターゲット変数の型に変換されます。
たとえば、c1+2.0などの式評価やc1 < 2.0などの条件評価のコンテキストでc1がINTEGER型である場合に、暗黙的な変換が発生します。
FLOATからBIGINTへの変換は正確です。
BIGINT値が使用する精度のビット数がFLOATでサポートされる数を超えている場合、BIGINTからFLOATへの変換は正確ではありません。
文字値とTIMESTAMP値を比較する場合は、Oracle Stream Analyticsにより文字データがTIMESTAMPに変換されます。
Oracle CQL関数または演算子で許可されていないデータ型の引数を使用すると、Oracle Stream Analyticsではサポートされている場合は必ず、引数が使用可能なデータ型に変換されます。
代入時、Oracle Stream Analyticsでは等号(=)の右側の値が、左側の代入対象のデータ型に変換されます。
連結操作時、Oracle Stream Analyticsでは文字以外のデータ型がCHARに変換されます。
文字データ型と文字以外のデータ型の間で算術演算または比較を行う場合、Oracle Stream Analyticsでは数値型がCHARに変換されます(表2-2を参照)。
Oracle CQL変換関数を使用して、明示的にデータ型の変換を指定できます。表2-3は、あるデータ型から別のデータ型に値を明示的に変換するOracle CQL関数を示しています。サポートされていない変換には--マークが付けられています。
表2-3 明示的な型変換のマトリックス
| 変換前/変換後 | CHAR | BYTE | BOOLEAN | INTEGER | DOUBLE | BIGINT | FLOAT | TIMESTAMP | INTERVAL |
|---|---|---|---|---|---|---|---|---|---|
CHARから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
||
BYTEから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
|
BOOLEANから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
INTEGERから |
-- |
-- |
-- |
-- |
|||||
DOUBLEから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
|
LONGから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
|
BIGINTから |
-- |
-- |
-- |
-- |
-- |
||||
FLOATから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
||
TIMESTAMPから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
|
INTERVALから |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
-- |
.
Oracle CQLプロセッサを使用すると、リレーショナル・データベース表をイベント・ソースとして指定できます。このイベント・ソースで問合せを実行したり、他のイベント・ソースと結合したりできます。その際は、Oracle Stream Analyticsがサポートするのと等価のSQLおよびOracle Stream Analyticsデータ型を順守する必要があります。
詳細は、「リレーショナル・データベース表の問合せ」を参照してください。
実行時、Oracle Stream Analyticsではデータ・カートリッジの実装に応じて、Oracle CQLとデータ・カートリッジのデータ型との間でマッピングが行われます。
実行時、Oracle Stream Analyticsではユーザー定義関数の戻り値の型に指定したOracle CQLデータ型とJavaの同等のデータ型との間でマッピングが行われます。
詳細は、「ユーザー定義関数のデータ型」を参照してください。
「リテラル」と「定数値」という用語は同義語であり、固定されたデータ値を表します。たとえば、'JACK'、'BLUE ISLAND'および'101'はすべてテキスト・リテラルであり、5001は数値リテラルです。
Oracle Stream Analyticsでは、Oracle CQL文の次の種類のリテラルがサポートされています。
このリファレンスの他の部分で説明している式、条件、Oracle CQL関数およびOracle CQL文の構文でconst_string、quoted_string_double_quotesまたはquoted_string_single_quotesと示されている箇所では常にテキスト・リテラルの表記で値を指定します。このマニュアルでは、 テキスト・リテラル、文字リテラルおよび文字列は同じ用語として使用しています。
テキスト・リテラルは、Oracle Stream Analyticsでスキーマ・オブジェクト名と区別されるように、一重引用符または二重引用符で囲みます。
一重引用符(')または二重引用符(")を使用できます。通常は、二重引用符を使用します。ただし、特定の式、条件、関数および文では、このリファレンスの他の部分で指定されている構文に従って、quoted_string_double_quotesまたはquoted_string_single_quotesのいずれかの引用符を使用する必要があります。
構文で単にconst_stringと示されている場合は、一重引用符または二重引用符のどちらでも使用できます。
構文でcharという用語が示されている場合は、テキスト・リテラルを指定するか、または文字データに解決される別の式を指定できます。構文にcharがある場合、一重引用符で囲む必要はありません。
Oracle Stream Analyticsは、Javaのローカリゼーションをサポートしています。Javaロケールで指定された文字セットのテキスト・リテラルを指定できます。
詳細は、次を参照してください。
固定長の数値または浮動小数点数値を指定する場合は、数値リテラルの表記を使用します。
このリファレンスの他の部分で説明している式、条件、Oracle CQL関数、およびOracle CQL文でintegerと示されている箇所では常に整数表記を使用して整数を指定する必要があります。
integerの構文は次のとおりです。
integer::=
digitは0、1、2、3、4、5、6、7、8、9のいずれかです。
整数は最大32桁の精度を格納できます。
次に、有効な整数を示します。
7 +255
このリファレンスの他の部分で説明している式、条件、Oracle CQL関数およびOracle CQL文でnumberまたはnと示されている箇所では、常に数または浮動小数点数の表記を使用して値を指定する必要があります。
numberの構文は次のとおりです。
number::=
説明:
+は正、-は負の値を示します。符号を省略すると、デフォルトで正の値になります。
digitは0、1、2、3、4、5、6、7、8、9のいずれかです。
fまたはFは数値がFLOAT型の32ビット・バイナリ浮動小数点数であることを示します。
dまたはDは、数値がDOUBLE型の64ビット・バイナリ浮動小数点数であることを示します。pcbpel/cep/src/oracle/cep/common/Constants.BIGINT_LENGTH
fまたはFおよびdまたはDを省略すると、数値は型INTEGERになります。
接尾辞fまたはFおよびdまたはDは浮動小数点数リテラルでのみサポートされ、INTEGERに変換される文字列ではサポートされていません。たとえば、Oracle Stream AnalyticsでINTEGERが所定の型である場合に文字列'9'が検出されると、文字列はJava Integer 9に変換されます。ただし、Oracle Stream Analyticsで文字列'9f'が検出された場合は、変換が失敗しエラーが返されます。
INTEGER型の数は最大32桁の精度を格納できます。BIGINTまたはFLOATで提供される精度よりも高い精度がリテラルで必要な場合、Oracle Stream Analyticsでは値が切り詰められます。リテラルの範囲がBIGINTまたはFLOATでサポートされる範囲を超えた場合、Oracle Stream Analyticsではエラーが発生します。
Javaロケールでピリオド(.)以外の小数点を使用している場合は、'text'表記を使用して数値リテラルを指定する必要があります。この場合、Oracle Stream Analyticsが自動的にテキスト・リテラルを数値に変換します。
注意:
この表記は、浮動小数点数リテラルでは使用できません。
たとえば、Javaロケールでカンマ(,)の小数点が指定されている場合は、次のように数値5.123を指定します。
'5,123'
次に、有効なNUMBERリテラルを示します。
25 +6.34 0.5 -1
次に、有効な浮動小数点数リテラルを示します。
25f +6.34F 0.5d -1D
Oracle Stream Analyticsでは、日時データ型TIMESTAMPがサポートされています。
日時リテラルは64バイトを超えることはできません。
すべての日時リテラルは、Oracle CQLでサポートされるjava.text.SimpleDateFormat書式モデルのいずれかに準拠している必要があります。詳細は、「日時書式モデル」を参照してください。
現在、SimpleDateFormatクラスではxsd:dateTimeがサポートされていません。このため、Oracle CQLではこの型を使用するXML要素または属性がサポートされていません。
たとえば、XMLイベントがXSDを使用する場合、Oracle CQLではMyTimestamp要素を解析できません。
<xsd:element name="ComplexTypeBody">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="MyTimestamp" type="xsd:dateTime"/>
<xsd:element name="ElementKind" type="xsd:string"/>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="node" type="SimpleType"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
XSDを定義してxsd:dateTimeをxsd:stringで置き換えることをお薦めします。
<xsd:element name="ComplexTypeBody">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="MyTimestamp" type="xsd:string"/>
<xsd:element name="ElementKind" type="xsd:string"/>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="node" type="SimpleType"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
XSDを使用すると、Oracle CQLでは、Timestamp要素のString値がOracle CQLでサポートされるjava.text.SimpleDateFormat書式モデルに準拠しているかぎりイベントを処理できます。詳細は、「日時書式モデル」を参照してください。
<ComplexTypeBody xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ...> <MyTimestamp>2000-01-15T00:00:00</MyTimestamp> <ElementKind>plus</ElementKind> <name>complexEvent</name> <node> <type>complexNode</type> <number>1</number> </node> </ComplexTypeBody>
Oracle CQLでのXMLの使用の詳細は、「SQL/XML (SQLX)」を参照してください。
期間リテラルは期間を指定します。Oracle Stream Analyticsでは、期間リテラルDAY TO SECONDがサポートされています。このリテラルには先頭フィールドが含まれ、末尾フィールドを含めることができます。先頭フィールドは、測定する日付または時間の基本単位を定義します。末尾フィールドは、該当する基本単位の最小の増分を定義します。部分範囲(SECONDやMINUTE to SECONDなど)はサポートされていません。
期間リテラルは64バイトを超えることはできません。
pcbpel/cep/src/oracle/cep/common/Constants.BIGINT_LENGTH
日、時、分および秒の単位で時間が格納されます。
次の構文を使用して、DAY TO SECOND期間リテラルを指定します。
interval_value::=
const_stringは、適切な日時書式モデルに準拠するTIMESTAMP値です(「日時書式モデル」を参照)。
先行フィールドに対する制限:
後続のフィールドを指定する場合、先行のフィールドよりも下位の単位を指定する必要があります。たとえば、INTERVAL MINUTE TO DAYは無効です。このため、SECONDが先行フィールドの場合、期間リテラルは後続フィールドを持つことができません。
後続フィールドの有効範囲は次のとおりです。
SECOND: 0から59.999999999
INTERVAL DAY TO SECONDリテラルの書式の例を示します。
| 期間リテラルの形式 | 解釈 |
|---|---|
|
4日、5時間、12分、10秒、222ミリ秒。 |
あるDAY TO SECOND期間リテラルを別のDAY TO SECONDリテラルと加算または減算したり、期間リテラルを比較したりできます。この例で、ストリームtkdata2_SIn1のスキーマは(c1 integer, c2 interval)です。
<query id="tkdata2_q295"><![CDATA select * from tkdata2_SIn1 where (c2 + INTERVAL "2 1:03:45.10" DAY TO SECOND) > INTERVAL "6 12:23:45.10" DAY TO SECOND ]]></query>
パターン一致のDEFINE句でのINTERVAL DAY TO SECONDの使用:
query 'select its.itemId from ch0 MATCH_RECOGNIZE ( PARTITION BY itemId MEASURES A.itemId as itemId PATTERN (A B* C) DEFINE A AS (A.temp >= 25), B AS ((B.temp >= 25) and (to_timestamp(B.element_time) - to_timestamp(A.element_time) < INTERVAL "00:00:05.00" HOUR TO SECOND)), C AS (to_timestamp(C.element_time) - to_timestamp(A.element_time) >= INTERVAL "00:05.00" MINUTE TO SECOND) ) as its'
入力:
send [itemId=2 temp=30] send [itemId=2 temp=55] thread:sleep 5000 send [itemId=2 temp=125]
出力:
-> insert event: {itemId=2}
時間を年および月の単位で格納します。
INTERVALYEARTOMONTHリテラルの書式の例を示します。
| 期間リテラルの形式 | 解釈 |
|---|---|
|
12年10か月 |
注意:
問合せのDDLで使用する場合、CQL問合せで定数を指定するにはINTERVAL YEAR TO MONTH通知を使用します。変数のかわりに、定数の間隔値を指定します。
次に示すコード・サンプルでは、次にリストするタプルを使用しています。
<event-type type-name="IntervalInputTupleEvent"> <properties> <property name="interval_inputevent" type="interval year to month"/> </properties> </event-type> <event-type type-name="IntervalOutputTupleEvent"> <properties> <property name="interval_outputevent" type="interval year to month"/> </properties> </event-type>
次に示すのは、INTERVAL YEARS TO MONTHのサンプル問合せです。
問合せ:
select interval_inputevent as interval_outputevent from inputChannel
入力:
send [interval_inputevent='INTERVAL "212-10" YEAR(3) TO MONTH']
出力:
-> insert event: {interval_outputevent=+212-10}
書式モデルは、格納された日時または数値データの書式を文字列で記述する文字リテラルです。文字列を日付または数値に変換する場合、Oracle Stream Analyticsでの文字列の解釈のしかたは書式モデルによって決まります。Oracle CQL問合せに関連する次の書式モデルがあります。
次の関数で、数値書式モデルを使用できます。
関数でintデータ型の値をbigintデータ型に変換します。
to_float関数でintまたはbigintデータ型の値をfloatデータ型に変換します。
Oracle CQLではjava.text.SimpleDateFormatが指定する書式モデルがサポートされています。
表2-4は、Oracle CQLがTIMESTAMPリテラルの解釈に使用するjava.text.SimpleDateFormatモデルを示しています。詳細は、「日時リテラル」を参照してください。
表2-4 日時書式モデル
| 書式モデル | 例 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
次の関数で、日時書式モデルを使用できます。
to_timestamp: charデータ型の値をTIMESTAMPデータ型に変換します。
行のある列の値がない場合、その列はNULLである、またはNULLを含むといいます。主キー整合性制約によって制限されていない任意のデータ型のタプルでは、nullが含まれている場合があります。実際のデータ値が不定または値に意味がない場合に、NULLを使用してください。
SQLとは異なり、Oracle Stream Analyticsは、長さがゼロの文字値をそのまま扱います。ただし、数値0を表すのにnullを使用しないでください。この2つは等価ではありません。
nullを含む算術式は常にnullに評価されます。たとえば、10にnullを加算したものはnullです。実際、nullオペランドを指定すると、すべての演算子ではnullが返されます(連結を除く)。
詳細は、次を参照してください。
null引数を指定すると、すべてのスカラ関数ではnullが返されます(nvlとconcatを除く)。nvl関数を使用すると、nullが発生した場合に値を返すことができます。たとえば、式NVL(commission_pct,0)は、commission_pctがnullの場合に0を返し、nullでない場合にcommission_pctの値を返します。
ほとんどの集計関数ではnullが無視されます。たとえば、1000、null、null、nullおよび2000の5つの値を平均する問合せがあるとします。このような問合せではnullが無視され、平均は(1000+2000)/2 = 1500のように計算されます。
nullをテストするには、null比較条件のみを使用します(「null_conditions::=」を参照)。それ以外の条件をnullで使用すると、結果がnull値に依存し、結果がUNKNOWNになります。NULLはデータの欠落を表すため、任意の値や別のNULLとの関係で等号や不等号は成り立ちません。ただしOracle Stream Analyticsは、デコード式を評価するとき、2つのnullを等しいものとして扱います。構文と追加情報については、decode::=を参照してください。
UNKNOWNに評価される条件はFALSEとほぼ同様に動作します。たとえば、条件のWHERE句がUNKNOWNに評価されるSELECT文ではタプルが返されません。ただし、UNKNOWNに評価される条件は、UNKNOWN条件の評価でさらに操作を行う場合はUNKNOWNに評価されるのでFALSEとは異なります。このため、NOT FALSEはTRUEに評価されますが、NOT UNKNOWNはUNKNOWNに評価されます。
表2-5は、条件でnullを使用する場合の様々な評価の例を示しています。SELECT文のWHERE句でUNKNOWNに評価される条件を使用する場合、問合せで返される行はありません。
|
表2-5 Nullを使用する条件
|
詳細は、「Null条件」を参照してください。
Oracle CQLでは、問合せを簡易化してわかりやすくするために、別名(またはシノニム)を定義できます。
この項の内容は、次のとおりです。
AS演算子を使用すると、Oracle CQLで問合せ、リレーション、ストリームおよび問合せのSELECTリスト項目の別名を指定できます。
この項の内容は、次のとおりです。
詳細は、「Oracle CQLの問合せ、ビューおよび結合」を参照してください。
relation_variable句のAS演算子で別名を定義して選択リストの直前の式にラベルを付け、その名前で結果を参照できます。別名によって、問合せ中にSELECT構文のリストの項目名を効果的に変更できます。別名は、ORDER BY句(「問合せ結果のソート」を参照)で使用できますが、問合せの他の句では使用できません。
次の例は、SELECTリストのストリーム要素its.itemIdに対して別名badItem、MATCH_RECOGNIZE句に対して別名itsを定義する方法を示しています。
<query id="detectPerish"><![CDATA[ select its.itemId as badItem from tkrfid_ItemTempStream MATCH_RECOGNIZE ( PARTITION BY itemId MEASURES A.itemId as itemId PATTERN (A B* C) DEFINE A AS (A.temp >= 25), B AS ((B.temp >= 25) and (to_timestamp(B.element_time) - to_timestamp(A.element_time) < INTERVAL "0 00:00:05.00" DAY TO SECOND)), C AS (to_timestamp(C.element_time) - to_timestamp(A.element_time) >= INTERVAL "0 00:00:05.00" DAY TO SECOND) ) as its ]]></query>
詳細は、「From句」を参照してください。
AS演算子で別名を定義して直前のウィンドウ演算子にラベルを付け、その名前で結果を参照できます。
ウィンドウ演算子の内部ではAS演算子を使用できませんが、ウィンドウ演算子の外部ではAS演算子を使用できます。
次の例は、分割範囲のウィンドウ演算子の後で別名bidとaskを定義する方法を示しています。
<query id="Rule1"><![CDATA[ SELECT bid.id as correlationId bid.cusip as cusip max(bid.b0) as bid0 bid.srcid as bidSrcId, bid.bq0 as bid0Qty, min(ask.a0) as ask0, ask.srcid as askSrcId, ask.aq0 as ask0Qty FROM stream1[PARTITION by bid.cusip rows 100 range 4 hours] as bid, stream2[PARTITION by ask.cusip rows 100 range 4 hours] as ask GROUP BY bid.id, bid.cusip, bid.srcid,bid.bq0, ask.srcid, ask.aq0 ]]></query>
詳細は、「ストリームからリレーションへの演算子(ウィンドウ)」を参照してください。
別名はロケーションの透過性を提供するために必要です。aliases要素で別名を定義して、Oracle CQLの問合せやビューで使用できます。aliases要素は、プロセッサのコンポーネント構成ファイルで構成します。
<?xml version="1.0" encoding="UTF-8"?> <n1:config xmlns:n1="http://www.bea.com/ns/wlevs/config/application"> <processor> <name>processor1</name> <rules> <query id="q1"> <![CDATA[ select str(msg) from cqlInStream [rows 2]; ]]> </query> </rules> <aliases> <type-alias> <source>str</source> <target>java.lang.String </target> </type-alias> </aliases> </processor> </n1:config>
aliases要素の有効範囲は、aliases要素が属するプロセッサのrules要素で定義された問合せとビューです。
次の点に注意してください。
別名がすでに存在する場合、Oracle Stream Analyticsは例外をスローします。
問合せまたはビュー定義が別名を参照している場合、別名はすでに存在する必要があります。
この項の内容は、次のとおりです。
aliases要素の子要素type-aliasを使用して、データ型の別名を定義できます。任意の組込みまたはデータ・カートリッジ・データ型の別名を作成できます。
詳細は、「データ型」を参照してください。
aliases要素を使用してalias型を定義するには:
一部のスキーマ・オブジェクトは、ストリームまたはビューのストリーム要素、整合性制約、ストリーム、ビューおよびユーザー定義の関数またはユーザー定義のウィンドウなどの、ユーザーが指定できる部分または指定する必要のある部分で構成されています。この項の内容は、次のとおりです。
詳細は、「表記規則」を参照してください。
Oracle Stream Analyticsのオブジェクトは、それぞれ名前があります。Oracle CQL文では、オブジェクト名は引用符なしの識別子で表します。つまり、なんらかの記号で囲まれていない識別子を使用します。
Oracle Stream Analyticsオブジェクトの名前を指定する場合は、引用符なしの識別子を使用する必要があります。
次に、識別子に適用されるルールのリストを示します。
Oracle Stream Analyticsの予約語は、識別子として使用できません。
Oracle Stream Analyticsオブジェクトへのアクセスに使用するOracle製品によっては、製品固有の予約語により名前がさらに制限される可能性があります。
Oracle CQL言語には特殊な意味を持つ他の語が含まれています。これらの文字は予約語ではありません。ただし、Oracleは固有の方法でこれらの文字を内部的に使用します。このため、これらの語をオブジェクトやオブジェクトの各部分の名前として使用すると、Oracle CQL文が読みにくくなり、予期しない結果が生じることがあります。
詳細は、次の章を参照してください。
異なるプラットフォームまたはオペレーティング・システム間で最適な互換性が提供されるため、スキーマ・オブジェクト名にASCII文字を使用することをお薦めします。
識別子は、データベース文字セットのアルファベット文字で開始する必要があります。
識別子にはJavaロケールの文字セットの英数字とアンダースコア(_)のみを使用できます。特に、スペース、ドット、スラッシュは使用できません。
詳細は、次を参照してください。
通常、次のオブジェクトでは、アプリケーションで一意の名前を選択する必要があります。
ストリーム
問合せ
ビュー
ユーザー定義関数
特に、問合せとビューに同じ名前を付けることはできません。
識別子名では大文字と小文字が区別されます。
同一のストリームまたはビューのストリーム要素には同じ名前を使用できません。ただし、異なるストリームまたはビューのストリーム要素には同じ名前を使用できます。
関数の引数の個数およびデータ型が異なる(つまり、シグネチャが固有である)場合は、関数に同じ名前を使用できます。引数の異なる同名の関数を複数作成することは、関数のオーバーロードと呼ばれます。
組込み関数と同じ名前とシグネチャを持つユーザー定義関数を登録または作成すると、ユーザー関数が組込み関数のシグネチャに取ってかわります。組込み関数と同じ名前とシグネチャを持つ関数を作成することは、関数のオーバーライドと呼ばれます。
組込み関数はパブリックですが、ユーザー定義関数は特定のスキーマに属しています。
詳細は、次を参照してください。
次に、オブジェクトおよび各部分に名前を付ける場合のガイドラインを示します。
完全な、わかりやすい、発音可能な名前(またはよく知られた略語)を使用します。
一貫性のあるネーミング・ルールを使用します。
ストリーム、ビュー、および問合せ間で同一のエンティティまたは属性を記述するには、同じ名前を使用します。
オブジェクトに名前を付ける場合、名前を短くして使いやすくするという目的と、名前をできるかぎり説明的にするという目的を両立させてください。Oracle Stream Analyticsのオブジェクトは長期間にわたり多くのユーザーによって使用される可能性があるため、確信が持てない場合はより説明的な名前を選択してください。10年後のユーザーは、payment_due_dateではなくpmddという名前を持つストリーム要素の理解に苦しむ可能性があります。
一貫性のあるネーミング・ルールを使用すると、アプリケーションでの各ストリームの役割が理解しやすくなります。このようなルールとして、FINANCEアプリケーションに属するすべてのストリーム名をfin_で開始するなどがあります。
ストリーム間で同一の項目を記述するには、同じ名前を使用します。たとえば、employeesおよびdepartmentsストリームでは、どちらも部門番号のストリーム要素にdepartment_idという名前を付けます。
次に、有効なスキーマ・オブジェクト名の例を示します。
last_name horse a_very_long_and_valid_name
これらのすべての例は、「スキーマ・オブジェクトのネーミング・ルール」のルールに従っています。
