Documentation

QueryOptions
in package

Table of Contents

$adHoc  : bool|null
$clientContextId  : string|null
$consistentWith  : MutationState|null
$flexIndex  : bool|null
$maxParallelism  : int|null
$metrics  : bool|null
$namedParameters  : array<string|int, mixed>|null
$parentSpan  : RequestSpan|null
$pipelineBatch  : int|null
$pipelineCap  : int|null
$positionalParameters  : array<string|int, mixed>|null
$preserveExpiry  : bool|null
$profile  : string|null
$queryContext  : string|null
$raw  : array<string|int, mixed>|null
$readonly  : bool|null
$scanCap  : int|null
$scanConsistency  : string|null
$scanWaitMilliseconds  : int|null
$timeoutMilliseconds  : int|null
$transcoder  : Transcoder
$useReplica  : bool|null
__construct()  : mixed
adhoc()  : QueryOptions
Sets whether this query is adhoc.
build()  : QueryOptions
Static helper to keep code more readable
clientContextId()  : QueryOptions
Sets the client context id for this query.
consistentWith()  : QueryOptions
Sets the mutation state to achieve consistency with for read your own writes (RYOW).
export()  : array<string|int, mixed>
flexIndex()  : QueryOptions
Sets whether this query allowed to use FlexIndex (full text search integration).
getTranscoder()  : Transcoder
Returns associated transcoder.
maxParallelism()  : QueryOptions
Sets the maximum number of index partitions, for computing aggregation in parallel.
metrics()  : QueryOptions
Sets whether or not to return metrics with the query.
namedParameters()  : QueryOptions
Sets the named parameters for this query.
parentSpan()  : QueryOptions
Sets the parent span.
pipelineBatch()  : QueryOptions
Sets the number of items execution operators can batch for fetch from the KV service.
pipelineCap()  : QueryOptions
Sets the maximum number of items each execution operator can buffer between various operators.
positionalParameters()  : QueryOptions
Sets the positional parameters for this query.
preserveExpiry()  : QueryOptions
Sets whether to tell the query engine to preserve expiration values set on any documents modified by this query.
profile()  : QueryOptions
Sets the query profile mode to use.
raw()  : QueryOptions
Sets any extra query parameters that the SDK does not provide an option for.
readonly()  : QueryOptions
Sets whether this query is readonly.
scanCap()  : QueryOptions
Sets the maximum buffered channel size between the indexer client and the query service for index scans.
scanConsistency()  : QueryOptions
Sets the scan consistency.
scanWait()  : QueryOptions
This is an advanced option, see the query service reference for more information on the proper use and tuning of this option.
scopeName()  : QueryOptions
Associate scope name with query
scopeQualifier()  : QueryOptions
Associate scope qualifier (also known as `query_context`) with the query.
timeout()  : QueryOptions
Sets the operation timeout in milliseconds.
transcoder()  : QueryOptions
Associate custom transcoder with the request.
useReplica()  : QueryOptions
Sets whether the query engine should use replica nodes for KV fetches if the active node is down.

Properties

$clientContextId

private string|null $clientContextId = null

$namedParameters

private array<string|int, mixed>|null $namedParameters = null

$positionalParameters

private array<string|int, mixed>|null $positionalParameters = null

$preserveExpiry

private bool|null $preserveExpiry = null

$scanConsistency

private string|null $scanConsistency = null

$scanWaitMilliseconds

private int|null $scanWaitMilliseconds = null

$timeoutMilliseconds

private int|null $timeoutMilliseconds = null

Methods

__construct()

public __construct() : mixed
Tags
since
4.0.0
Return values
mixed —

adhoc()

Sets whether this query is adhoc.

public adhoc(bool $enabled) : QueryOptions
Parameters
$enabled : bool

whether the query is adhoc

Tags
since
4.0.0
Return values
QueryOptions —

clientContextId()

Sets the client context id for this query.

public clientContextId(string $id) : QueryOptions
Parameters
$id : string

the client context id

Tags
since
4.0.0
Return values
QueryOptions —

export()

public static export(QueryOptions|null $options[, string|null $scopeName = null ][, string|null $bucketName = null ]) : array<string|int, mixed>
Parameters
$options : QueryOptions|null
$scopeName : string|null = null
$bucketName : string|null = null
Return values
array<string|int, mixed> —

