Cloud Datastore V1 Client - Class Mutation (1.33.1)

Reference documentation and code samples for the Cloud Datastore V1 Client class Mutation.

A mutation to apply to an entity.

Generated from protobuf message google.datastore.v1.Mutation

Namespace

Google \ Cloud \ Datastore \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ insert
Entity

The entity to insert. The entity must not already exist. The entity key's final path element may be incomplete.

↳ update
Entity

The entity to update. The entity must already exist. Must have a complete key path.

↳ upsert
Entity

The entity to upsert. The entity may or may not already exist. The entity key's final path element may be incomplete.

↳ delete
Key

The key of the entity to delete. The entity may or may not already exist. Must have a complete key path and must not be reserved/read-only.

↳ base_version
int|string

The version of the entity that this mutation is being applied to. If this does not match the current version on the server, the mutation conflicts.

↳ update_time
Google\Protobuf\Timestamp

The update time of the entity that this mutation is being applied to. If this does not match the current update time on the server, the mutation conflicts.

↳ conflict_resolution_strategy
int

The strategy to use when a conflict is detected. Defaults to SERVER_VALUE . If this is set, then conflict_detection_strategy must also be set.

↳ property_mask
PropertyMask

The properties to write in this mutation. None of the properties in the mask may have a reserved name, except for __key__ . This field is ignored for delete . If the entity already exists, only properties referenced in the mask are updated, others are left untouched. Properties referenced in the mask but not in the entity are deleted.

↳ property_transforms
array< PropertyTransform >

Optional. The transforms to perform on the entity. This field can be set only when the operation is insert , update , or upsert . If present, the transforms are be applied to the entity regardless of the property mask, in order, after the operation.

getInsert

The entity to insert. The entity must not already exist.

The entity key's final path element may be incomplete.

Returns
Type
Description
Entity |null

hasInsert

setInsert

The entity to insert. The entity must not already exist.

The entity key's final path element may be incomplete.

Parameter
Name
Description
var
Returns
Type
Description
$this

getUpdate

The entity to update. The entity must already exist.

Must have a complete key path.

Returns
Type
Description
Entity |null

hasUpdate

setUpdate

The entity to update. The entity must already exist.

Must have a complete key path.

Parameter
Name
Description
var
Returns
Type
Description
$this

getUpsert

The entity to upsert. The entity may or may not already exist.

The entity key's final path element may be incomplete.

Returns
Type
Description
Entity |null

hasUpsert

setUpsert

The entity to upsert. The entity may or may not already exist.

The entity key's final path element may be incomplete.

Parameter
Name
Description
var
Returns
Type
Description
$this

getDelete

The key of the entity to delete. The entity may or may not already exist.

Must have a complete key path and must not be reserved/read-only.

Returns
Type
Description
Key |null

hasDelete

setDelete

The key of the entity to delete. The entity may or may not already exist.

Must have a complete key path and must not be reserved/read-only.

Parameter
Name
Description
var
Key
Returns
Type
Description
$this

getBaseVersion

The version of the entity that this mutation is being applied to. If this does not match the current version on the server, the mutation conflicts.

Returns
Type
Description
int|string

hasBaseVersion

setBaseVersion

The version of the entity that this mutation is being applied to. If this does not match the current version on the server, the mutation conflicts.

Parameter
Name
Description
var
int|string
Returns
Type
Description
$this

getUpdateTime

The update time of the entity that this mutation is being applied to. If this does not match the current update time on the server, the mutation conflicts.

Returns
Type
Description

hasUpdateTime

setUpdateTime

The update time of the entity that this mutation is being applied to. If this does not match the current update time on the server, the mutation conflicts.

Parameter
Name
Description
Returns
Type
Description
$this

getConflictResolutionStrategy

The strategy to use when a conflict is detected. Defaults to SERVER_VALUE .

If this is set, then conflict_detection_strategy must also be set.

Returns
Type
Description
int

setConflictResolutionStrategy

The strategy to use when a conflict is detected. Defaults to SERVER_VALUE .

If this is set, then conflict_detection_strategy must also be set.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getPropertyMask

The properties to write in this mutation.

None of the properties in the mask may have a reserved name, except for __key__ . This field is ignored for delete . If the entity already exists, only properties referenced in the mask are updated, others are left untouched. Properties referenced in the mask but not in the entity are deleted.

Returns
Type
Description
PropertyMask |null

hasPropertyMask

clearPropertyMask

setPropertyMask

The properties to write in this mutation.

None of the properties in the mask may have a reserved name, except for __key__ . This field is ignored for delete . If the entity already exists, only properties referenced in the mask are updated, others are left untouched. Properties referenced in the mask but not in the entity are deleted.

Parameter
Name
Description
Returns
Type
Description
$this

getPropertyTransforms

Optional. The transforms to perform on the entity.

This field can be set only when the operation is insert , update , or upsert . If present, the transforms are be applied to the entity regardless of the property mask, in order, after the operation.

Returns
Type
Description

setPropertyTransforms

Optional. The transforms to perform on the entity.

This field can be set only when the operation is insert , update , or upsert . If present, the transforms are be applied to the entity regardless of the property mask, in order, after the operation.

Parameter
Name
Description
var
Returns
Type
Description
$this

getOperation

Returns
Type
Description
string

getConflictDetectionStrategy

Returns
Type
Description
string
Design a Mobile Site
View Site in Mobile | Classic
Share by: