diff --git a/go/internal/proto/table/table.pb.go b/go/internal/proto/table/table.pb.go index 79cd00c29ab..cdeec28b7e8 100644 --- a/go/internal/proto/table/table.pb.go +++ b/go/internal/proto/table/table.pb.go @@ -762,12 +762,15 @@ type isTableReference_Ref interface { } type TableReference_Ticket struct { - // an exported ticket + // A ticket to resolve to get the table. It's preferable to use export tickets in order to avoid races that are + // possible with tickets controlled by the server, but any ticket type will suffice as long as it resolves to a + // table. Ticket *ticket.Ticket `protobuf:"bytes,1,opt,name=ticket,proto3,oneof"` } type TableReference_BatchOffset struct { - // an offset into a BatchRequest -- used to reference a result that will not be exported + // An offset into a BatchRequest's ops field, used to reference an intermediate operation which may not have been + // exported. Only valid to set when used in the context of a BatchRequest. BatchOffset int32 `protobuf:"zigzag32,2,opt,name=batch_offset,json=batchOffset,proto3,oneof"` } diff --git a/proto/proto-backplane-grpc/src/main/proto/deephaven/proto/table.proto b/proto/proto-backplane-grpc/src/main/proto/deephaven/proto/table.proto index 7fc77ff238d..7ba7b261c20 100644 --- a/proto/proto-backplane-grpc/src/main/proto/deephaven/proto/table.proto +++ b/proto/proto-backplane-grpc/src/main/proto/deephaven/proto/table.proto @@ -276,9 +276,13 @@ service TableService { message TableReference { oneof ref { - // an exported ticket + // A ticket to resolve to get the table. It's preferable to use export tickets in order to avoid races that are + // possible with tickets controlled by the server, but any ticket type will suffice as long as it resolves to a + // table. Ticket ticket = 1; - // an offset into a BatchRequest -- used to reference a result that will not be exported + + // An offset into a BatchRequest's ops field, used to reference an intermediate operation which may not have been + // exported. Only valid to set when used in the context of a BatchRequest. sint32 batch_offset = 2; } }