Cloud Bigtable V2 Client - Class CellChunk (1.23.0)

Reference documentation and code samples for the Cloud Bigtable V2 Client class CellChunk.

Specifies a piece of a row's contents returned as part of the read response stream.

Generated from protobuf message google.bigtable.v2.ReadRowsResponse.CellChunk

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ row_key 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.

↳ family_name 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.

↳ qualifier 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.

↳ timestamp_micros int|string

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

↳ labels array

Labels applied to the cell by a RowFilter. Labels are only set on the first CellChunk per cell.

↳ value 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.

↳ value_size int

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.

↳ reset_row bool

Indicates that the client should drop all previous chunks for row_key, as it will be re-read from the beginning.

↳ commit_row bool

Indicates that the client can safely process all previous chunks for row_key, as its data has been fully read.

getRowKey

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.

Returns
TypeDescription
string

setRowKey

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.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getFamilyName

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.

Returns
TypeDescription
Google\Protobuf\StringValue|null

hasFamilyName

clearFamilyName

getFamilyNameValue

Returns the unboxed value from getFamilyName()

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.

Returns
TypeDescription
string|null

setFamilyName

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.

Parameter
NameDescription
var Google\Protobuf\StringValue
Returns
TypeDescription
$this

setFamilyNameValue

Sets the field by wrapping a primitive type in a Google\Protobuf\StringValue object.

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.

Parameter
NameDescription
var string|null
Returns
TypeDescription
$this

getQualifier

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.

Returns
TypeDescription
Google\Protobuf\BytesValue|null

hasQualifier

clearQualifier

getQualifierValue

Returns the unboxed value from getQualifier()

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.

Returns
TypeDescription
string|null

setQualifier

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.

Parameter
NameDescription
var Google\Protobuf\BytesValue
Returns
TypeDescription
$this

setQualifierValue

Sets the field by wrapping a primitive type in a Google\Protobuf\BytesValue object.

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.

Parameter
NameDescription
var string|null
Returns
TypeDescription
$this

getTimestampMicros

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

  1. Timestamps are only set in the first CellChunk per cell (for cells split into multiple chunks).
Returns
TypeDescription
int|string

setTimestampMicros

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

  1. Timestamps are only set in the first CellChunk per cell (for cells split into multiple chunks).
Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getLabels

Labels applied to the cell by a RowFilter. Labels are only set on the first CellChunk per cell.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setLabels

Labels applied to the cell by a RowFilter. Labels are only set on the first CellChunk per cell.

Parameter
NameDescription
var string[]
Returns
TypeDescription
$this

getValue

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.

Returns
TypeDescription
string

setValue

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.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getValueSize

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.

Returns
TypeDescription
int

setValueSize

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.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getResetRow

Indicates that the client should drop all previous chunks for row_key, as it will be re-read from the beginning.

Returns
TypeDescription
bool

hasResetRow

setResetRow

Indicates that the client should drop all previous chunks for row_key, as it will be re-read from the beginning.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getCommitRow

Indicates that the client can safely process all previous chunks for row_key, as its data has been fully read.

Returns
TypeDescription
bool

hasCommitRow

setCommitRow

Indicates that the client can safely process all previous chunks for row_key, as its data has been fully read.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getRowStatus

Returns
TypeDescription
string