Cloud Firestore V1 Client - Class RunQueryRequest (1.47.1)

Reference documentation and code samples for the Cloud Firestore V1 Client class RunQueryRequest.

The request for Firestore.RunQuery.

Generated from protobuf message google.firestore.v1.RunQueryRequest

Namespace

Google \ Cloud \ Firestore \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ parent`	`string` Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
`↳ structured_query`	`StructuredQuery` A structured query.
`↳ transaction`	`string` Run the query within an already active transaction. The value here is the opaque transaction ID to execute the query in.
`↳ new_transaction`	`TransactionOptions` Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
`↳ read_time`	`Google\Protobuf\Timestamp` Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.
`↳ explain_options`	`ExplainOptions` Optional. Explain options for the query. If set, additional query statistics will be returned. If not, only query results will be returned.

getParent

Required. The parent resource name. In the format: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path}.

For example: projects/my-project/databases/my-database/documents or projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

Returns
Type	Description
`string`

setParent

Required. The parent resource name. In the format: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path}.

For example: projects/my-project/databases/my-database/documents or projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getStructuredQuery

A structured query.

Returns
Type	Description
`StructuredQuery\|null`

hasStructuredQuery

setStructuredQuery

A structured query.

Parameter
Name	Description
`var`	`StructuredQuery`

Returns
Type	Description
`$this`

getTransaction

Run the query within an already active transaction.

The value here is the opaque transaction ID to execute the query in.

Returns
Type	Description
`string`

hasTransaction

setTransaction

Run the query within an already active transaction.

The value here is the opaque transaction ID to execute the query in.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getNewTransaction

Starts a new transaction and reads the documents.

Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.

Returns
Type	Description
`TransactionOptions\|null`

hasNewTransaction

setNewTransaction

Starts a new transaction and reads the documents.

Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.

Parameter
Name	Description
`var`	`TransactionOptions`

Returns
Type	Description
`$this`

getReadTime

Reads documents as they were at the given time.

This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasReadTime

setReadTime

Reads documents as they were at the given time.

This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getExplainOptions

Optional. Explain options for the query. If set, additional query statistics will be returned. If not, only query results will be returned.

Returns
Type	Description
`ExplainOptions\|null`

hasExplainOptions

clearExplainOptions

setExplainOptions

Optional. Explain options for the query. If set, additional query statistics will be returned. If not, only query results will be returned.

Parameter
Name	Description
`var`	`ExplainOptions`

Returns
Type	Description
`$this`

getQueryType

Returns
Type	Description
`string`

getConsistencySelector

Returns
Type	Description
`string`