ストリームデータ処理基盤 uCosminexus Stream Data Platform - Application Framework システム構築・運用ガイド
ここでは,「8.6.1(5) 指定できるパラメーター」で示したシステムコンフィグプロパティファイル(system_config.properties)のパラメーターの詳細について説明します。
ストリーム間演算の戻り値の型を検証するかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはtrueです。
falseを指定することで,ストリーム間演算関数を頻繁に呼び出すシステムで性能が改善する場合があります。ただし,検証をしない場合は,トラブルシュートが困難になるので注意してください。
このパラメーターは,システムコンフィグプロパティファイル,およびクエリグループ用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.)。
ストリームキューで使用する要素数の初期値を1〜1048576の整数で指定します。デフォルトは1024です。
ここで指定した要素数を超える要素数をストリームキューに登録しようとした場合,engine.maxQueueSizeパラメーターで設定する上限値までストリームキューが拡張されます。
なお,ここで指定した要素数の初期値は,個々のストリームキューに対する初期値になります。
ストリームキューで使用する要素数の上限値を1〜1048576の整数で指定します。デフォルトは4096です。
ストリームキューで使用する要素数の上限値は,engine.initialQueueSizeパラメーターで指定した要素数の初期値以下となるように指定してください。
なお,ここで指定した要素数の上限値は,個々のストリームキューに対する上限値になります。
ストリームキューで使用する要素数を監視するしきい値(単位:%)を1〜99の整数で指定します。このパラメーターを省略した場合,要素数は監視されません。
次の計算式で算出される値が,このパラメーターの指定値を超えると,警告メッセージが出力されます。
要素数÷engine.maxQueueSizeパラメーターの指定値×100
警告メッセージは,いったん出力されると,要素数がしきい値を下回ったあとに再びしきい値を上回るまで出力されません。
ログファイルの初期化で障害が発生した場合に,SDPサーバの起動を続行させるかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはfalseです。
SDPサーバが出力するメッセージをコンソールに出力するかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはfalseです。
タイムアウトと判定する処理時間(単位:ミリ秒)を1〜2147483647の整数で指定します。デフォルトは30000です。
デフォルト値でタイムアウト検知のメッセージが頻発する場合は,APIトレースから実測した処理時間を基に,十分な余裕を持った値を指定してください。
クエリの算術演算の結果がDECIMAL型(NUMERIC型を含めます)となる場合の,算術演算の最大精度を1〜38の整数で指定します。デフォルトは38です。
演算結果がDECIMAL型となる算術演算とは,次の算術演算です。
算術演算の結果が,このパラメーターで指定した精度を超えない場合は,算術演算の結果の精度は加工されません。超える場合は,このパラメーターで指定した精度に丸められます。丸めの動作は,query.decimalRoundingModeパラメーターで指定します。
クエリの演算結果がDECIMAL型(NUMERIC型を含めます)となる場合の,query.decimalMaxPrecisionパラメーターで指定した精度を超えたときの丸めの動作を指定します。デフォルトはHALF_UPです。
SDPサーバが出力ストリームキューに空きがあるかどうかをチェックして空きがなかった場合に,クエリグループの実行をスリープさせる時間(単位:ミリ秒)を1〜2147483647の整数で指定します。デフォルトは100です。
このパラメーターの指定は,querygroup.sleepOnOverStoreRetryCountパラメーターで1以上を指定した場合に有効です。
このパラメーターによってスリープしたクエリグループに対しては,次のことが実行できます。
このパラメーターは,システムコンフィグプロパティファイル,およびクエリグループ用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.)。
SDPサーバがクエリ実行後のタプルを出力ストリームキューへ投入する前に,出力ストリームキューに空きがあるかどうかをチェックする回数を0〜2147483647の整数で指定します。デフォルトは0です。
0を指定した場合,SDPサーバは,出力ストリームキューに空きがあるかをチェックしないで,クエリ実行後のタプルを出力ストリームキューへ投入します。
1以上を指定した場合,SDPサーバは,指定された回数だけ次の処理を実行します。
このパラメーターは,システムコンフィグプロパティファイル,およびクエリグループ用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.)。
SDPサーバのポート番号を1〜65535の整数で指定します。デフォルトは20400です。
デフォルトのポート番号(20400)が,ほかのシステムのポート番号と重複する場合は,別のポート番号を指定してください。ただし,1〜1023(Well Knownポート番号)は使用しないことをお勧めします。
入力ストリームキューで使用する要素数の上限値(engine.maxQueueSizeパラメーターの指定値)に対する空きサイズのしきい値(単位:%)を1〜99の整数で指定します。
次に示す条件を満たした場合に,put(StreamTuple tuple)メソッドまたはput(ArrayList<StreamTuple> tuple_list)メソッドからSDPClientFreeInputQueueSizeThresholdOverExceptionの例外がスローされます。このとき,入力ストリームキューへのタプルの投入は,成功しています。
このパラメーターの指定値 ≧((入力ストリームキューの空きサイズ÷入力ストリームキューの最大サイズ)×100)
このパラメーターを省略した場合は,しきい値のチェックによる例外は発生しません。
なお,engine.watchQueueSize.thresholdパラメーターは,入力および出力ストリームキューの最大サイズに対する使用サイズのしきい値を設定するものであり,stream.freeInputQueueSizeThresholdとは異なるパラメーターなので注意してください。詳細については,engine.watchQueueSize.thresholdパラメーターを参照してください。
sdptplputコマンドで入力ストリームキューにタプルを投入する場合,このパラメーターの指定は無効となります。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
SDPサーバのメッセージログに,警告メッセージ(メッセージKFSP42032-W)を出力するかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはfalseです。
このパラメーターの指定は,stream.freeInputQueueSizeThresholdパラメーターが指定された場合だけ有効です。
なお,警告メッセージが出力されるのは,このパラメーターでtrueを指定し,次の条件を満たした場合です。
stream.freeInputQueueSizeThresholdパラメーターの指定値 ≧((入力ストリームキューの空きサイズ÷入力ストリームキューの最大サイズ)×100)
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タイムスタンプ調整機能で保留できるタプル数の上限値を1〜1048576の整数で指定します。デフォルトは125828です。
このパラメーターで指定したタプル数の上限値は,個々の入力ストリームのタイムスタンプ調整機能に対する上限値となります。
タプル数がこのパラメーターで指定した上限値を超えると,クエリグループが閉塞されます。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タイムスタンプ調整機能の時刻単位と時刻調整範囲を指定します。大文字,小文字の区別はされません。
stream.timestampModeパラメーターでDataSourceを指定した場合,このパラメーターを必ず指定してください。stream.timestampModeパラメーターでServerを指定した場合,このパラメーターの指定は無視されますが,パラメーターの形式チェックは実施されます。
時刻単位 | 指定範囲 |
---|---|
sec(秒) | 0〜59の整数 |
msec(ミリ秒) | 0〜999の整数 |
usec(マイクロ秒) | 0〜999の整数 |
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルに時刻を付与するためのタイムスタンプモードをServerまたはDataSourceで指定します。大文字,小文字の区別はされません。デフォルトはServerです。
このパラメーターは,システムコンフィグプロパティファイル,およびクエリグループ用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.)。
タプル内の時刻データ列名を指定します。大文字,小文字の区別はされません。
stream.timestampModeパラメーターでDataSourceを指定した場合,このパラメーターを必ず指定してください。stream.timestampModeパラメーターでServerを指定した場合,このパラメーターの指定は無視されますが,パラメーターの形式チェックは実施されます。
時刻データとして指定できるデータ型は,TIMESTAMP型だけです。
時刻データの範囲は,GMT(グリニッジ標準時)の1970/01/01 00:00:00.000000000から2261/12/31 23:59:59.999999999までになります。それ以外の時刻を指定した場合は,ストリームデータ送信時に例外が発生します。日本標準時はGMTより9時間あとであることに注意してください。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
sdptplputコマンドを実行するかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはfalseです。
stream.timestampModeパラメーターでServerを,このパラメーターでtrueを指定した場合は,StreamInputインタフェースのputメソッドでストリームデータを送信すると,SDPClientExceptionの例外が発生します。
このパラメーターは,システムコンフィグプロパティファイル,およびクエリグループ用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.)。
タプルログファイルのバックアップを残す最大世代数を0〜10の整数で指定します。デフォルトは1です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログのバッファーの面数を3〜512の整数で指定します。デフォルトは5です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログのバッファーの最大サイズ(単位:キロバイト)を1〜2048000の整数で指定します。デフォルトは1024です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログファイルの最大ファイル数を3〜512の整数で指定します。デフォルトは3です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログファイルの最大サイズ(単位:メガバイト)を1〜2048の整数で指定します。デフォルトは100です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログの出力レベルを1〜3の整数で指定します。デフォルトは3です。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログのファイルへの出力契機をBUFFERまたはNONEで指定します。大文字,小文字の区別はされません。入力ストリームキューの場合,デフォルトはBUFFERです。出力ストリームキューの場合,デフォルトはNONEです。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の優先順位で指定値が有効になります(1.>2.>3.)。
タプルログのバッファーの枯渇時にバッファーを上書きするかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはtrueです。
このパラメーターは,システムコンフィグプロパティファイル,クエリグループ用プロパティファイル,およびストリーム用プロパティファイルで指定できます。指定が重複した場合,または指定を省略した場合,次の順位で指定値が有効になります(1.>2.>3.)。
APIトレースのバッファーの面数を3〜512の整数で指定します。デフォルトは3です。
APIトレースのバッファーの最大サイズ(単位:キロバイト)を1〜2048000の整数で指定します。デフォルトは1024です。
APIトレースを出力するファイルの最大ファイル数を3〜512の整数で指定します。デフォルトは3です。
APIトレースを出力するファイルの最大サイズ(単位:メガバイト)を1〜2048の整数で指定します。デフォルトは1024です。
APIトレースのI/Oバッファーの最大サイズ(単位:キロバイト)を1〜2048000の整数で指定します。デフォルトは2048です。
APIトレースのファイルへの出力契機をBUFFERまたはNONEで指定します。大文字,小文字の区別はされません。デフォルトはBUFFERです。
APIトレースのバッファーの枯渇時にバッファーを上書きするかどうかをtrueまたはfalseで指定します。大文字,小文字の区別はされません。デフォルトはtrueです。
All Rights Reserved. Copyright (C) 2010, 2014, Hitachi, Ltd.