ストリームデータ処理基盤 uCosminexus Stream Data Platform - Application Framework システム構築・運用ガイド

[目次][索引][前へ][次へ]

8.7.1 クエリグループ用プロパティファイルの詳細

<この項の構成>
(1) 記述形式
(2) ファイル名
(3) ファイルの格納先
(4) 説明
(5) 指定できるパラメーター
(6) 注意事項

(1) 記述形式

パラメーターは次の形式で記述します。

<パラメーター名>=<値>

(2) ファイル名

<クエリグループ名>

クエリグループ名は,英数字(0〜9,a〜z,A〜Z)とアンダーライン(_)で,1〜64文字で指定してください。なお,クエリグループ名の先頭に使用できる文字は半角英文字だけです。

(3) ファイルの格納先

このファイルは,必ず次のディレクトリに格納してください。

<運用ディレクトリ>\conf\

(4) 説明

クエリ定義ファイルのパスやクエリグループを実行するときのチューニングパラメーターを設定します。このファイルは,クエリグループごとに必ず作成します。

(5) 指定できるパラメーター

指定できるパラメーターと省略時の仮定値を次の表に示します。なお,パラメーターの詳細については,「8.7.2 クエリグループ用プロパティファイルのパラメーターの詳細」を参照してください。

表8-5 指定できるパラメーターと省略時の仮定値(クエリグループ用プロパティファイル)

項番 パラメーター名 内容 省略時の仮定値 指定できる値の範囲 再開始時の変更可否※1
1 engine.externalStreamFuncVerifyMode ストリーム間演算の戻り値の型を検証するかどうかを指定します。 true true
または
false
×
2 querygroup.cqlFilePath クエリグループを定義するクエリ定義ファイルのパスを指定します。 なし 絶対パスまたは運用ディレクトリからの相対パス ×
3 querygroup.sleepOnOverStore SDPサーバが出力ストリームキューに空きがあるかどうかをチェックして空きがなかった場合に,クエリグループの実行をスリープさせる時間を指定します。 system_config.propertiesで指定した値※2 1〜2147483647
4 querygroup.sleepOnOverStoreRetryCount SDPサーバがクエリ実行後のタプルを出力ストリームキューへ投入する前に,出力ストリームキューに空きがあるかどうかをチェックする回数を指定します。 system_config.propertiesで指定した値※2 0〜2147483647
5 stream.filterCondition タイムスタンプ調整機能でタプルのフィルタリングをする場合に,フィルタリングの条件演算式を指定します。 なし 8.7.2(5) stream.filterCondition=条件演算式」を参照してください。
6 stream.filterMode タイムスタンプ調整機能でタプルのフィルタリングをするかどうかを指定します。
  • unuse:タプルのフィルタリングをしません。
  • condition:タプルのフィルタリングをします。
unuse unuse
または
condition
7 stream.freeInputQueueSizeThreshold 入力ストリームキューで使用する要素数の上限値に対する空きサイズのしきい値(単位:%)を指定します。 system_config.propertiesで指定した値※2 1〜99の整数
8 stream.freeInputQueueSizeThresholdOutputMessage SDPサーバのメッセージログに,警告メッセージを出力するかどうかを指定します。
  • true:警告メッセージを出力します。
  • false:警告メッセージを出力しません。
system_config.propertiesで指定した値※2 true
または
false
9 stream.maxKeepTupleCount タイムスタンプ調整機能で保留できるタプル数の上限値を指定します。 system_config.propertiesで指定した値※2 1〜1048576の整数
10 stream.propertyFiles ストリームごとにプロパティを設定する場合に,ストリーム用プロパティファイルのファイル名を指定します。 なし
11 stream.timestampAccuracy タイムスタンプ調整機能の時刻単位と時刻調整範囲を指定します。 system_config.propertiesで指定した値※2 8.7.2(11) stream.timestampAccuracy={{sec|msec|usec},時刻調整範囲|unuse}」を参照してください。
12 stream.timestampMode タプルに時刻を付与するためのタイムスタンプモードを指定します。
  • Server:サーバモードを使用します。
  • DataSource:データソースモードを使用します。
system_config.propertiesで指定した値※2 Server
または
DataSource
×
13 stream.timestampPosition タプル内の時刻データ列名を指定します。 system_config.propertiesで指定した値※2
14 stream.tupleLogMode sdptplputコマンドを実行するかどうかを指定します。
  • true:sdptplputコマンドを実行できます。
  • false:sdptplputコマンドを実行できません。
system_config.propertiesで指定した値※2 true
または
false
×
15 tpl.backupFileCount タプルログファイルのバックアップを残す最大世代数を指定します。 system_config.propertiesで指定した値※2 0〜10の整数
16 tpl.bufferCount タプルログのバッファーの面数を指定します。 system_config.propertiesで指定した値※2 3〜512の整数
17 tpl.bufferSize タプルログのバッファーの最大サイズ(単位:キロバイト)を指定します。 system_config.propertiesで指定した値※2 1〜2048000の整数
18 tpl.fileCount タプルログファイルの最大ファイル数を指定します。 system_config.propertiesで指定した値※2 3〜512の整数
19 tpl.fileSize タプルログファイルの最大サイズ(単位:メガバイト)を指定します。 system_config.propertiesで指定した値※2 1〜2048の整数
20 tpl.outputLevel タプルログの出力レベルを指定します。
  • 1:ストリームキューへ格納するタプルについて,タプルログを出力します。
  • 2:時刻の逆転によって破棄するタプルについて,タプルログを出力します。
  • 3:レベル1とレベル2のタプルについて,タプルログを出力します。
system_config.propertiesで指定した値※2 1〜3の整数
21 tpl.outputTrigger タプルログのファイルへの出力契機を指定します。
  • BUFFER:対象のストリームキューで現在のタプルログを取得しているバッファーがいっぱいになったら,タプルログをファイルへ出力します。
  • NONE:タプルログをファイルに出力しません。バッファリングもしません。
system_config.propertiesで指定した値※2 BUFFER
または
NONE
22 tpl.useOverwrite タプルログのバッファーの枯渇時にバッファーを上書きするかどうかを指定します。
  • true:タプルログのバッファーを上書きします。
  • false:タプルログのバッファーを上書きしません。
system_config.propertiesで指定した値※2 true
または
false
(凡例)
○:変更できます。
×:変更できません。
−:該当しません。
注※1
sdpcqlstartコマンドで-reloadオプションを指定してクエリグループを開始する際に,パラメーターの指定内容を変更できるかどうかを示します。
注※2
システムコンフィグプロパティファイル(system_config.properties)で値が指定されていない場合は,システムコンフィグプロパティファイルのデフォルト値が適用されます。

(6) 注意事項