Datastream-Specific Features
datastream interfaces are highly tunable, depending on the kind of data they are representing: it is possible to fine tune several aspects of how data is stored, transferred and indexed. The following properties can be set at mapping level.
NOTE: In case the interface is aggregated, additional properties must be the same for each mapping.
explicit_timestamp: By default, Data Orchestrator associates a timestamp to data whenever it is collected (or - when the message hits the data collection stage). However, when setting this property totrue, Data Orchestrator expects the owner to attach a valid timestamp each time it produces data. In that case, the provided timestamp is used for indexing.reliability: Each mapping can beunreliable(default),guaranteed,unique. This defines whether data should be considered delivered when the transport successfully sends the data regardless of the outcome (unreliable), when data has been received at least once by the recipient (guaranteed) or when data has been received exactly once by the recipient (unique). When using reliable data, consider you might incur in additional resource usage on both the transport and the device's end.retention: Each mapping can have adiscard(default),volatile,storedretention. This defines whether data should be discarded if the transport is temporarily uncapable of delivering it (discard), should be kept in a cache in memory (volatile) or on disk (stored), and guaranteed to be delivered in the timeframe defined by theexpiry.expiry: Meaningful only whenretentionisstored. Defines how many seconds a specific data entry should be kept before giving up and erasing it from the persistent cache. A value<=0 means the persistent cache never expires, and is the default.database_retention_policy: Useful only with datastream. Defines whether data should expire from the database after a given interval. Valid values are:no_ttlanduse_ttl.database_retention_ttl: Useful whendatabase_retention_policyis"use_ttl". Defines how many seconds a specific data entry should be kept before erasing it from the database.