Class: Google::Bigtable::V2::ReadRowsResponse

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/bigtable.rb

Overview

Response message for Bigtable.ReadRows.

Defined Under Namespace

Classes: CellChunk

Instance Attribute Summary collapse

Instance Attribute Details

#chunks ⇒ Array<Google::Bigtable::V2::ReadRowsResponse::CellChunk>

Returns:



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/bigtable.rb', line 53

class ReadRowsResponse
  # Specifies a piece of a row's contents returned as part of the read
  # response stream.
  # @!attribute [rw] row_key
  #   @return [String]
  #     The row key for this chunk of data.  If the row key is empty,
  #     this CellChunk is a continuation of the same row as the previous
  #     CellChunk in the response stream, even if that CellChunk was in a
  #     previous ReadRowsResponse message.
  # @!attribute [rw] family_name
  #   @return [Google::Protobuf::StringValue]
  #     The column family name for this chunk of data.  If this message
  #     is not present this CellChunk is a continuation of the same column
  #     family as the previous CellChunk.  The empty string can occur as a
  #     column family name in a response so clients must check
  #     explicitly for the presence of this message, not just for
  #     +family_name.value+ being non-empty.
  # @!attribute [rw] qualifier
  #   @return [Google::Protobuf::BytesValue]
  #     The column qualifier for this chunk of data.  If this message
  #     is not present, this CellChunk is a continuation of the same column
  #     as the previous CellChunk.  Column qualifiers may be empty so
  #     clients must check for the presence of this message, not just
  #     for +qualifier.value+ being non-empty.
  # @!attribute [rw] timestamp_micros
  #   @return [Integer]
  #     The cell's stored timestamp, which also uniquely identifies it
  #     within its column.  Values are always expressed in
  #     microseconds, but individual tables may set a coarser
  #     granularity to further restrict the allowed values. For
  #     example, a table which specifies millisecond granularity will
  #     only allow values of +timestamp_micros+ which are multiples of
  #     1000.  Timestamps are only set in the first CellChunk per cell
  #     (for cells split into multiple chunks).
  # @!attribute [rw] labels
  #   @return [Array<String>]
  #     Labels applied to the cell by a
  #     {Google::Bigtable::V2::RowFilter RowFilter}.  Labels are only set
  #     on the first CellChunk per cell.
  # @!attribute [rw] value
  #   @return [String]
  #     The value stored in the cell.  Cell values can be split across
  #     multiple CellChunks.  In that case only the value field will be
  #     set in CellChunks after the first: the timestamp and labels
  #     will only be present in the first CellChunk, even if the first
  #     CellChunk came in a previous ReadRowsResponse.
  # @!attribute [rw] value_size
  #   @return [Integer]
  #     If this CellChunk is part of a chunked cell value and this is
  #     not the final chunk of that cell, value_size will be set to the
  #     total length of the cell value.  The client can use this size
  #     to pre-allocate memory to hold the full cell value.
  # @!attribute [rw] reset_row
  #   @return [true, false]
  #     Indicates that the client should drop all previous chunks for
  #     +row_key+, as it will be re-read from the beginning.
  # @!attribute [rw] commit_row
  #   @return [true, false]
  #     Indicates that the client can safely process all previous chunks for
  #     +row_key+, as its data has been fully read.
  class CellChunk; end
end

#last_scanned_row_key ⇒ String

Returns Optionally the server might return the row key of the last row it has scanned. The client can use this to construct a more efficient retry request if needed: any row keys or portions of ranges less than this row key can be dropped from the request. This is primarily useful for cases where the server has read a lot of data that was filtered out since the last committed row key, allowing the client to skip that work on a retry.

Returns:

  • (String) —

    Optionally the server might return the row key of the last row it has scanned. The client can use this to construct a more efficient retry request if needed: any row keys or portions of ranges less than this row key can be dropped from the request. This is primarily useful for cases where the server has read a lot of data that was filtered out since the last committed row key, allowing the client to skip that work on a retry.



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/bigtable.rb', line 53

class ReadRowsResponse
  # Specifies a piece of a row's contents returned as part of the read
  # response stream.
  # @!attribute [rw] row_key
  #   @return [String]
  #     The row key for this chunk of data.  If the row key is empty,
  #     this CellChunk is a continuation of the same row as the previous
  #     CellChunk in the response stream, even if that CellChunk was in a
  #     previous ReadRowsResponse message.
  # @!attribute [rw] family_name
  #   @return [Google::Protobuf::StringValue]
  #     The column family name for this chunk of data.  If this message
  #     is not present this CellChunk is a continuation of the same column
  #     family as the previous CellChunk.  The empty string can occur as a
  #     column family name in a response so clients must check
  #     explicitly for the presence of this message, not just for
  #     +family_name.value+ being non-empty.
  # @!attribute [rw] qualifier
  #   @return [Google::Protobuf::BytesValue]
  #     The column qualifier for this chunk of data.  If this message
  #     is not present, this CellChunk is a continuation of the same column
  #     as the previous CellChunk.  Column qualifiers may be empty so
  #     clients must check for the presence of this message, not just
  #     for +qualifier.value+ being non-empty.
  # @!attribute [rw] timestamp_micros
  #   @return [Integer]
  #     The cell's stored timestamp, which also uniquely identifies it
  #     within its column.  Values are always expressed in
  #     microseconds, but individual tables may set a coarser
  #     granularity to further restrict the allowed values. For
  #     example, a table which specifies millisecond granularity will
  #     only allow values of +timestamp_micros+ which are multiples of
  #     1000.  Timestamps are only set in the first CellChunk per cell
  #     (for cells split into multiple chunks).
  # @!attribute [rw] labels
  #   @return [Array<String>]
  #     Labels applied to the cell by a
  #     {Google::Bigtable::V2::RowFilter RowFilter}.  Labels are only set
  #     on the first CellChunk per cell.
  # @!attribute [rw] value
  #   @return [String]
  #     The value stored in the cell.  Cell values can be split across
  #     multiple CellChunks.  In that case only the value field will be
  #     set in CellChunks after the first: the timestamp and labels
  #     will only be present in the first CellChunk, even if the first
  #     CellChunk came in a previous ReadRowsResponse.
  # @!attribute [rw] value_size
  #   @return [Integer]
  #     If this CellChunk is part of a chunked cell value and this is
  #     not the final chunk of that cell, value_size will be set to the
  #     total length of the cell value.  The client can use this size
  #     to pre-allocate memory to hold the full cell value.
  # @!attribute [rw] reset_row
  #   @return [true, false]
  #     Indicates that the client should drop all previous chunks for
  #     +row_key+, as it will be re-read from the beginning.
  # @!attribute [rw] commit_row
  #   @return [true, false]
  #     Indicates that the client can safely process all previous chunks for
  #     +row_key+, as its data has been fully read.
  class CellChunk; end
end