Skip to content

Commit a85fce4

Browse files
Merge pull request #239858 from TheovanKraay/patch-47
Update throughput-control-spark.md
2 parents 427139d + 3143047 commit a85fce4

File tree

2 files changed

+6
-1
lines changed

2 files changed

+6
-1
lines changed

articles/cosmos-db/nosql/quickstart-java.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -398,6 +398,10 @@ There are several advanced scenarios that benefit from client-side throughput co
398398
399399
- **Load balancing of throughput between different Azure Cosmos DB clients** - in some use cases, it's important to make sure all the clients get a fair (equal) share of the throughput
400400
401+
> [!WARNING]
402+
> Please note that throughput control is not yet supported for gateway mode.
403+
> Currently, for [serverless Azure Cosmos DB accounts](../serverless.md), attempting to use `targetThroughputThreshold` to define a percentage will result in failure. You can only provide an absolute value for target throughput/RU using `targetThroughput`.
404+
401405
### Global throughput control
402406
403407
Global throughput control in the Java SDK is configured by first creating a container that will define throughput control metadata. This container must have a partition key of `groupId`, and `ttl` enabled. Assuming you already have objects for client, database, and container as defined in the examples above, you can create this container as below. Here we name the container `ThroughputControl`:

articles/cosmos-db/nosql/throughput-control-spark.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,8 @@ The [Spark Connector](quickstart-spark.md) allows you to communicate with Azure
1919
> This article documents the use of global throughput control groups in the Azure Cosmos DB Spark Connector, but the functionality is also available in the [Java SDK](./sdk-java-v4.md). In the SDK, you can also use both global and local Throughput Control groups to limit the RU consumption in the context of a single client connection instance. For example, you can apply this to different operations within a single microservice, or maybe to a single data loading program. Take a look at documentation on how to [use throughput control](quickstart-java.md#use-throughput-control) in the Java SDK.
2020
2121
> [!WARNING]
22-
> Please note that throughput control is not yet supported for gateway mode.
22+
> Please note that throughput control is not yet supported for gateway mode.
23+
> Currently, for [serverless Azure Cosmos DB accounts](../serverless.md), attempting to use `targetThroughputThreshold` to define a percentage will result in failure. You can only provide an absolute value for target throughput/RU using `spark.cosmos.throughputControl.targetThroughput`.
2324
2425
## Why is throughput control important?
2526

0 commit comments

Comments
 (0)