Partial results from a streaming read or SQL query. Streaming reads and SQL queries better tolerate large result sets, large rows, and large values, but are a little trickier to consume.
JSON representation |
---|
{ "metadata": { object ( |
Fields | |
---|---|
metadata |
Metadata about the result set, such as row type information. Only present in the first response. |
values[] |
A streamed result set consists of a stream of values, which might be split into many Most values are encoded based on type as described It is possible that the last value in values is "chunked", meaning that the rest of the value is sent in subsequent
Some examples of merging:
For a more complete example, suppose a streaming SQL query is yielding a result set whose rows contain a single string field. The following
This sequence of Not all |
chunked |
If true, then the final value in |
resume |
Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, the stream of results can be resumed by re-sending the original request and including A base64-encoded string. |
stats |
Query plan and execution statistics for the statement that produced this streaming result set. These can be requested by setting |