uCosminexus Stream Data Platform - Application Framework Setup and Operation Guide

[Contents][Index][Back][Next]

8.8.1 Details of the stream property file

Organization of this subsection
(1) Format
(2) File name
(3) File storage location
(4) Description
(5) Specifiable parameters
(6) Notes

(1) Format

Specify each parameter in the following format:

parameter-name=value

(2) File name

You can specify any file name. This file name must be specified in the stream.propertyFiles parameter in the applicable query group property file.

(3) File storage location

This file must be stored in the following directory:

working-directory\conf\

(4) Description

This file specifies tuning parameters for a stream in a query group. You create this file for a stream only if you want to specify tuning parameters specifically for the stream.

(5) Specifiable parameters

The table below lists and describes the parameters that can be specified and their default values. For details about the parameters, see 8.8.2 Details of the parameters in the stream property file.

Table 8-6 Specifiable parameters and their default values (stream property file)

No. Parameter name Description Default value Permitted value range Whether or not changeable during restart#1
1 stream.filterCondition Specifies a conditional expression for using the timestamp adjustment function to filter tuples. Value specified in the query group property file#2 -- Y
2 stream.filterMode Specifies whether the timestamp adjustment function is to be used to filter tuples:
unuse: Does not filter tuples.
condition: Filters tuples.
Value specified in the query group property file#2 unuse
or
condition
Y
3 stream.freeInputQueueSizeThreshold Specifies a threshold value (%) for the available size with respect to the maximum number of elements used in the input stream queue. Value specified in the query group property file#2 Integer from 1 to 99 Y
4 stream.freeInputQueueSizeThresholdOutputMessage Specifies whether a warning message is to be output to the SDP server's message log:
true: Outputs warning message.
false: Does not output warning message.
Value specified in the query group property file#2 true
or
false
Y
5 stream.maxKeepTupleCount Specifies the maximum number of tuples that can be retained by the timestamp adjustment function. Value specified in the query group property file#2 Integer from 1 to 1048576 Y
6 stream.streamName Specifies the stream name. None -- Y
7 stream.timestampAccuracy Specifies the time units and time adjustment range for the timestamp adjustment function. Value specified in the query group property file#2 See 8.8.2(7) stream.timestampAccuracy={{sec|msec|usec},time-adjustment-range|unuse}. Y
8 stream.timestampPosition Specifies the name of the time-data column in tuples. Value specified in the query group property file#2 See 8.8.2(8) stream.timestampPosition=time-data-column-name. Y
9 tpl.backupFileCount Specifies the maximum number of backup generations to be retained for the tuple log file. Value specified in the query group property file#2 Integer from 0 to 10 Y
10 tpl.bufferCount Specifies the number of tuple log buffers. Value specified in the query group property file#2 Integer from 3 to 512 Y
11 tpl.bufferSize Specifies the maximum size of a tuple log buffer (in kilobytes). Value specified in the query group property file#2 Integer from 1 to 2048000 Y
12 tpl.fileCount Specifies the maximum number of tuple log files. Value specified in the query group property file#2 Integer from 3 to 512 Y
13 tpl.fileSize Specifies the maximum size of a tuple log file (in megabytes). Value specified in the query group property file#2 Integer from 1 to 2048 Y
14 tpl.outputLevel Specifies the tuple log output level:
  • 1: Outputs tuple logs for the tuples that are stored in the stream queue.
  • 2: Outputs tuple logs for the tuples that are discarded due to out-of-sequence time.
  • 3: Outputs tuple logs for tuples with levels 1 and 2.
Value specified in the query group property file#2 Integer from 1 to 3 Y
15 tpl.outputTrigger Specifies the tuple log file output timing:
BUFFER: Outputs tuple logs to a file when the buffer being used to collect the current tuple logs in the target stream becomes full.
NONE: Does not output tuple logs to a file or perform buffering of tuple logs.
Value specified in the query group property file#2 BUFFER
or
NONE
Y
16 tpl.useOverwrite Specifies whether the buffer is to be overwritten in the event of a full tuple log buffer:
  • true: Overwrites the tuple log buffer.
  • false: Does not overwrite the tuple log buffer.
Value specified in the query group property file#2 true
or
false
Y

Legend:
--: Not applicable
Y: Changeable

#1
Indicates whether (Y) or not (N) the parameter's setting can be changed when the query group is started by the sdpcqlstart command with the -reload option specified.

#2
If no value is specified in the query group property file, the default value for the query group property file is used.

(6) Notes