Cloud Datastore V1 Client - Class Mutation (1.31.0)

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 Google\Cloud\Datastore\V1\Entity

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

↳ update Google\Cloud\Datastore\V1\Entity

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

↳ upsert Google\Cloud\Datastore\V1\Entity

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

↳ delete Google\Cloud\Datastore\V1\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 Google\Cloud\Datastore\V1\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<Google\Cloud\Datastore\V1\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
Google\Cloud\Datastore\V1\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 Google\Cloud\Datastore\V1\Entity
Returns
Type Description
$this

getUpdate

The entity to update. The entity must already exist.

Must have a complete key path.

Returns
Type Description
Google\Cloud\Datastore\V1\Entity|null

hasUpdate

setUpdate

The entity to update. The entity must already exist.

Must have a complete key path.

Parameter
Name Description
var Google\Cloud\Datastore\V1\Entity
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
Google\Cloud\Datastore\V1\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 Google\Cloud\Datastore\V1\Entity
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
Google\Cloud\Datastore\V1\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 Google\Cloud\Datastore\V1\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
Google\Protobuf\Timestamp|null

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
var Google\Protobuf\Timestamp
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
Google\Cloud\Datastore\V1\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
var Google\Cloud\Datastore\V1\PropertyMask
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
Google\Protobuf\Internal\RepeatedField

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 array<Google\Cloud\Datastore\V1\PropertyTransform>
Returns
Type Description
$this

getOperation

Returns
Type Description
string

getConflictDetectionStrategy

Returns
Type Description
string