azure-docs-sdk-java/docs-ref-autogen/com.azure.cosmos.models.Cos...

474 строки
41 KiB
YAML

### YamlMime:JavaType
uid: "com.azure.cosmos.models.CosmosQueryRequestOptions"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions"
name: "CosmosQueryRequestOptions"
nameWithType: "CosmosQueryRequestOptions"
summary: "Specifies the options associated with query methods (enumeration operations) in the Azure Cosmos DB database service."
inheritances:
- "<xref href=\"java.lang.Object?displayProperty=fullName\" data-throw-if-not-resolved=\"False\" />"
inheritedClassMethods:
- classRef: "java.lang.<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html\">Object</a>"
methodsRef:
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--\">clone</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-\">equals</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--\">finalize</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--\">getClass</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--\">hashCode</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--\">notify</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--\">notifyAll</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--\">toString</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-\">wait</a>"
syntax: "public class **CosmosQueryRequestOptions**"
constructors:
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.CosmosQueryRequestOptions()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.CosmosQueryRequestOptions()"
name: "CosmosQueryRequestOptions()"
nameWithType: "CosmosQueryRequestOptions.CosmosQueryRequestOptions()"
summary: "Instantiates a new query request options."
syntax: "public CosmosQueryRequestOptions()"
desc: "Instantiates a new query request options."
methods:
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getConsistencyLevel()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getConsistencyLevel()"
name: "getConsistencyLevel()"
nameWithType: "CosmosQueryRequestOptions.getConsistencyLevel()"
summary: "Gets the consistency level required for the request."
syntax: "public ConsistencyLevel getConsistencyLevel()"
desc: "Gets the consistency level required for the request."
returns:
description: "the consistency level."
type: "<xref href=\"com.azure.cosmos.ConsistencyLevel?alt=com.azure.cosmos.ConsistencyLevel&text=ConsistencyLevel\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getCustomItemSerializer()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getCustomItemSerializer()"
name: "getCustomItemSerializer()"
nameWithType: "CosmosQueryRequestOptions.getCustomItemSerializer()"
summary: "Gets the custom item serializer defined for this instance of request options"
syntax: "public CosmosItemSerializer getCustomItemSerializer()"
desc: "Gets the custom item serializer defined for this instance of request options"
returns:
description: "the custom item serializer"
type: "<xref href=\"com.azure.cosmos.CosmosItemSerializer?alt=com.azure.cosmos.CosmosItemSerializer&text=CosmosItemSerializer\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getDedicatedGatewayRequestOptions()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getDedicatedGatewayRequestOptions()"
name: "getDedicatedGatewayRequestOptions()"
nameWithType: "CosmosQueryRequestOptions.getDedicatedGatewayRequestOptions()"
summary: "Gets the Dedicated Gateway Request Options"
syntax: "public DedicatedGatewayRequestOptions getDedicatedGatewayRequestOptions()"
desc: "Gets the Dedicated Gateway Request Options"
returns:
description: "the Dedicated Gateway Request Options"
type: "<xref href=\"com.azure.cosmos.models.DedicatedGatewayRequestOptions?alt=com.azure.cosmos.models.DedicatedGatewayRequestOptions&text=DedicatedGatewayRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getDiagnosticsThresholds()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getDiagnosticsThresholds()"
name: "getDiagnosticsThresholds()"
nameWithType: "CosmosQueryRequestOptions.getDiagnosticsThresholds()"
summary: "Gets the diagnostic thresholds used as an override for a specific operation."
syntax: "public CosmosDiagnosticsThresholds getDiagnosticsThresholds()"
desc: "Gets the diagnostic thresholds used as an override for a specific operation. If no operation specific diagnostic threshold has been specified, this method will return null, although at runtime the default thresholds specified at the client-level will be used."
returns:
description: "the diagnostic thresholds used as an override for a specific operation."
type: "<xref href=\"com.azure.cosmos.CosmosDiagnosticsThresholds?alt=com.azure.cosmos.CosmosDiagnosticsThresholds&text=CosmosDiagnosticsThresholds\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getExcludedRegions()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getExcludedRegions()"
name: "getExcludedRegions()"
nameWithType: "CosmosQueryRequestOptions.getExcludedRegions()"
summary: "Gets the list of regions to exclude for the request/retries."
syntax: "public List<String> getExcludedRegions()"
desc: "Gets the list of regions to exclude for the request/retries. These regions are excluded from the preferred region list."
returns:
description: "a list of excluded regions"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/util/List.html\">List</a>&lt;<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>&gt;"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getFeedRange()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getFeedRange()"
name: "getFeedRange()"
nameWithType: "CosmosQueryRequestOptions.getFeedRange()"
summary: "Gets the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref>"
syntax: "public FeedRange getFeedRange()"
desc: "Gets the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref>"
returns:
description: "the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref>"
type: "<xref href=\"com.azure.cosmos.models.FeedRange?alt=com.azure.cosmos.models.FeedRange&text=FeedRange\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getKeywordIdentifiers()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getKeywordIdentifiers()"
name: "getKeywordIdentifiers()"
nameWithType: "CosmosQueryRequestOptions.getKeywordIdentifiers()"
summary: "Gets the custom ids."
syntax: "public Set<String> getKeywordIdentifiers()"
desc: "Gets the custom ids."
returns:
description: "the custom ids."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/util/Set.html\">Set</a>&lt;<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>&gt;"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getMaxBufferedItemCount()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getMaxBufferedItemCount()"
name: "getMaxBufferedItemCount()"
nameWithType: "CosmosQueryRequestOptions.getMaxBufferedItemCount()"
summary: "Gets the maximum number of items that can be buffered client side during parallel query execution."
syntax: "public int getMaxBufferedItemCount()"
desc: "Gets the maximum number of items that can be buffered client side during parallel query execution."
returns:
description: "maximum number of items that can be buffered client side during\n parallel query execution."
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getMaxDegreeOfParallelism()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getMaxDegreeOfParallelism()"
name: "getMaxDegreeOfParallelism()"
nameWithType: "CosmosQueryRequestOptions.getMaxDegreeOfParallelism()"
summary: "Gets the number of concurrent operations run client side during parallel query execution."
syntax: "public int getMaxDegreeOfParallelism()"
desc: "Gets the number of concurrent operations run client side during parallel query execution."
returns:
description: "number of concurrent operations run client side during parallel query\n execution."
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getPartitionKey()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getPartitionKey()"
name: "getPartitionKey()"
nameWithType: "CosmosQueryRequestOptions.getPartitionKey()"
summary: "Gets the partition key used to identify the current request's target partition."
syntax: "public PartitionKey getPartitionKey()"
desc: "Gets the partition key used to identify the current request's target partition."
returns:
description: "the partition key."
type: "<xref href=\"com.azure.cosmos.models.PartitionKey?alt=com.azure.cosmos.models.PartitionKey&text=PartitionKey\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getResponseContinuationTokenLimitInKb()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getResponseContinuationTokenLimitInKb()"
name: "getResponseContinuationTokenLimitInKb()"
nameWithType: "CosmosQueryRequestOptions.getResponseContinuationTokenLimitInKb()"
summary: "Gets the Response<wbr>Continuation<wbr>Token<wbr>Limit<wbr>InKb request option for item query requests in the Azure Cosmos DB service."
syntax: "public int getResponseContinuationTokenLimitInKb()"
desc: "Gets the ResponseContinuationTokenLimitInKb request option for item query requests in the Azure Cosmos DB service. If not already set returns 0.\n\nResponseContinuationTokenLimitInKb is used to limit the length of continuation token in the query response. Valid values are >= 1."
returns:
description: "return set ResponseContinuationTokenLimitInKb, or 0 if not set"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getSessionToken()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getSessionToken()"
name: "getSessionToken()"
nameWithType: "CosmosQueryRequestOptions.getSessionToken()"
summary: "Gets the session token for use with session consistency."
syntax: "public String getSessionToken()"
desc: "Gets the session token for use with session consistency."
returns:
description: "the session token."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getThresholdForDiagnosticsOnTracer()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getThresholdForDiagnosticsOnTracer()"
name: "getThresholdForDiagnosticsOnTracer()"
nameWithType: "CosmosQueryRequestOptions.getThresholdForDiagnosticsOnTracer()"
summary: "Gets the threshold<wbr>For<wbr>Diagnostics<wbr>OnTracer, if latency on query operation is greater than this diagnostics will be send to open telemetry exporter as events in tracer span of end to end CRUD api."
syntax: "public Duration getThresholdForDiagnosticsOnTracer()"
desc: "Gets the thresholdForDiagnosticsOnTracer, if latency on query operation is greater than this diagnostics will be send to open telemetry exporter as events in tracer span of end to end CRUD api. Default is 500 ms."
returns:
description: "thresholdForDiagnosticsOnTracer the latency threshold for diagnostics on tracer."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.getThroughputControlGroupName()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.getThroughputControlGroupName()"
name: "getThroughputControlGroupName()"
nameWithType: "CosmosQueryRequestOptions.getThroughputControlGroupName()"
summary: "Get throughput control group name."
syntax: "public String getThroughputControlGroupName()"
desc: "Get throughput control group name."
returns:
description: "The throughput control group name."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.isIndexMetricsEnabled()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.isIndexMetricsEnabled()"
name: "isIndexMetricsEnabled()"
nameWithType: "CosmosQueryRequestOptions.isIndexMetricsEnabled()"
summary: "Gets index<wbr>Metrics<wbr>Enabled, which is used to obtain the index metrics to understand how the query engine used existing indexes and could use potential new indexes."
syntax: "public boolean isIndexMetricsEnabled()"
desc: "Gets indexMetricsEnabled, which is used to obtain the index metrics to understand how the query engine used existing indexes and could use potential new indexes. The results will be displayed in QueryMetrics. Please note that this options will incurs overhead, so it should be enabled when debuging slow queries."
returns:
description: "indexMetricsEnabled (default: false)"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.isQueryMetricsEnabled()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.isQueryMetricsEnabled()"
name: "isQueryMetricsEnabled()"
nameWithType: "CosmosQueryRequestOptions.isQueryMetricsEnabled()"
summary: "Gets the option to enable populate query metrics."
syntax: "public boolean isQueryMetricsEnabled()"
desc: "Gets the option to enable populate query metrics. By default query metrics are enabled."
returns:
description: "whether to enable populate query metrics (default: true)"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.isScanInQueryEnabled()"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.isScanInQueryEnabled()"
name: "isScanInQueryEnabled()"
nameWithType: "CosmosQueryRequestOptions.isScanInQueryEnabled()"
summary: "Gets the option to allow scan on the queries which couldn't be served as indexing was opted out on the requested paths."
syntax: "public Boolean isScanInQueryEnabled()"
desc: "Gets the option to allow scan on the queries which couldn't be served as indexing was opted out on the requested paths."
returns:
description: "the option of enable scan in query."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html\">Boolean</a>"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setConsistencyLevel(com.azure.cosmos.ConsistencyLevel)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setConsistencyLevel(ConsistencyLevel consistencyLevel)"
name: "setConsistencyLevel(ConsistencyLevel consistencyLevel)"
nameWithType: "CosmosQueryRequestOptions.setConsistencyLevel(ConsistencyLevel consistencyLevel)"
summary: "Sets the consistency level required for the request."
parameters:
- description: "the consistency level."
name: "consistencyLevel"
type: "<xref href=\"com.azure.cosmos.ConsistencyLevel?alt=com.azure.cosmos.ConsistencyLevel&text=ConsistencyLevel\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setConsistencyLevel(ConsistencyLevel consistencyLevel)"
desc: "Sets the consistency level required for the request. The effective consistency level can only be reduce for read/query requests. So when the Account's default consistency level is for example Session you can specify on a request-by-request level for individual requests that Eventual consistency is sufficient - which could reduce the latency and RU charges for this request but will not guarantee session consistency (read-your-own-write) anymore"
returns:
description: "the CosmosItemRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setCosmosEndToEndOperationLatencyPolicyConfig(com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setCosmosEndToEndOperationLatencyPolicyConfig(CosmosEndToEndOperationLatencyPolicyConfig cosmosEndToEndOperationLatencyPolicyConfig)"
name: "setCosmosEndToEndOperationLatencyPolicyConfig(CosmosEndToEndOperationLatencyPolicyConfig cosmosEndToEndOperationLatencyPolicyConfig)"
nameWithType: "CosmosQueryRequestOptions.setCosmosEndToEndOperationLatencyPolicyConfig(CosmosEndToEndOperationLatencyPolicyConfig cosmosEndToEndOperationLatencyPolicyConfig)"
summary: "Sets the <xref uid=\"com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig\" data-throw-if-not-resolved=\"false\" data-raw-source=\"CosmosEndToEndOperationLatencyPolicyConfig\"></xref> to be used for the request."
parameters:
- description: "the <xref uid=\"com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig\" data-throw-if-not-resolved=\"false\" data-raw-source=\"CosmosEndToEndOperationLatencyPolicyConfig\"></xref>"
name: "cosmosEndToEndOperationLatencyPolicyConfig"
type: "<xref href=\"com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig?alt=com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig&text=CosmosEndToEndOperationLatencyPolicyConfig\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setCosmosEndToEndOperationLatencyPolicyConfig(CosmosEndToEndOperationLatencyPolicyConfig cosmosEndToEndOperationLatencyPolicyConfig)"
desc: "Sets the <xref uid=\"com.azure.cosmos.CosmosEndToEndOperationLatencyPolicyConfig\" data-throw-if-not-resolved=\"false\" data-raw-source=\"CosmosEndToEndOperationLatencyPolicyConfig\"></xref> to be used for the request. If the config is already set \\* on the client, then this will override the client level config for this request"
returns:
description: "the CosmosQueryRequestOptions"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setCustomItemSerializer(com.azure.cosmos.CosmosItemSerializer)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setCustomItemSerializer(CosmosItemSerializer customItemSerializer)"
name: "setCustomItemSerializer(CosmosItemSerializer customItemSerializer)"
nameWithType: "CosmosQueryRequestOptions.setCustomItemSerializer(CosmosItemSerializer customItemSerializer)"
summary: "Allows specifying a custom item serializer to be used for this operation."
parameters:
- description: "the custom item serializer for this operation"
name: "customItemSerializer"
type: "<xref href=\"com.azure.cosmos.CosmosItemSerializer?alt=com.azure.cosmos.CosmosItemSerializer&text=CosmosItemSerializer\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setCustomItemSerializer(CosmosItemSerializer customItemSerializer)"
desc: "Allows specifying a custom item serializer to be used for this operation. If the serializer on the request options is null, the serializer on CosmosClientBuilder is used. If both serializers are null (the default), an internal Jackson ObjectMapper is ued for serialization/deserialization."
returns:
description: "the CosmosItemRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setDedicatedGatewayRequestOptions(com.azure.cosmos.models.DedicatedGatewayRequestOptions)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setDedicatedGatewayRequestOptions(DedicatedGatewayRequestOptions dedicatedGatewayRequestOptions)"
name: "setDedicatedGatewayRequestOptions(DedicatedGatewayRequestOptions dedicatedGatewayRequestOptions)"
nameWithType: "CosmosQueryRequestOptions.setDedicatedGatewayRequestOptions(DedicatedGatewayRequestOptions dedicatedGatewayRequestOptions)"
summary: "Sets the Dedicated Gateway Request Options"
parameters:
- description: "Dedicated Gateway Request Options"
name: "dedicatedGatewayRequestOptions"
type: "<xref href=\"com.azure.cosmos.models.DedicatedGatewayRequestOptions?alt=com.azure.cosmos.models.DedicatedGatewayRequestOptions&text=DedicatedGatewayRequestOptions\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setDedicatedGatewayRequestOptions(DedicatedGatewayRequestOptions dedicatedGatewayRequestOptions)"
desc: "Sets the Dedicated Gateway Request Options"
returns:
description: "the CosmosQueryRequestOptions"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setDiagnosticsThresholds(com.azure.cosmos.CosmosDiagnosticsThresholds)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setDiagnosticsThresholds(CosmosDiagnosticsThresholds operationSpecificThresholds)"
name: "setDiagnosticsThresholds(CosmosDiagnosticsThresholds operationSpecificThresholds)"
nameWithType: "CosmosQueryRequestOptions.setDiagnosticsThresholds(CosmosDiagnosticsThresholds operationSpecificThresholds)"
summary: "Allows overriding the diagnostic thresholds for a specific operation."
parameters:
- description: "the diagnostic threshold override for this operation"
name: "operationSpecificThresholds"
type: "<xref href=\"com.azure.cosmos.CosmosDiagnosticsThresholds?alt=com.azure.cosmos.CosmosDiagnosticsThresholds&text=CosmosDiagnosticsThresholds\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setDiagnosticsThresholds(CosmosDiagnosticsThresholds operationSpecificThresholds)"
desc: "Allows overriding the diagnostic thresholds for a specific operation."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setExcludedRegions(java.util.List<java.lang.String>)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setExcludedRegions(List<String> excludeRegions)"
name: "setExcludedRegions(List<String> excludeRegions)"
nameWithType: "CosmosQueryRequestOptions.setExcludedRegions(List<String> excludeRegions)"
summary: "List of regions to be excluded for the request/retries."
parameters:
- description: "the regions to exclude"
name: "excludeRegions"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/util/List.html\">List</a>&lt;<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>&gt;"
syntax: "public CosmosQueryRequestOptions setExcludedRegions(List<String> excludeRegions)"
desc: "List of regions to be excluded for the request/retries. Example \"East US\" or \"East US, West US\" These regions will be excluded from the preferred regions list"
returns:
description: "the <xref uid=\"com.azure.cosmos.models.CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"CosmosQueryRequestOptions\"></xref>"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setFeedRange(com.azure.cosmos.models.FeedRange)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setFeedRange(FeedRange feedRange)"
name: "setFeedRange(FeedRange feedRange)"
nameWithType: "CosmosQueryRequestOptions.setFeedRange(FeedRange feedRange)"
summary: "Sets the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref> that we want to query"
parameters:
- description: "the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref>"
name: "feedRange"
type: "<xref href=\"com.azure.cosmos.models.FeedRange?alt=com.azure.cosmos.models.FeedRange&text=FeedRange\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setFeedRange(FeedRange feedRange)"
desc: "Sets the <xref uid=\"com.azure.cosmos.models.FeedRange\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FeedRange\"></xref> that we want to query"
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setIndexMetricsEnabled(boolean)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setIndexMetricsEnabled(boolean indexMetricsEnabled)"
name: "setIndexMetricsEnabled(boolean indexMetricsEnabled)"
nameWithType: "CosmosQueryRequestOptions.setIndexMetricsEnabled(boolean indexMetricsEnabled)"
summary: "Sets index<wbr>Metrics<wbr>Enabled, which is used to obtain the index metrics to understand how the query engine used existing indexes and could use potential new indexes."
parameters:
- description: "a boolean used to obtain the index metrics"
name: "indexMetricsEnabled"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setIndexMetricsEnabled(boolean indexMetricsEnabled)"
desc: "Sets indexMetricsEnabled, which is used to obtain the index metrics to understand how the query engine used existing indexes and could use potential new indexes. The results will be displayed in QueryMetrics. Please note that this options will incurs overhead, so it should be enabled when debugging slow queries. By default the indexMetrics are disabled."
returns:
description: "indexMetricsEnabled"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setKeywordIdentifiers(java.util.Set<java.lang.String>)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setKeywordIdentifiers(Set<String> keywordIdentifiers)"
name: "setKeywordIdentifiers(Set<String> keywordIdentifiers)"
nameWithType: "CosmosQueryRequestOptions.setKeywordIdentifiers(Set<String> keywordIdentifiers)"
summary: "Sets the custom ids."
parameters:
- description: "the custom ids."
name: "keywordIdentifiers"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/util/Set.html\">Set</a>&lt;<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>&gt;"
syntax: "public CosmosQueryRequestOptions setKeywordIdentifiers(Set<String> keywordIdentifiers)"
desc: "Sets the custom ids."
returns:
description: "the current request options."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setMaxBufferedItemCount(int)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setMaxBufferedItemCount(int maxBufferedItemCount)"
name: "setMaxBufferedItemCount(int maxBufferedItemCount)"
nameWithType: "CosmosQueryRequestOptions.setMaxBufferedItemCount(int maxBufferedItemCount)"
summary: "Sets the maximum number of items that can be buffered client side during parallel query execution."
parameters:
- description: "maximum number of items."
name: "maxBufferedItemCount"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setMaxBufferedItemCount(int maxBufferedItemCount)"
desc: "Sets the maximum number of items that can be buffered client side during parallel query execution."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setMaxDegreeOfParallelism(int)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setMaxDegreeOfParallelism(int maxDegreeOfParallelism)"
name: "setMaxDegreeOfParallelism(int maxDegreeOfParallelism)"
nameWithType: "CosmosQueryRequestOptions.setMaxDegreeOfParallelism(int maxDegreeOfParallelism)"
summary: "Sets the number of concurrent operations run client side during parallel query execution."
parameters:
- description: "number of concurrent operations."
name: "maxDegreeOfParallelism"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setMaxDegreeOfParallelism(int maxDegreeOfParallelism)"
desc: "Sets the number of concurrent operations run client side during parallel query execution."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setPartitionKey(com.azure.cosmos.models.PartitionKey)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setPartitionKey(PartitionKey partitionkey)"
name: "setPartitionKey(PartitionKey partitionkey)"
nameWithType: "CosmosQueryRequestOptions.setPartitionKey(PartitionKey partitionkey)"
summary: "Sets the partition key used to identify the current request's target partition."
parameters:
- description: "the partition key value."
name: "partitionkey"
type: "<xref href=\"com.azure.cosmos.models.PartitionKey?alt=com.azure.cosmos.models.PartitionKey&text=PartitionKey\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setPartitionKey(PartitionKey partitionkey)"
desc: "Sets the partition key used to identify the current request's target partition."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setQueryMetricsEnabled(boolean)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setQueryMetricsEnabled(boolean queryMetricsEnabled)"
name: "setQueryMetricsEnabled(boolean queryMetricsEnabled)"
nameWithType: "CosmosQueryRequestOptions.setQueryMetricsEnabled(boolean queryMetricsEnabled)"
summary: "Sets the option to enable/disable getting metrics relating to query execution on item query requests."
parameters:
- description: "whether to enable or disable query metrics"
name: "queryMetricsEnabled"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setQueryMetricsEnabled(boolean queryMetricsEnabled)"
desc: "Sets the option to enable/disable getting metrics relating to query execution on item query requests. By default query metrics are enabled."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setQueryName(java.lang.String)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setQueryName(String queryName)"
name: "setQueryName(String queryName)"
nameWithType: "CosmosQueryRequestOptions.setQueryName(String queryName)"
summary: "Sets the logical query name - this identifier is only used for metrics and logs to distinguish different queries in telemetry."
parameters:
- description: "a logical query name to distinguish this query pattern from others"
name: "queryName"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public CosmosQueryRequestOptions setQueryName(String queryName)"
desc: "Sets the logical query name - this identifier is only used for metrics and logs to distinguish different queries in telemetry. Cardinality of unique values for queryName should be reasonably low - like significantly smaller than 100."
returns:
description: "the logical query name"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setResponseContinuationTokenLimitInKb(int)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setResponseContinuationTokenLimitInKb(int limitInKb)"
name: "setResponseContinuationTokenLimitInKb(int limitInKb)"
nameWithType: "CosmosQueryRequestOptions.setResponseContinuationTokenLimitInKb(int limitInKb)"
summary: "Sets the Response<wbr>Continuation<wbr>Token<wbr>Limit<wbr>InKb request option for item query requests in the Azure Cosmos DB service."
parameters:
- description: "continuation token size limit."
name: "limitInKb"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
syntax: "public CosmosQueryRequestOptions setResponseContinuationTokenLimitInKb(int limitInKb)"
desc: "Sets the ResponseContinuationTokenLimitInKb request option for item query requests in the Azure Cosmos DB service.\n\nResponseContinuationTokenLimitInKb is used to limit the length of continuation token in the query response. Valid values are >= 1.\n\nThe continuation token contains both required and optional fields. The required fields are necessary for resuming the execution from where it was stooped. The optional fields may contain serialized index lookup work that was done but not yet utilized. This avoids redoing the work again in subsequent continuations and hence improve the query performance. Setting the maximum continuation size to 1KB, the Azure Cosmos DB service will only serialize required fields. Starting from 2KB, the Azure Cosmos DB service would serialize as much as it could fit till it reaches the maximum specified size."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setScanInQueryEnabled(java.lang.Boolean)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setScanInQueryEnabled(Boolean scanInQueryEnabled)"
name: "setScanInQueryEnabled(Boolean scanInQueryEnabled)"
nameWithType: "CosmosQueryRequestOptions.setScanInQueryEnabled(Boolean scanInQueryEnabled)"
summary: "Sets the option to allow scan on the queries which couldn't be served as indexing was opted out on the requested paths."
parameters:
- description: "the option of enable scan in query."
name: "scanInQueryEnabled"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html\">Boolean</a>"
syntax: "public CosmosQueryRequestOptions setScanInQueryEnabled(Boolean scanInQueryEnabled)"
desc: "Sets the option to allow scan on the queries which couldn't be served as indexing was opted out on the requested paths."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setSessionToken(java.lang.String)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setSessionToken(String sessionToken)"
name: "setSessionToken(String sessionToken)"
nameWithType: "CosmosQueryRequestOptions.setSessionToken(String sessionToken)"
summary: "Sets the session token for use with session consistency."
parameters:
- description: "the session token."
name: "sessionToken"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public CosmosQueryRequestOptions setSessionToken(String sessionToken)"
desc: "Sets the session token for use with session consistency."
returns:
description: "the CosmosQueryRequestOptions."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setThresholdForDiagnosticsOnTracer(java.time.Duration)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setThresholdForDiagnosticsOnTracer(Duration thresholdForDiagnosticsOnTracer)"
name: "setThresholdForDiagnosticsOnTracer(Duration thresholdForDiagnosticsOnTracer)"
nameWithType: "CosmosQueryRequestOptions.setThresholdForDiagnosticsOnTracer(Duration thresholdForDiagnosticsOnTracer)"
summary: "Sets the threshold<wbr>For<wbr>Diagnostics<wbr>OnTracer, if latency on query operation is greater than this diagnostics will be send to open telemetry exporter as events in tracer span of end to end CRUD api."
parameters:
- description: "the latency threshold for diagnostics on tracer."
name: "thresholdForDiagnosticsOnTracer"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
syntax: "public CosmosQueryRequestOptions setThresholdForDiagnosticsOnTracer(Duration thresholdForDiagnosticsOnTracer)"
desc: "Sets the thresholdForDiagnosticsOnTracer, if latency on query operation is greater than this diagnostics will be send to open telemetry exporter as events in tracer span of end to end CRUD api. Default is 500 ms"
returns:
description: "the CosmosQueryRequestOptions"
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.cosmos.models.CosmosQueryRequestOptions.setThroughputControlGroupName(java.lang.String)"
fullName: "com.azure.cosmos.models.CosmosQueryRequestOptions.setThroughputControlGroupName(String throughputControlGroupName)"
name: "setThroughputControlGroupName(String throughputControlGroupName)"
nameWithType: "CosmosQueryRequestOptions.setThroughputControlGroupName(String throughputControlGroupName)"
summary: "Set the throughput control group name."
parameters:
- description: "The throughput control group name."
name: "throughputControlGroupName"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public CosmosQueryRequestOptions setThroughputControlGroupName(String throughputControlGroupName)"
desc: "Set the throughput control group name."
returns:
description: "A <xref uid=\"com.azure.cosmos.models.CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"CosmosQueryRequestOptions\"></xref>."
type: "<xref href=\"com.azure.cosmos.models.CosmosQueryRequestOptions?alt=com.azure.cosmos.models.CosmosQueryRequestOptions&text=CosmosQueryRequestOptions\" data-throw-if-not-resolved=\"False\" />"
type: "class"
desc: "Specifies the options associated with query methods (enumeration operations) in the Azure Cosmos DB database service."
metadata: {}
package: "com.azure.cosmos.models"
artifact: com.azure:azure-cosmos:4.63.3