DataStorm.Topic.*

3 min read

These properties define node-wide defaults for topic readers and writers. DataStorm reads them once when you create the node. To set defaults for an individual topic, use DataStorm::Topic::setReaderDefaultConfig and DataStorm::Topic::setWriterDefaultConfig.

Synopsis

DataStorm.Topic.SampleLifetime=num

Description

Defines the lifetime in milliseconds of samples queued in a writer or reader sample queue. DataStorm removes samples older than this lifetime from the queue. The default is 0. A value of 0 or less means an unlimited lifetime.

Synopsis

DataStorm.Topic.SampleCount=num

Description

This property defines the maximum number of samples queued in the writer or reader sample queue. If the maximum is reached, oldest samples are removed to make room for new samples in the queue. A negative value is equivalent to an infinite sample count. If set to 0, samples are not queued. If not defined, the default value is -1.

Synopsis

DataStorm.Topic.ClearHistory=value

Description

This property determines when the reader or writer sample history is cleared. Legal values and their description are presented in the table below:

ValueDescription
OnAdd
Clear the sample history when an Add sample is received.
OnRemove
Clear the sample history when a Remove sample is received.
OnAll
Clear the sample history when a new sample is received.
OnAllExceptPartialUpdate
Clear the sample history when a new sample which is not a partial update is received.
Never
Never clear the sample history.

If not defined, the default value is OnAll.

Synopsis

DataStorm.Topic.DiscardPolicy=value

Description

This property specifies how samples might be discarded by a reader.

ValueDescription
Never, None
Samples are never discarded.
SendTime
The reader discards a sample whose timestamp is at or before the latest timestamp it has accepted.
Priority
The reader discards a sample from a writer whose priority is lower than the highest priority among the writers connected for the sample's key.

If not defined, the default value is Never.

Synopsis

DataStorm.Topic.Priority=num

Description

This property specifies the priority assigned to the topic's writers. If not defined, the default value is 0.