flexIndex()

Sets whether this query allowed to use FlexIndex (full text search integration).

public flexIndex(bool $enabled) : QueryOptions
Parameters
$enabled : bool

whether the FlexIndex allowed

Tags
since
4.0.0
Return values
QueryOptions —

maxParallelism()

Sets the maximum number of index partitions, for computing aggregation in parallel.

public maxParallelism(int $max) : QueryOptions
Parameters
$max : int

the number of index partitions

Return values
QueryOptions —

metrics()

Sets whether or not to return metrics with the query.

public metrics(bool $enabled) : QueryOptions
Parameters
$enabled : bool

whether to return metrics

Tags
since
4.0.0
Return values
QueryOptions —

namedParameters()

Sets the named parameters for this query.

public namedParameters(array<string|int, mixed> $pairs) : QueryOptions
Parameters
$pairs : array<string|int, mixed>

the associative array of parameters

Tags
since
4.0.0
Return values
QueryOptions —

pipelineBatch()

Sets the number of items execution operators can batch for fetch from the KV service.

public pipelineBatch(int $batchSize) : QueryOptions
Parameters
$batchSize : int

the pipeline batch size

Tags
since
4.0.0
Return values
QueryOptions —

pipelineCap()

Sets the maximum number of items each execution operator can buffer between various operators.

public pipelineCap(int $cap) : QueryOptions
Parameters
$cap : int

the maximum number of items each execution operation can buffer

Tags
since
4.0.0
Return values
QueryOptions —

positionalParameters()

Sets the positional parameters for this query.

public positionalParameters(array<string|int, mixed> $params) : QueryOptions
Parameters
$params : array<string|int, mixed>

the array of parameters

Tags
since
4.0.0
Return values
QueryOptions —

preserveExpiry()

Sets whether to tell the query engine to preserve expiration values set on any documents modified by this query.

public preserveExpiry(bool $preserve) : QueryOptions
Parameters
$preserve : bool

whether to preserve expiration values.

Tags
since
4.0.0
Return values
QueryOptions —

profile()

Sets the query profile mode to use.

public profile(string|int $mode) : QueryOptions
Parameters
$mode : string|int

the query profile mode

Tags
since
4.0.0
Return values
QueryOptions —

raw()

Sets any extra query parameters that the SDK does not provide an option for.

public raw(string $key, string $value) : QueryOptions
Parameters
$key : string

the name of the parameter

$value : string

the value of the parameter

Tags
since
4.0.0
Return values
QueryOptions —

readonly()

Sets whether this query is readonly.

public readonly(bool $readonly) : QueryOptions
Parameters
$readonly : bool

whether the query is readonly

Tags
since
4.0.0
Return values
QueryOptions —

scanCap()

Sets the maximum buffered channel size between the indexer client and the query service for index scans.

public scanCap(int $cap) : QueryOptions
Parameters
$cap : int

the maximum buffered channel size

Tags
since
4.0.0
Return values
QueryOptions —

scanWait()

This is an advanced option, see the query service reference for more information on the proper use and tuning of this option.

public scanWait(int $milliseconds) : QueryOptions
Parameters
$milliseconds : int
Tags
since
4.0.0
Return values
QueryOptions —

scopeName()

Associate scope name with query

public scopeName(string $name) : QueryOptions
Parameters
$name : string

the name of the scope

Tags
deprecated
since
4.0.0
Return values
QueryOptions —

scopeQualifier()

Associate scope qualifier (also known as `query_context`) with the query.

public scopeQualifier(string $qualifier) : QueryOptions

The qualifier must be in form ${bucketName}.${scopeName} or default:${bucketName}.${scopeName}

Parameters
$qualifier : string

the scope qualifier

Tags
deprecated
since
4.0.0
Return values
QueryOptions —

timeout()

Sets the operation timeout in milliseconds.

public timeout(int $milliseconds) : QueryOptions
Parameters
$milliseconds : int

the operation timeout to apply

Tags
since
4.0.0
Return values
QueryOptions —

useReplica()

Sets whether the query engine should use replica nodes for KV fetches if the active node is down.

public useReplica(bool $useReplica) : QueryOptions
Parameters
$useReplica : bool

Whether to use replica nodes for KV fetches

Tags
since
4.1.5
Return values
QueryOptions —

        

Search results