Cloud Bigtable V2 Client - Class CheckAndMutateRowRequest (1.24.1)

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

Request message for Bigtable.CheckAndMutateRow.

Generated from protobuf message google.bigtable.v2.CheckAndMutateRowRequest

Namespace

Google \ Cloud \ Bigtable \ V2

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ table_name string

Required. The unique name of the table to which the conditional mutation should be applied. Values are of the form projects/<project>/instances/<instance>/tables/<table>.

↳ app_profile_id string

This value specifies routing for replication. If not specified, the "default" application profile will be used.

↳ row_key string

Required. The key of the row to which the conditional mutation should be applied.

↳ predicate_filter Google\Cloud\Bigtable\V2\RowFilter

The filter to be applied to the contents of the specified row. Depending on whether or not any results are yielded, either true_mutations or false_mutations will be executed. If unset, checks that the row contains any values at all.

↳ true_mutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter yields at least one cell when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if false_mutations is empty, and at most 100000.

↳ false_mutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter does not yield any cells when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if true_mutations is empty, and at most 100000.

getTableName

Required. The unique name of the table to which the conditional mutation should be applied. Values are of the form projects/<project>/instances/<instance>/tables/<table>.

Returns
TypeDescription
string

setTableName

Required. The unique name of the table to which the conditional mutation should be applied. Values are of the form projects/<project>/instances/<instance>/tables/<table>.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAppProfileId

This value specifies routing for replication. If not specified, the "default" application profile will be used.

Returns
TypeDescription
string

setAppProfileId

This value specifies routing for replication. If not specified, the "default" application profile will be used.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRowKey

Required. The key of the row to which the conditional mutation should be applied.

Returns
TypeDescription
string

setRowKey

Required. The key of the row to which the conditional mutation should be applied.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getPredicateFilter

The filter to be applied to the contents of the specified row. Depending on whether or not any results are yielded, either true_mutations or false_mutations will be executed. If unset, checks that the row contains any values at all.

Returns
TypeDescription
Google\Cloud\Bigtable\V2\RowFilter|null

hasPredicateFilter

clearPredicateFilter

setPredicateFilter

The filter to be applied to the contents of the specified row. Depending on whether or not any results are yielded, either true_mutations or false_mutations will be executed. If unset, checks that the row contains any values at all.

Parameter
NameDescription
var Google\Cloud\Bigtable\V2\RowFilter
Returns
TypeDescription
$this

getTrueMutations

Changes to be atomically applied to the specified row if predicate_filter yields at least one cell when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones.

Must contain at least one entry if false_mutations is empty, and at most 100000.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setTrueMutations

Changes to be atomically applied to the specified row if predicate_filter yields at least one cell when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones.

Must contain at least one entry if false_mutations is empty, and at most 100000.

Parameter
NameDescription
var array<Google\Cloud\Bigtable\V2\Mutation>
Returns
TypeDescription
$this

getFalseMutations

Changes to be atomically applied to the specified row if predicate_filter does not yield any cells when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones.

Must contain at least one entry if true_mutations is empty, and at most 100000.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setFalseMutations

Changes to be atomically applied to the specified row if predicate_filter does not yield any cells when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones.

Must contain at least one entry if true_mutations is empty, and at most 100000.

Parameter
NameDescription
var array<Google\Cloud\Bigtable\V2\Mutation>
Returns
TypeDescription
$this

static::build

Parameters
NameDescription
tableName string

Required. The unique name of the table to which the conditional mutation should be applied. Values are of the form projects/<project>/instances/<instance>/tables/<table>. Please see Google\Cloud\Bigtable\V2\BigtableClient::tableName() for help formatting this field.

rowKey string

Required. The key of the row to which the conditional mutation should be applied.

predicateFilter Google\Cloud\Bigtable\V2\RowFilter

The filter to be applied to the contents of the specified row. Depending on whether or not any results are yielded, either true_mutations or false_mutations will be executed. If unset, checks that the row contains any values at all.

trueMutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter yields at least one cell when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if false_mutations is empty, and at most 100000.

falseMutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter does not yield any cells when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if true_mutations is empty, and at most 100000.

Returns
TypeDescription
Google\Cloud\Bigtable\V2\CheckAndMutateRowRequest

static::buildFromTableNameRowKeyPredicateFilterTrueMutationsFalseMutationsAppProfileId

Parameters
NameDescription
tableName string

Required. The unique name of the table to which the conditional mutation should be applied. Values are of the form projects/<project>/instances/<instance>/tables/<table>. Please see Google\Cloud\Bigtable\V2\BigtableClient::tableName() for help formatting this field.

rowKey string

Required. The key of the row to which the conditional mutation should be applied.

predicateFilter Google\Cloud\Bigtable\V2\RowFilter

The filter to be applied to the contents of the specified row. Depending on whether or not any results are yielded, either true_mutations or false_mutations will be executed. If unset, checks that the row contains any values at all.

trueMutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter yields at least one cell when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if false_mutations is empty, and at most 100000.

falseMutations array<Google\Cloud\Bigtable\V2\Mutation>

Changes to be atomically applied to the specified row if predicate_filter does not yield any cells when applied to row_key. Entries are applied in order, meaning that earlier mutations can be masked by later ones. Must contain at least one entry if true_mutations is empty, and at most 100000.

appProfileId string

This value specifies routing for replication. If not specified, the "default" application profile will be used.

Returns
TypeDescription
Google\Cloud\Bigtable\V2\CheckAndMutateRowRequest