Package com.google.spanner.v1

Class PartialResultSet.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>
com.google.spanner.v1.PartialResultSet.Builder
All Implemented Interfaces:
com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, PartialResultSetOrBuilder, Cloneable
Enclosing class:
PartialResultSet
public static final class PartialResultSet.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder> 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

  • Method Details

    • 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.Builder<PartialResultSet.Builder>

    • clear

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

    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • getDefaultInstanceForType

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

    • build

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

    • buildPartial

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

    • clone

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

    • setField

      public PartialResultSet.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      setField in interface com.google.protobuf.Message.Builder
      Overrides:
      setField in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • clearField

      public PartialResultSet.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
      Specified by:
      clearField in interface com.google.protobuf.Message.Builder
      Overrides:
      clearField in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • clearOneof

      public PartialResultSet.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
      Specified by:
      clearOneof in interface com.google.protobuf.Message.Builder
      Overrides:
      clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • setRepeatedField

      public PartialResultSet.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
      Specified by:
      setRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • addRepeatedField

      public PartialResultSet.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      addRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • mergeFrom

      public PartialResultSet.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<PartialResultSet.Builder>

    • mergeFrom

      public PartialResultSet.Builder mergeFrom(PartialResultSet other)

    • isInitialized

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

    • mergeFrom

      public PartialResultSet.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<PartialResultSet.Builder>
      Throws:
      IOException

    • 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.

    • setMetadata

      public PartialResultSet.Builder setMetadata(ResultSetMetadata value)
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;

    • setMetadata

      public PartialResultSet.Builder setMetadata(ResultSetMetadata.Builder builderForValue)
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;

    • mergeMetadata

      public PartialResultSet.Builder mergeMetadata(ResultSetMetadata value)
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;

    • clearMetadata

      public PartialResultSet.Builder clearMetadata()
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;

    • getMetadataBuilder

      public ResultSetMetadata.Builder getMetadataBuilder()
       Metadata about the result set, such as row type information.
 Only present in the first response.
      .google.spanner.v1.ResultSetMetadata metadata = 1;

    • 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

    • 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

    • setValues

      public PartialResultSet.Builder setValues(int index, com.google.protobuf.Value value)
       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;

    • setValues

      public PartialResultSet.Builder setValues(int index, com.google.protobuf.Value.Builder builderForValue)
       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;

    • addValues

      public PartialResultSet.Builder addValues(com.google.protobuf.Value value)
       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;

    • addValues

      public PartialResultSet.Builder addValues(int index, com.google.protobuf.Value value)
       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;

    • addValues

      public PartialResultSet.Builder addValues(com.google.protobuf.Value.Builder builderForValue)
       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;

    • addValues

      public PartialResultSet.Builder addValues(int index, com.google.protobuf.Value.Builder builderForValue)
       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;

    • addAllValues

      public PartialResultSet.Builder addAllValues(Iterable<? extends com.google.protobuf.Value> values)
       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;

    • clearValues

      public PartialResultSet.Builder clearValues()
       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;

    • removeValues

      public PartialResultSet.Builder removeValues(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;

    • getValuesBuilder

      public com.google.protobuf.Value.Builder getValuesBuilder(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;

    • 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

    • 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

    • addValuesBuilder

      public com.google.protobuf.Value.Builder addValuesBuilder()
       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;

    • addValuesBuilder

      public com.google.protobuf.Value.Builder addValuesBuilder(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;

    • getValuesBuilderList

      public List<com.google.protobuf.Value.Builder> getValuesBuilderList()
       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;

    • 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.

    • setChunkedValue

      public PartialResultSet.Builder setChunkedValue(boolean value)
       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;
      Parameters:
      value - The chunkedValue to set.
      Returns:
      This builder for chaining.

    • clearChunkedValue

      public PartialResultSet.Builder clearChunkedValue()
       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;
      Returns:
      This builder for chaining.

    • 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.

    • setResumeToken

      public PartialResultSet.Builder setResumeToken(com.google.protobuf.ByteString value)
       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;
      Parameters:
      value - The resumeToken to set.
      Returns:
      This builder for chaining.

    • clearResumeToken

      public PartialResultSet.Builder clearResumeToken()
       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;
      Returns:
      This builder for chaining.

    • 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.

    • setStats

      public PartialResultSet.Builder setStats(ResultSetStats value)
       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;

    • setStats

      public PartialResultSet.Builder setStats(ResultSetStats.Builder builderForValue)
       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;

    • mergeStats

      public PartialResultSet.Builder mergeStats(ResultSetStats value)
       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;

    • clearStats

      public PartialResultSet.Builder clearStats()
       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;

    • getStatsBuilder

      public ResultSetStats.Builder getStatsBuilder()
       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;

    • 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.

    • setPrecommitToken

      public PartialResultSet.Builder setPrecommitToken(MultiplexedSessionPrecommitToken value)
       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];

    • setPrecommitToken

      public PartialResultSet.Builder setPrecommitToken(MultiplexedSessionPrecommitToken.Builder builderForValue)
       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];

    • mergePrecommitToken

      public PartialResultSet.Builder mergePrecommitToken(MultiplexedSessionPrecommitToken value)
       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];

    • clearPrecommitToken

      public PartialResultSet.Builder clearPrecommitToken()
       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];

    • getPrecommitTokenBuilder

      public MultiplexedSessionPrecommitToken.Builder getPrecommitTokenBuilder()
       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];

    • 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.

    • setLast

      public PartialResultSet.Builder setLast(boolean value)
       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];
      Parameters:
      value - The last to set.
      Returns:
      This builder for chaining.

    • clearLast

      public PartialResultSet.Builder clearLast()
       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];
      Returns:
      This builder for chaining.

    • setUnknownFields

      public final PartialResultSet.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      setUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>

    • mergeUnknownFields

      public final PartialResultSet.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      mergeUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<PartialResultSet.Builder>