5 イベント記録および再生スキーマ
wlevs_eventstore_config.xsd
スキーマの要素へのリファレンスを示します。このスキーマは、Oracle Stream Analyticsイベントの記録と再生を構成するために使用するXMLファイルの背後にあります。
この章の内容は次のとおりです。
5.1 batch-size
この要素を使用すると、バッキング・ストアにライト・バックするためのストア・バッファから選択される更新数を定義できます。この要素は動的に変更できます。batch-size要素には、子要素も属性もありません。
次の例はコンポーネント構成ファイル内のbatch-size
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.2 batch-time-out
この要素を使用すると、イベント・ストアに書きこむ前にbatch-size
回のイベントを累積するために、イベント・バッファが待機する秒数を定義できます。この要素には、子要素も属性もありません。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
次の例はコンポーネント構成ファイル内のbatch-time-out
要素の使用方法を示します。
5.3 dataset-name
dataset-name
要素を使用すると、ユーザーがグループ化するデータのグループを定義できます。Oracle RDBMSベースのプロバイダの場合は、記録されたイベントを格納する表が作成されるデータベース領域またはスキーマを指定します。Oracle RDBMSベースのプロバイダを構成する場合は、この要素を指定する必要があります。
この要素には、子要素も属性もありません。
次の例は、コンポーネント構成ファイル内のdataset-name
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.4 event-type-list
event-type-list
要素を使用すると、1つ以上の記録用イベントまたはコンポーネントの再生用イベントを定義できます。この要素には、event-type子要素があり、属性はありません。
次の例は、コンポーネント構成ファイル内のevent-type-list
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.5 playback-speed
playback-speed
要素を使用すると、再生速度を正の浮動小数点数で定義できます。デフォルト値は1で、これは通常速度に相当します。2の値は、イベントが元の記録速度の倍の速度で再生されることを意味します。同様に、0.5の値は、イベントが半分の速度で再生されることを意味します。
この要素には子要素も属性もありません。
次の例はコンポーネント構成ファイル内のduration
要素の使用方法を示します。
<playback-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <time-range-offset> <start>2010-01-20T05:00:00</start> <duration>03:00:00</duration> </time-range-offset> <playback-speed>100</playback-speed> </playback-parameters>
5.6 provider-name
provider-name
要素は次の親要素で使用します。
-
netio
:provider-name
要素を使用すると基礎となるソケット実装にどのプロバイダを使用するか定義できます。有効な値は、Oracle Stream Analyticsサーバー・ファイルのnetio
の子要素provider-type
です。 -
record-parameters
:provider-name
要素を使用するとイベント・ストア・プロバイダの名前を定義できます。この要素の値は、Oracle Stream Analyticsサーバー・インスタンスのファイル内のrdbms-event-store-provider
要素のname
子要素の値に対応します。Oracle RDBMSベースのプロバイダを構成する場合は、この要素を指定する必要があります。
provider-name
要素が空白の場合、デフォルトのBerkeleyデータベース・プロバイダが使用されます。
この要素には、子要素も属性もありません。
次の例はコンポーネント構成ファイル内のprovider-name
要素の使用方法を示します。
<netio> <provider-name>providerCache</provider-name> <num-threads>1000</num-threads> </netio>
5.7 recording-session-name
recording-session-name
要素を使用すると、記録セッションにプログラムによってアクセスできるように、そのセッションの名前を指定できます。この要素には、子要素も属性もありません。
次の例は構成ファイル内のこの要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <recording-session-name>sessionname</recording-session-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> </parameter> </store-policy-parameters> <schedule-time-range> <start>2010-01-20T05:00:00</start> <end>2010-01-20T18:00:00</end> </schedule-time-range> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.8 schedule-time-range
schedule-time-range
要素を使用すると、イベントがステージに再生される期間を指定できます。再生は指定した開始時間に始まり、すべてのイベントが再生されるか、または指定した終了時間まで継続されます。repeat
がtrue
に設定されている場合、再生は指定した終了時間またはユーザーが明示的に再生を停止するまで継続します。この要素は、playback-parameters
要素にのみ適用されます。
この要素には、次の子要素があり、属性はありません。
次の例はコンポーネント構成ファイル内のschedule-time-range
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> </parameter> </store-policy-parameters> <schedule-time-range> <start>2010-01-20T05:00:00</start> <end>2010-01-20T18:00:00</end> </schedule-time-range> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.9 schedule-time-range-offset
この要素を使用するとイベントがステージに再生される期間を指定できます。再生は指定した開始時間に始まり、すべてのイベントが再生されるか、または指定した終了時間まで継続されます。repeat
がtrue
に設定されている場合、再生は指定した終了時間またはユーザーが明らかに再生を中断するまで継続します。この要素は、playback-parameters
要素にのみ適用されます。
この要素には、次の子要素があり、属性はありません。
次の例はコンポーネント構成ファイル内のschedule-time-range-offset
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <schedule-time-range-offset> <start>2010-01-20T05:00:00</start> <duration>03:00:00</duration> </schedule-time-range-offset> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.10 store-policy-parameters
store-policy-parameters
要素を使用すると、イベント・ストア・プロバイダに固有のストア・ポリシー・パラメータを1つ以上定義できます。この要素には、parameter子要素があり、属性はありません。
次の例はコンポーネント構成ファイル内のstore-policy-parameter
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.11 time-range
time-range
要素を使用すると、Oracle Stream Analyticsサーバーがイベント・ストア内のイベントに適用するフィルタを定義できます。この時間範囲内のrecord-time
を持つイベントのみがステージに再生されます。
注意:
time-range-offset
またはtime-range
のいずれかを使用します。ただし、両方を使用することはできません。
この要素には、次の子要素があり、属性はありません。
次の例はコンポーネント構成ファイル内のtime-range
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <time-range> <start>2010-01-20T05:00:00</start> <end>2010-01-20T18:00:00</end> </time-range> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>
5.12 time-range-offset
time-range-offset
要素を使用すると、Oracle Stream Analyticsサーバーがイベント・ストア内のイベントに適用するフィルタを定義できます。この時間範囲内のrecord-time
を持つイベントのみがステージに再生されます。
注意:
time-range
またはtime-range-offset
のいずれかを使用します。ただし、両方を使用することはできません。
この要素には、次の子要素があり、属性はありません。
次の例はコンポーネント構成ファイル内のtime-range-offset
要素の使用方法を示します。
<record-parameters> <dataset-name>tuple1</dataset-name> <event-type-list> <event-type>TupleEvent1</event-type> </event-type-list> <provider-name>test-rdbms-provider</provider-name> <store-policy-parameters> <parameter> <name>timeout</name> <value>300</value> <parameter> </store-policy-parameters> <time-range-offset> <start>2010-01-20T05:00:00</start> <duration>03:00:00</duration> </time-range-offset> <batch-size>1</batch-size> <batch-time-out>10</batch-time-out> </record-parameters>