Skip to content

Commit d3696d3

Browse files
Merge pull request #234578 from jcocchi/update-point-read
Cosmos DB: update point read docs
2 parents 6a5997f + 25bcab9 commit d3696d3

File tree

2 files changed

+5
-2
lines changed

2 files changed

+5
-2
lines changed

articles/cosmos-db/optimize-cost-reads-writes.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,10 @@ The only factor affecting the RU charge of a point read (besides the consistency
4343
| 1 KB | 1 RU |
4444
| 100 KB | 10 RUs |
4545

46-
Because point reads (key/value lookups on the item ID) are the most efficient kind of read, you should make sure your item ID has a meaningful value so you can fetch your items with a point read (instead of a query) when possible.
46+
Because point reads (key/value lookups on the item ID and partition key) are the most efficient kind of read, you should make sure your item ID has a meaningful value so you can fetch your items with a point read (instead of a query) when possible.
47+
48+
> [!NOTE]
49+
> In the API for NoSQL, point reads can only be made using the REST API or SDKs. Queries that filter on one item's ID and partition key aren't considered a point read. To see an example using the .NET SDK, see [read an item in Azure Cosmos DB for NoSQL.](./nosql/how-to-dotnet-read-item.md)
4750
4851
### Queries
4952

articles/cosmos-db/request-units.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Azure Cosmos DB supports many APIs, such as SQL, MongoDB, Cassandra, Gremlin, an
1919

2020
Azure Cosmos DB normalizes the cost of all database operations using Request Units (or RUs, for short). Request unit is a performance currency abstracting the system resources such as CPU, IOPS, and memory that are required to perform the database operations supported by Azure Cosmos DB.
2121

22-
The cost to do a point read (fetching a single item by its ID and partition key value) for a 1-KB item is one Request Unit (or one RU). All other database operations are similarly assigned a cost using RUs. No matter which API you use to interact with your Azure Cosmos DB container, RUs measure the actual costs of using that API. Whether the database operation is a write, point read, or query, costs are always measured in RUs.
22+
The cost to do a [point read](optimize-cost-reads-writes.md#point-reads) (fetching a single item by its ID and partition key value) for a 1-KB item is one Request Unit (or one RU). All other database operations are similarly assigned a cost using RUs. No matter which API you use to interact with your Azure Cosmos DB container, RUs measure the actual costs of using that API. Whether the database operation is a write, point read, or query, costs are always measured in RUs.
2323

2424
> [!VIDEO https://learn.microsoft.com/_themes/docs.theme/master/en-us/_themes/global/video-embed.html?id=772fba63-62c7-488c-acdb-a8f686a3b5f4]
2525

0 commit comments

Comments
 (0)