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 nameDescriptionDefault valuePermitted value rangeWhether or not changeable during restart#1
1stream.filterConditionSpecifies a conditional expression for using the timestamp adjustment function to filter tuples.Value specified in the query group property file#2--Y
2stream.filterModeSpecifies 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#2unuse
or
condition
Y
3stream.freeInputQueueSizeThresholdSpecifies 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#2Integer from 1 to 99Y
4stream.freeInputQueueSizeThresholdOutputMessageSpecifies 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#2true
or
false
Y
5stream.maxKeepTupleCountSpecifies the maximum number of tuples that can be retained by the timestamp adjustment function.Value specified in the query group property file#2Integer from 1 to 1048576​Y
6stream.streamNameSpecifies the stream name.None--Y
7stream.timestampAccuracySpecifies the time units and time adjustment range for the timestamp adjustment function.Value specified in the query group property file#2See 8.8.2(7) stream.timestampAccuracy={{sec|msec|usec},time-adjustment-range|unuse}.Y
8stream.timestampPositionSpecifies the name of the time-data column in tuples.Value specified in the query group property file#2See 8.8.2(8) stream.timestampPosition=time-data-column-name.Y
9tpl.backupFileCountSpecifies the maximum number of backup generations to be retained for the tuple log file.Value specified in the query group property file#2Integer from 0 to 10Y
10tpl.bufferCountSpecifies the number of tuple log buffers.Value specified in the query group property file#2Integer from 3 to 512Y
11tpl.bufferSizeSpecifies the maximum size of a tuple log buffer (in kilobytes).Value specified in the query group property file#2Integer from 1 to 2048000​Y
12tpl.fileCountSpecifies the maximum number of tuple log files.Value specified in the query group property file#2Integer from 3 to 512Y
13tpl.fileSizeSpecifies the maximum size of a tuple log file (in megabytes).Value specified in the query group property file#2Integer from 1 to 2048Y
14tpl.outputLevelSpecifies 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#2Integer from 1 to 3Y
15tpl.outputTriggerSpecifies 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#2BUFFER
or
NONE
Y
16tpl.useOverwriteSpecifies 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#2true
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