Package com.google.spanner.v1

Class PartialResultSet

java.lang.Object
com.google.protobuf.AbstractMessageLite
com.google.protobuf.AbstractMessage
com.google.protobuf.GeneratedMessageV3
com.google.spanner.v1.PartialResultSet
All Implemented Interfaces:
com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, PartialResultSetOrBuilder, Serializable
public final class PartialResultSet extends com.google.protobuf.GeneratedMessageV3 implements PartialResultSetOrBuilder
 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.
Protobuf type google.spanner.v1.PartialResultSet
See Also:

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static final class 
    PartialResultSet.Builder
    Partial results from a streaming read or SQL query.

    Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3

    com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>,BuilderT extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT,BuilderT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable, com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter

    Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite

    com.google.protobuf.AbstractMessageLite.InternalOneOfEnum

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    CHUNKED_VALUE_FIELD_NUMBER
     
    static final int
    LAST_FIELD_NUMBER
     
    static final int
    METADATA_FIELD_NUMBER
     
    static final int
    PRECOMMIT_TOKEN_FIELD_NUMBER
     
    static final int
    RESUME_TOKEN_FIELD_NUMBER
     
    static final int
    STATS_FIELD_NUMBER
     
    static final int
    VALUES_FIELD_NUMBER
     

    Fields inherited from class com.google.protobuf.GeneratedMessageV3

    alwaysUseFieldBuilders, unknownFields

    Fields inherited from class com.google.protobuf.AbstractMessage

    memoizedSize

    Fields inherited from class com.google.protobuf.AbstractMessageLite

    memoizedHashCode

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
     
    boolean
    getChunkedValue()
    If true, then the final value in [values][google.spanner.v1.PartialResultSet.values] is chunked, and must be combined with more values from subsequent `PartialResultSet`s to obtain a complete field value.
    static PartialResultSet
    getDefaultInstance()
     
    PartialResultSet
    getDefaultInstanceForType()
     
    static final com.google.protobuf.Descriptors.Descriptor
    getDescriptor()
     
    boolean
    getLast()
    Optional.
    ResultSetMetadata
    getMetadata()
    Metadata about the result set, such as row type information.
    ResultSetMetadataOrBuilder
    getMetadataOrBuilder()
    Metadata about the result set, such as row type information.
    com.google.protobuf.Parser<PartialResultSet>
    getParserForType()
     
    MultiplexedSessionPrecommitToken
    getPrecommitToken()
    Optional.
    MultiplexedSessionPrecommitTokenOrBuilder
    getPrecommitTokenOrBuilder()
    Optional.
    com.google.protobuf.ByteString
    getResumeToken()
    Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss.
    int
    getSerializedSize()
     
    ResultSetStats
    getStats()
    Query plan and execution statistics for the statement that produced this streaming result set.
    ResultSetStatsOrBuilder
    getStatsOrBuilder()
    Query plan and execution statistics for the statement that produced this streaming result set.
    com.google.protobuf.Value
    getValues(int index)
    A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values.
    int
    getValuesCount()
    A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values.
    List<com.google.protobuf.Value>
    getValuesList()
    A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values.
    com.google.protobuf.ValueOrBuilder
    getValuesOrBuilder(int index)
    A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values.
    List<? extends com.google.protobuf.ValueOrBuilder>
    getValuesOrBuilderList()
    A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values.
    int
    hashCode()
     
    boolean
    hasMetadata()
    Metadata about the result set, such as row type information.
    boolean
    hasPrecommitToken()
    Optional.
    boolean
    hasStats()
    Query plan and execution statistics for the statement that produced this streaming result set.
    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
    internalGetFieldAccessorTable()
     
    final boolean
    isInitialized()
     
    static PartialResultSet.Builder
    newBuilder()
     
    static PartialResultSet.Builder
    newBuilder(PartialResultSet prototype)
     
    PartialResultSet.Builder
    newBuilderForType()
     
    protected PartialResultSet.Builder
    newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
     
    protected Object
    newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
     
    static PartialResultSet
    parseDelimitedFrom(InputStream input)
     
    static PartialResultSet
    parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static PartialResultSet
    parseFrom(byte[] data)
     
    static PartialResultSet
    parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static PartialResultSet
    parseFrom(com.google.protobuf.ByteString data)
     
    static PartialResultSet
    parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static PartialResultSet
    parseFrom(com.google.protobuf.CodedInputStream input)
     
    static PartialResultSet
    parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static PartialResultSet
    parseFrom(InputStream input)
     
    static PartialResultSet
    parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static PartialResultSet
    parseFrom(ByteBuffer data)
     
    static PartialResultSet
    parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static com.google.protobuf.Parser<PartialResultSet>
    parser()
     
    PartialResultSet.Builder
    toBuilder()
     
    void
    writeTo(com.google.protobuf.CodedOutputStream output)
     

    Methods inherited from class com.google.protobuf.GeneratedMessageV3

    canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMapFieldReflection, isStringEmpty, makeExtensionsImmutable, makeMutableCopy, makeMutableCopy, mergeFromAndMakeImmutableInternal, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBooleanList, newBuilderForType, newDoubleList, newFloatList, newIntList, newLongList, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, writeReplace, writeString, writeStringNoTag

    Methods inherited from class com.google.protobuf.AbstractMessage

    findInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toString

    Methods inherited from class com.google.protobuf.AbstractMessageLite

    addAll, addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface com.google.protobuf.MessageLite

    toByteArray, toByteString, writeDelimitedTo, writeTo

    Methods inherited from interface com.google.protobuf.MessageOrBuilder

    findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

  • Field Details

  • Method Details

    • newInstance

      protected Object newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
      Overrides:
      newInstance in class com.google.protobuf.GeneratedMessageV3

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

    • hasMetadata

      public boolean hasMetadata()
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;
      Specified by:
      hasMetadata in interface PartialResultSetOrBuilder
      Returns:
      Whether the metadata field is set.

    • getMetadata

      public ResultSetMetadata getMetadata()
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;
      Specified by:
      getMetadata in interface PartialResultSetOrBuilder
      Returns:
      The metadata.

    • getMetadataOrBuilder

      public ResultSetMetadataOrBuilder getMetadataOrBuilder()
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;
      Specified by:
      getMetadataOrBuilder in interface PartialResultSetOrBuilder

    • getValuesList

      public List<com.google.protobuf.Value> getValuesList()
       A streamed result set consists of a stream of values, which might
 be split into many `PartialResultSet` messages to accommodate
 large rows and/or large values. Every N complete values defines a
 row, where N is equal to the number of entries in
 [metadata.row_type.fields][google.spanner.v1.StructType.fields].

 Most values are encoded based on type as described
 [here][google.spanner.v1.TypeCode].

 It's possible that the last value in values is "chunked",
 meaning that the rest of the value is sent in subsequent
 `PartialResultSet`(s). This is denoted by the
 [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
 Two or more chunked values can be merged to form a complete value as
 follows:

   * `bool/number/null`: can't be chunked
   * `string`: concatenate the strings
   * `list`: concatenate the lists. If the last element in a list is a
     `string`, `list`, or `object`, merge it with the first element in
     the next list by applying these rules recursively.
   * `object`: concatenate the (field name, field value) pairs. If a
     field name is duplicated, then apply these rules recursively
     to merge the field values.

 Some examples of merging:

     Strings are concatenated.
     "foo", "bar" => "foobar"

     Lists of non-strings are concatenated.
     [2, 3], [4] => [2, 3, 4]

     Lists are concatenated, but the last and first elements are merged
     because they are strings.
     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]

     Lists are concatenated, but the last and first elements are merged
     because they are lists. Recursively, the last and first elements
     of the inner lists are merged because they are strings.
     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]

     Non-overlapping object fields are combined.
     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}

     Overlapping object fields are merged.
     {"a": "1"}, {"a": "2"} => {"a": "12"}

     Examples of merging objects containing lists of strings.
     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}

 For a more complete example, suppose a streaming SQL query is
 yielding a result set whose rows contain a single string
 field. The following `PartialResultSet`s might be yielded:

     {
       "metadata": { ... }
       "values": ["Hello", "W"]
       "chunked_value": true
       "resume_token": "Af65..."
     }
     {
       "values": ["orl"]
       "chunked_value": true
     }
     {
       "values": ["d"]
       "resume_token": "Zx1B..."
     }

 This sequence of `PartialResultSet`s encodes two rows, one
 containing the field value `"Hello"`, and a second containing the
 field value `"World" = "W" + "orl" + "d"`.

 Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
 resumed from a previously yielded `resume_token`. For the above sequence of
 `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
 yields results from the `PartialResultSet` with value "orl".
      repeated .google.protobuf.Value values = 2;
      Specified by:
      getValuesList in interface PartialResultSetOrBuilder

    • getValuesOrBuilderList

      public List<? extends com.google.protobuf.ValueOrBuilder> getValuesOrBuilderList()
       A streamed result set consists of a stream of values, which might
 be split into many `PartialResultSet` messages to accommodate
 large rows and/or large values. Every N complete values defines a
 row, where N is equal to the number of entries in
 [metadata.row_type.fields][google.spanner.v1.StructType.fields].

 Most values are encoded based on type as described
 [here][google.spanner.v1.TypeCode].

 It's possible that the last value in values is "chunked",
 meaning that the rest of the value is sent in subsequent
 `PartialResultSet`(s). This is denoted by the
 [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
 Two or more chunked values can be merged to form a complete value as
 follows:

   * `bool/number/null`: can't be chunked
   * `string`: concatenate the strings
   * `list`: concatenate the lists. If the last element in a list is a
     `string`, `list`, or `object`, merge it with the first element in
     the next list by applying these rules recursively.
   * `object`: concatenate the (field name, field value) pairs. If a
     field name is duplicated, then apply these rules recursively
     to merge the field values.

 Some examples of merging:

     Strings are concatenated.
     "foo", "bar" => "foobar"

     Lists of non-strings are concatenated.
     [2, 3], [4] => [2, 3, 4]

     Lists are concatenated, but the last and first elements are merged
     because they are strings.
     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]

     Lists are concatenated, but the last and first elements are merged
     because they are lists. Recursively, the last and first elements
     of the inner lists are merged because they are strings.
     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]

     Non-overlapping object fields are combined.
     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}

     Overlapping object fields are merged.
     {"a": "1"}, {"a": "2"} => {"a": "12"}

     Examples of merging objects containing lists of strings.
     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}

 For a more complete example, suppose a streaming SQL query is
 yielding a result set whose rows contain a single string
 field. The following `PartialResultSet`s might be yielded:

     {
       "metadata": { ... }
       "values": ["Hello", "W"]
       "chunked_value": true
       "resume_token": "Af65..."
     }
     {
       "values": ["orl"]
       "chunked_value": true
     }
     {
       "values": ["d"]
       "resume_token": "Zx1B..."
     }

 This sequence of `PartialResultSet`s encodes two rows, one
 containing the field value `"Hello"`, and a second containing the
 field value `"World" = "W" + "orl" + "d"`.

 Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
 resumed from a previously yielded `resume_token`. For the above sequence of
 `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
 yields results from the `PartialResultSet` with value "orl".
      repeated .google.protobuf.Value values = 2;
      Specified by:
      getValuesOrBuilderList in interface PartialResultSetOrBuilder

    • getValuesCount

      public int getValuesCount()
       A streamed result set consists of a stream of values, which might
 be split into many `PartialResultSet` messages to accommodate
 large rows and/or large values. Every N complete values defines a
 row, where N is equal to the number of entries in
 [metadata.row_type.fields][google.spanner.v1.StructType.fields].

 Most values are encoded based on type as described
 [here][google.spanner.v1.TypeCode].

 It's possible that the last value in values is "chunked",
 meaning that the rest of the value is sent in subsequent
 `PartialResultSet`(s). This is denoted by the
 [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
 Two or more chunked values can be merged to form a complete value as
 follows:

   * `bool/number/null`: can't be chunked
   * `string`: concatenate the strings
   * `list`: concatenate the lists. If the last element in a list is a
     `string`, `list`, or `object`, merge it with the first element in
     the next list by applying these rules recursively.
   * `object`: concatenate the (field name, field value) pairs. If a
     field name is duplicated, then apply these rules recursively
     to merge the field values.

 Some examples of merging:

     Strings are concatenated.
     "foo", "bar" => "foobar"

     Lists of non-strings are concatenated.
     [2, 3], [4] => [2, 3, 4]

     Lists are concatenated, but the last and first elements are merged
     because they are strings.
     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]

     Lists are concatenated, but the last and first elements are merged
     because they are lists. Recursively, the last and first elements
     of the inner lists are merged because they are strings.
     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]

     Non-overlapping object fields are combined.
     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}

     Overlapping object fields are merged.
     {"a": "1"}, {"a": "2"} => {"a": "12"}

     Examples of merging objects containing lists of strings.
     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}

 For a more complete example, suppose a streaming SQL query is
 yielding a result set whose rows contain a single string
 field. The following `PartialResultSet`s might be yielded:

     {
       "metadata": { ... }
       "values": ["Hello", "W"]
       "chunked_value": true
       "resume_token": "Af65..."
     }
     {
       "values": ["orl"]
       "chunked_value": true
     }
     {
       "values": ["d"]
       "resume_token": "Zx1B..."
     }

 This sequence of `PartialResultSet`s encodes two rows, one
 containing the field value `"Hello"`, and a second containing the
 field value `"World" = "W" + "orl" + "d"`.

 Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
 resumed from a previously yielded `resume_token`. For the above sequence of
 `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
 yields results from the `PartialResultSet` with value "orl".
      repeated .google.protobuf.Value values = 2;
      Specified by:
      getValuesCount in interface PartialResultSetOrBuilder

    • getValues

      public com.google.protobuf.Value getValues(int index)
       A streamed result set consists of a stream of values, which might
 be split into many `PartialResultSet` messages to accommodate
 large rows and/or large values. Every N complete values defines a
 row, where N is equal to the number of entries in
 [metadata.row_type.fields][google.spanner.v1.StructType.fields].

 Most values are encoded based on type as described
 [here][google.spanner.v1.TypeCode].

 It's possible that the last value in values is "chunked",
 meaning that the rest of the value is sent in subsequent
 `PartialResultSet`(s). This is denoted by the
 [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
 Two or more chunked values can be merged to form a complete value as
 follows:

   * `bool/number/null`: can't be chunked
   * `string`: concatenate the strings
   * `list`: concatenate the lists. If the last element in a list is a
     `string`, `list`, or `object`, merge it with the first element in
     the next list by applying these rules recursively.
   * `object`: concatenate the (field name, field value) pairs. If a
     field name is duplicated, then apply these rules recursively
     to merge the field values.

 Some examples of merging:

     Strings are concatenated.
     "foo", "bar" => "foobar"

     Lists of non-strings are concatenated.
     [2, 3], [4] => [2, 3, 4]

     Lists are concatenated, but the last and first elements are merged
     because they are strings.
     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]

     Lists are concatenated, but the last and first elements are merged
     because they are lists. Recursively, the last and first elements
     of the inner lists are merged because they are strings.
     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]

     Non-overlapping object fields are combined.
     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}

     Overlapping object fields are merged.
     {"a": "1"}, {"a": "2"} => {"a": "12"}

     Examples of merging objects containing lists of strings.
     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}

 For a more complete example, suppose a streaming SQL query is
 yielding a result set whose rows contain a single string
 field. The following `PartialResultSet`s might be yielded:

     {
       "metadata": { ... }
       "values": ["Hello", "W"]
       "chunked_value": true
       "resume_token": "Af65..."
     }
     {
       "values": ["orl"]
       "chunked_value": true
     }
     {
       "values": ["d"]
       "resume_token": "Zx1B..."
     }

 This sequence of `PartialResultSet`s encodes two rows, one
 containing the field value `"Hello"`, and a second containing the
 field value `"World" = "W" + "orl" + "d"`.

 Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
 resumed from a previously yielded `resume_token`. For the above sequence of
 `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
 yields results from the `PartialResultSet` with value "orl".
      repeated .google.protobuf.Value values = 2;
      Specified by:
      getValues in interface PartialResultSetOrBuilder

    • getValuesOrBuilder

      public com.google.protobuf.ValueOrBuilder getValuesOrBuilder(int index)
       A streamed result set consists of a stream of values, which might
 be split into many `PartialResultSet` messages to accommodate
 large rows and/or large values. Every N complete values defines a
 row, where N is equal to the number of entries in
 [metadata.row_type.fields][google.spanner.v1.StructType.fields].

 Most values are encoded based on type as described
 [here][google.spanner.v1.TypeCode].

 It's possible that the last value in values is "chunked",
 meaning that the rest of the value is sent in subsequent
 `PartialResultSet`(s). This is denoted by the
 [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
 Two or more chunked values can be merged to form a complete value as
 follows:

   * `bool/number/null`: can't be chunked
   * `string`: concatenate the strings
   * `list`: concatenate the lists. If the last element in a list is a
     `string`, `list`, or `object`, merge it with the first element in
     the next list by applying these rules recursively.
   * `object`: concatenate the (field name, field value) pairs. If a
     field name is duplicated, then apply these rules recursively
     to merge the field values.

 Some examples of merging:

     Strings are concatenated.
     "foo", "bar" => "foobar"

     Lists of non-strings are concatenated.
     [2, 3], [4] => [2, 3, 4]

     Lists are concatenated, but the last and first elements are merged
     because they are strings.
     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]

     Lists are concatenated, but the last and first elements are merged
     because they are lists. Recursively, the last and first elements
     of the inner lists are merged because they are strings.
     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]

     Non-overlapping object fields are combined.
     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}

     Overlapping object fields are merged.
     {"a": "1"}, {"a": "2"} => {"a": "12"}

     Examples of merging objects containing lists of strings.
     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}

 For a more complete example, suppose a streaming SQL query is
 yielding a result set whose rows contain a single string
 field. The following `PartialResultSet`s might be yielded:

     {
       "metadata": { ... }
       "values": ["Hello", "W"]
       "chunked_value": true
       "resume_token": "Af65..."
     }
     {
       "values": ["orl"]
       "chunked_value": true
     }
     {
       "values": ["d"]
       "resume_token": "Zx1B..."
     }

 This sequence of `PartialResultSet`s encodes two rows, one
 containing the field value `"Hello"`, and a second containing the
 field value `"World" = "W" + "orl" + "d"`.

 Not all `PartialResultSet`s contain a `resume_token`. Execution can only be
 resumed from a previously yielded `resume_token`. For the above sequence of
 `PartialResultSet`s, resuming the query with `"resume_token": "Af65..."`
 yields results from the `PartialResultSet` with value "orl".
      repeated .google.protobuf.Value values = 2;
      Specified by:
      getValuesOrBuilder in interface PartialResultSetOrBuilder

    • getChunkedValue

      public boolean getChunkedValue()
       If true, then the final value in
 [values][google.spanner.v1.PartialResultSet.values] is chunked, and must be
 combined with more values from subsequent `PartialResultSet`s to obtain a
 complete field value.
      bool chunked_value = 3;
      Specified by:
      getChunkedValue in interface PartialResultSetOrBuilder
      Returns:
      The chunkedValue.

    • getResumeToken

      public com.google.protobuf.ByteString getResumeToken()
       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
 `resume_token`. Note that executing any other transaction in the
 same session invalidates the token.
      bytes resume_token = 4;
      Specified by:
      getResumeToken in interface PartialResultSetOrBuilder
      Returns:
      The resumeToken.

    • hasStats

      public boolean hasStats()
       Query plan and execution statistics for the statement that produced this
 streaming result set. These can be requested by setting
 [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode]
 and are sent only once with the last response in the stream. This field is
 also present in the last response for DML statements.
      .google.spanner.v1.ResultSetStats stats = 5;
      Specified by:
      hasStats in interface PartialResultSetOrBuilder
      Returns:
      Whether the stats field is set.

    • getStats

      public ResultSetStats getStats()
       Query plan and execution statistics for the statement that produced this
 streaming result set. These can be requested by setting
 [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode]
 and are sent only once with the last response in the stream. This field is
 also present in the last response for DML statements.
      .google.spanner.v1.ResultSetStats stats = 5;
      Specified by:
      getStats in interface PartialResultSetOrBuilder
      Returns:
      The stats.

    • getStatsOrBuilder

      public ResultSetStatsOrBuilder getStatsOrBuilder()
       Query plan and execution statistics for the statement that produced this
 streaming result set. These can be requested by setting
 [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode]
 and are sent only once with the last response in the stream. This field is
 also present in the last response for DML statements.
      .google.spanner.v1.ResultSetStats stats = 5;
      Specified by:
      getStatsOrBuilder in interface PartialResultSetOrBuilder

    • hasPrecommitToken

      public boolean hasPrecommitToken()
       Optional. A precommit token is included if the read-write transaction
 has multiplexed sessions enabled. Pass the precommit token with the highest
 sequence number from this transaction attempt to the
 [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
      .google.spanner.v1.MultiplexedSessionPrecommitToken precommit_token = 8 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      hasPrecommitToken in interface PartialResultSetOrBuilder
      Returns:
      Whether the precommitToken field is set.

    • getPrecommitToken

      public MultiplexedSessionPrecommitToken getPrecommitToken()
       Optional. A precommit token is included if the read-write transaction
 has multiplexed sessions enabled. Pass the precommit token with the highest
 sequence number from this transaction attempt to the
 [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
      .google.spanner.v1.MultiplexedSessionPrecommitToken precommit_token = 8 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getPrecommitToken in interface PartialResultSetOrBuilder
      Returns:
      The precommitToken.

    • getPrecommitTokenOrBuilder

      public MultiplexedSessionPrecommitTokenOrBuilder getPrecommitTokenOrBuilder()
       Optional. A precommit token is included if the read-write transaction
 has multiplexed sessions enabled. Pass the precommit token with the highest
 sequence number from this transaction attempt to the
 [Commit][google.spanner.v1.Spanner.Commit] request for this transaction.
      .google.spanner.v1.MultiplexedSessionPrecommitToken precommit_token = 8 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getPrecommitTokenOrBuilder in interface PartialResultSetOrBuilder

    • getLast

      public boolean getLast()
       Optional. Indicates whether this is the last `PartialResultSet` in the
 stream. The server might optionally set this field. Clients shouldn't rely
 on this field being set in all cases.
      bool last = 9 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getLast in interface PartialResultSetOrBuilder
      Returns:
      The last.

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessageV3

    • writeTo

      public void writeTo(com.google.protobuf.CodedOutputStream output) throws IOException
      Specified by:
      writeTo in interface com.google.protobuf.MessageLite
      Overrides:
      writeTo in class com.google.protobuf.GeneratedMessageV3
      Throws:
      IOException

    • getSerializedSize

      public int getSerializedSize()
      Specified by:
      getSerializedSize in interface com.google.protobuf.MessageLite
      Overrides:
      getSerializedSize in class com.google.protobuf.GeneratedMessageV3

    • equals

      public boolean equals(Object obj)
      Specified by:
      equals in interface com.google.protobuf.Message
      Overrides:
      equals in class com.google.protobuf.AbstractMessage

    • hashCode

      public int hashCode()
      Specified by:
      hashCode in interface com.google.protobuf.Message
      Overrides:
      hashCode in class com.google.protobuf.AbstractMessage

    • parseFrom

      public static PartialResultSet parseFrom(ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(com.google.protobuf.ByteString data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(byte[] data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static PartialResultSet parseFrom(InputStream input) throws IOException
      Throws:
      IOException

    • parseFrom

      public static PartialResultSet parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • parseDelimitedFrom

      public static PartialResultSet parseDelimitedFrom(InputStream input) throws IOException
      Throws:
      IOException

    • parseDelimitedFrom

      public static PartialResultSet parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • parseFrom

      public static PartialResultSet parseFrom(com.google.protobuf.CodedInputStream input) throws IOException
      Throws:
      IOException

    • parseFrom

      public static PartialResultSet parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • newBuilderForType

      public PartialResultSet.Builder newBuilderForType()
      Specified by:
      newBuilderForType in interface com.google.protobuf.Message
      Specified by:
      newBuilderForType in interface com.google.protobuf.MessageLite

    • newBuilder

      public static PartialResultSet.Builder newBuilder()

    • newBuilder

      public static PartialResultSet.Builder newBuilder(PartialResultSet prototype)

    • toBuilder

      public PartialResultSet.Builder toBuilder()
      Specified by:
      toBuilder in interface com.google.protobuf.Message
      Specified by:
      toBuilder in interface com.google.protobuf.MessageLite

    • newBuilderForType

      protected PartialResultSet.Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
      Specified by:
      newBuilderForType in class com.google.protobuf.GeneratedMessageV3

    • getDefaultInstance

      public static PartialResultSet getDefaultInstance()

    • parser

      public static com.google.protobuf.Parser<PartialResultSet> parser()

    • getParserForType

      public com.google.protobuf.Parser<PartialResultSet> getParserForType()
      Specified by:
      getParserForType in interface com.google.protobuf.Message
      Specified by:
      getParserForType in interface com.google.protobuf.MessageLite
      Overrides:
      getParserForType in class com.google.protobuf.GeneratedMessageV3

    • getDefaultInstanceForType

      public PartialResultSet getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder