Cloud Datastore V1 Client - Class QueryResultBatch (1.17.1)

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

A batch of results produced by a query.

Generated from protobuf message google.datastore.v1.QueryResultBatch

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ skipped_results int

The number of results skipped, typically because of an offset.

↳ skipped_cursor string

A cursor that points to the position after the last skipped result. Will be set when skipped_results != 0.

↳ entity_result_type int

The result type for every entity in entity_results.

↳ entity_results array<Google\Cloud\Datastore\V1\EntityResult>

The results for this batch.

↳ end_cursor string

A cursor that points to the position after the last result in the batch.

↳ more_results int

The state of the query after the current batch.

↳ snapshot_version int|string

The version number of the snapshot this batch was returned from. This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater snapshot version number. Each batch's snapshot version is valid for all preceding batches. The value will be zero for eventually consistent queries.

↳ read_time Google\Protobuf\Timestamp

Read timestamp this batch was returned from. This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater timestamp. Each batch's read timestamp is valid for all preceding batches. This value will not be set for eventually consistent queries in Cloud Datastore.

getSkippedResults

The number of results skipped, typically because of an offset.

Generated from protobuf field int32 skipped_results = 6;

Returns
TypeDescription
int

setSkippedResults

The number of results skipped, typically because of an offset.

Generated from protobuf field int32 skipped_results = 6;

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getSkippedCursor

A cursor that points to the position after the last skipped result.

Will be set when skipped_results != 0.

Generated from protobuf field bytes skipped_cursor = 3;

Returns
TypeDescription
string

setSkippedCursor

A cursor that points to the position after the last skipped result.

Will be set when skipped_results != 0.

Generated from protobuf field bytes skipped_cursor = 3;

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEntityResultType

The result type for every entity in entity_results.

Generated from protobuf field .google.datastore.v1.EntityResult.ResultType entity_result_type = 1;

Returns
TypeDescription
int

setEntityResultType

The result type for every entity in entity_results.

Generated from protobuf field .google.datastore.v1.EntityResult.ResultType entity_result_type = 1;

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getEntityResults

The results for this batch.

Generated from protobuf field repeated .google.datastore.v1.EntityResult entity_results = 2;

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setEntityResults

The results for this batch.

Generated from protobuf field repeated .google.datastore.v1.EntityResult entity_results = 2;

Parameter
NameDescription
var array<Google\Cloud\Datastore\V1\EntityResult>
Returns
TypeDescription
$this

getEndCursor

A cursor that points to the position after the last result in the batch.

Generated from protobuf field bytes end_cursor = 4;

Returns
TypeDescription
string

setEndCursor

A cursor that points to the position after the last result in the batch.

Generated from protobuf field bytes end_cursor = 4;

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getMoreResults

The state of the query after the current batch.

Generated from protobuf field .google.datastore.v1.QueryResultBatch.MoreResultsType more_results = 5;

Returns
TypeDescription
int

setMoreResults

The state of the query after the current batch.

Generated from protobuf field .google.datastore.v1.QueryResultBatch.MoreResultsType more_results = 5;

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getSnapshotVersion

The version number of the snapshot this batch was returned from.

This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater snapshot version number. Each batch's snapshot version is valid for all preceding batches. The value will be zero for eventually consistent queries.

Generated from protobuf field int64 snapshot_version = 7;

Returns
TypeDescription
int|string

setSnapshotVersion

The version number of the snapshot this batch was returned from.

This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater snapshot version number. Each batch's snapshot version is valid for all preceding batches. The value will be zero for eventually consistent queries.

Generated from protobuf field int64 snapshot_version = 7;

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getReadTime

Read timestamp this batch was returned from.

This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater timestamp. Each batch's read timestamp is valid for all preceding batches. This value will not be set for eventually consistent queries in Cloud Datastore.

Generated from protobuf field .google.protobuf.Timestamp read_time = 8;

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasReadTime

clearReadTime

setReadTime

Read timestamp this batch was returned from.

This applies to the range of results from the query's start_cursor (or the beginning of the query if no cursor was given) to this batch's end_cursor (not the query's end_cursor). In a single transaction, subsequent query result batches for the same query can have a greater timestamp. Each batch's read timestamp is valid for all preceding batches. This value will not be set for eventually consistent queries in Cloud Datastore.

Generated from protobuf field .google.protobuf.Timestamp read_time = 8;

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