data

Protocol buffer definition for data

sift/data/v1/data.proto

BitFieldElementValues

FieldTypeLabelDescription
namestring
valuesBitFieldValuerepeated

BitFieldValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueuint32

BitFieldValues

FieldTypeLabelDescription
metadataMetadata
valuesBitFieldElementValuesrepeated

BoolValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valuebool

BoolValues

FieldTypeLabelDescription
metadataMetadata
valuesBoolValuerepeated

CalculatedChannelQuery

FieldTypeLabelDescription
channel_keystring
expressionsift.calculated_channels.v1.ExpressionRequest
run_idstringoptionalOptional. If set, only data for the specified run is returned If set to the empty string, only non-run data is returned. If unset, all run / non-run data is returned.
modesift.calculated_channels.v1.ExpressionModeoptionalOptional. If unset, will default to EXPRESSION_MODE_CALCULATED_CHANNELS.

ChannelQuery

FieldTypeLabelDescription
channel_idstringchannel_id is the uuid of the channel.
run_idstringoptionalOptional. If set, only data associated with the specified run is returned. If set to the empty string, only non-run data is returned. If unset, all run / non-run data is returned.

DoubleValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valuedouble

DoubleValues

FieldTypeLabelDescription
metadataMetadata
valuesDoubleValuerepeated

EnumValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueuint32

EnumValues

FieldTypeLabelDescription
metadataMetadata
valuesEnumValuerepeated

FloatValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valuefloat

FloatValues

FieldTypeLabelDescription
metadataMetadata
valuesFloatValuerepeated

GetDataRequest

FieldTypeLabelDescription
queriesQueryrepeated
start_timegoogle.protobuf.TimestampRequired. The starting timestamp of the data to retrieve. This is an inclusive bound.
end_timegoogle.protobuf.TimestampRequired. The end timestamp of the data to retrieve. This is an exclusive bound.
sample_msuint32The rate to sample the returned data at. The data is sampled using LTTB which will return one point approximately every sample_ms milliseconds that retains the shape of the raw data. Sampling is only supported for numeric data types, if sample_ms is provided for non-numeric data, it will be ignored and the full-fidelity data will be returned.
page_sizeuint32The maximum number of channel values to return. The service may return fewer than this value. If unspecified, at most 10,000 values will be returned. The maximum value is 100,000; values above 100,000 will be coerced to 100,000. For variable data types (i.e. string channels), at most page_size elements will be read, or 1MB, whichever occurs first.
page_tokenstringA page token, received from a previous GetData call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to GetData must match the call that provided the page token.

GetDataResponse

FieldTypeLabelDescription
next_page_tokenstring
datagoogle.protobuf.Anyrepeateddata contains the result of the supplied queries. Be aware that each query can generate multiple data responses. For example, if run_id is omitted from a ChannelQuery, the query returns data for all runs containing that channel. Channel data for each run is returned in a separate data object. Possible message types: sift.data.v1.DoubleValues sift.data.v1.FloatValues sift.data.v1.StringValues sift.data.v1.EnumValues sift.data.v1.BitFieldValues sift.data.v1.BoolValues sift.data.v1.Int32Values sift.data.v1.Int64Values sift.data.v1.Uint32Values sift.data.v1.Uint64Values

Int32Value

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueint32

Int32Values

FieldTypeLabelDescription
metadataMetadata
valuesInt32Valuerepeated

Int64Value

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueint64

Int64Values

FieldTypeLabelDescription
metadataMetadata
valuesInt64Valuerepeated

Metadata

FieldTypeLabelDescription
data_typesift.common.type.v1.ChannelDataType
sampled_msuint32
assetMetadata.Asset
runMetadata.Runoptional
channelMetadata.Channeloptional

Metadata.Asset

FieldTypeLabelDescription
asset_idstring
namestring

Metadata.Channel

FieldTypeLabelDescription
channel_idstringFor channel queries, this will contain the requested backing channel id. For calculated channel queries, this will contain the requested channel key.
componentstring
namestring
unitMetadata.Channel.Unit
enum_typessift.common.type.v1.ChannelEnumTyperepeated
bit_field_elementssift.common.type.v1.ChannelBitFieldElementrepeated

Metadata.Channel.Unit

FieldTypeLabelDescription
namestring
abbreviated_namestring

Metadata.Run

FieldTypeLabelDescription
run_idstringThe run_id that was sent with the data during ingestion (if any). Note that this may be different from the run_id that was requested in the query.
namestring

Query

FieldTypeLabelDescription
channelChannelQuery
calculated_channelCalculatedChannelQuery

StringValue

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valuestring

StringValues

FieldTypeLabelDescription
metadataMetadata
valuesStringValuerepeated

Uint32Value

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueuint32

Uint32Values

FieldTypeLabelDescription
metadataMetadata
valuesUint32Valuerepeated

Uint64Value

FieldTypeLabelDescription
timestampgoogle.protobuf.Timestamp
valueuint64

Uint64Values

FieldTypeLabelDescription
metadataMetadata
valuesUint64Valuerepeated

DataService

Method NameRequest TypeResponse TypeDescription
GetDataGetDataRequestGetDataResponseQuery data

On this page