@@ -144,6 +144,16 @@ message Owner {
144144 }
145145}
146146
147+ message OffsetMetadata {
148+ // System-set. Version of configuration used by kafka for consumed topic (number of partitions, etc.).
149+ // Used with `message_offset` field to create robust ordering of operations
150+ optional uint32 broker_version = 1 ;
151+
152+ // System-set. Message offset from kafka. Set on consumption from Kafka.
153+ // Used with `message_offset` field to create robust ordering of operations
154+ optional uint64 message_offset = 2 ;
155+ }
156+
147157// CreateRun can be used to create a new run. This can be done in two ways:
148158// 1. Create a new run with no inherited state. You may specify a new run family that will be
149159// inherited by future runs forking from this one, otherwise the new family will be selected by the server.
@@ -164,7 +174,7 @@ message Run {
164174
165175 // Optional. ForkPoint is used to identify the exact point in the parent history from which the new run continues.
166176 // If not specified, the new run will start with no inherited state.
167- ForkPoint fork_point = 2 ;
177+ optional ForkPoint fork_point = 2 ;
168178
169179 // Specifies Family for the new run. Run Family is used to group forking runs that share common ancestry.
170180 // By default, the new forking run will be in the same family as the parent run.
@@ -192,6 +202,9 @@ message Run {
192202 // - offline mode data generation,
193203 // - data migrations of historical runs
194204 optional google.protobuf.Timestamp start_processing_time = 11 ;
205+
206+ // System-set. Object contains infromation to provide robust ordering of operations.
207+ optional OffsetMetadata offset_metadata = 12 ;
195208}
196209
197210// Preview allows to control whether values are preview or committed.
@@ -218,10 +231,10 @@ message Preview {
218231message UpdateRunSnapshot {
219232 // Optional. Step value within the run. If not set, it will default to next full step of the run
220233 // (highest step across step values).
221- Step step = 1 ;
234+ optional Step step = 1 ;
222235
223236 // Timestamp field common to all included operations
224- google.protobuf.Timestamp timestamp = 2 ;
237+ optional google.protobuf.Timestamp timestamp = 2 ;
225238
226239 // Preview allows to control whether values are preview or committed.
227240 // When not specified, the values are considered committed.
@@ -269,6 +282,9 @@ message UpdateRunSnapshot {
269282 // - data migrations of historical runs,
270283 // - slow metric computation
271284 optional google.protobuf.Timestamp start_processing_time = 11 ;
285+
286+ // System-set. Object contains infromation to provide robust ordering of operations.
287+ optional OffsetMetadata offset_metadata = 12 ;
272288}
273289
274290// UpdateSnapshots updates fields for a given step. Used to update current state of the run in a single step.
0 commit comments