sow: Content from Server
Last updated
Last updated
Copyright 2013-2024 60East Technologies, Inc.
The sow message returns a record from the SOW. For more information, see the State of the World (SOW) Topics and Querying the State of the World (SOW) chapters in the AMPS User Guide.
The following table contains the header fields returned in a sow message:
The sow message contains data. The data for the message consists of up to BatchSize messages, formatted as expected by the protocol. Each message contains its own header, with the following fields:
Field
Description
Command
Type of message.
Always sow, as encoded by the protocol.
Topic
The topic from which the records were produced.
SowKey
An AMPS-created identifier for this message.
BatchSize
The number of records returned in a single sow batch.
Timestamp
The time at which AMPS generated this message.
QueryId
The QueryId of the query that produced this message.
MsgLen
The length of the first SOW message in the data portion of this message.
Field
Description
SowKey
An AMPS-created identifier for this message.
CorrelationId
A user-provided string that will be passed, verbatim, to subscribers.
If this header is not present on the SOW record, subscribers receive no value for the CorrelationId.
The contents of this header must consist of characters that are legal in Base64 encoding.
MsgLen
The length of the next SOW message in the data portion of this message.