We’re excited to launch model 4 of the Azure Cosmos DB JavaScript SDK! This replace delivers main enhancements that make it simpler and sooner to construct high-performance apps with the Azure Cosmos DB for NoSQL API. Model 4 is on the market now and targets Node.js v18 and above, introducing a bunch of recent capabilities, together with:
- Improved bulk operation help
- Extra versatile and scalable question design
- Shopper-side encryption
- Constructed-in vector and full-text search help
- Enhanced diagnostic logging …and far more.
Model 4 of the SDK is open supply, constructed totally in TypeScript, and designed for contemporary JavaScript growth. It gives full help for Guarantees and the async/await sample, enabling clear and environment friendly coding. The SDK additionally follows official JavaScript SDK design tips to make sure consistency and reliability.
For a whole overview of options, documentation, and code samples, go to the JavaScript SDK Change Log. Whether or not upgrading from an earlier model or ranging from scratch, it’s the go-to useful resource for getting on top of things.
This weblog highlights a number of the most impactful updates within the launch—and the way they may also help speed up software growth with Azure Cosmos DB.
Newest Enhancements within the JavaScript SDK
Improved Question Management in Azure Cosmos DB JavaScript SDK
The Azure Cosmos DB JavaScript SDK introduces a brand new question pipeline to present builders finer management over question execution and enhance transparency.
What’s Modified?
Beforehand, every fetchNext name aimed to return as much as maxItemCount outcomes, usually triggering a number of partition queries behind the scenes. This induced:
- 🚀 Greater RU Consumption: The SDK re-queried partitions to satisfy consequence ensures, resulting in elevated RU fees and potential throttling.
- ⏱️ Unpredictable Latency: Lengthy-running queries diminished responsiveness and developer management.
🆕Advantages of the New Question Pipeline
- 📌 Partition-Stage Question Management
Every fetchNext name now queries as much as maxDegreeOfParallelism partitions. If no outcomes can be found, it returns an empty web page with RU utilization, with out querying all partitions. - 📊 Granular Useful resource Monitoring
Builders can observe RUs after every iteration and resolve whether or not to proceed or cease querying—giving extra management over prices and efficiency.
⚙️ Easy methods to Allow It
Use the enableQueryControl flag in FeedOptions:
const queryOptions: FeedOptions = {
maxDegreeOfParallelism: 3,
maxItemCount: 10,
enableQueryControl: true
}); 🔍 How It Works
When enableQueryControl is true, every fetchNext:
Queries a restricted variety of partitions (as much as maxDegreeOfParallelism).
- Returns early with empty outcomes and RU utilization if no outcomes are discovered.
- Doesn’t auto-fulfill maxItemCount by scanning all partitions.
🔄 Backward Compatibility
The flag is disabled by default (enableQueryControl: false), guaranteeing present habits is preserved.
📭 Dealing with Empty Pages
- Empty pages ≠ question full.
- All the time examine the hasMoreResults flag.
- If true, extra outcomes can be found.
- Use this flag as a substitute of assuming primarily based on present web page outcomes.
Unlocking Environment friendly Bulk Workloads with the New executeBulkOperations API within the JavaScript SDK
The brand new executeBulkOperations API within the Azure Cosmos DB JavaScript SDK introduces main enhancements for dealing with bulk workloads. This launch addresses earlier limitations and delivers highly effective enhancements that streamline efficiency and effectivity at scale. Right here’s what’s new:
- No Extra 100-Operation Restrict
The earlier restriction of 100 operations per bulk request has been lifted. Functions can now ship a a lot bigger variety of operations in a single request, bettering throughput and decreasing client-side batching overhead. - Operation-Stage Retry Mechanism
We’ve launched a better retry technique that applies retries on the particular person operation degree. Relatively than retrying the complete batch when failures happen, every operation is evaluated independently and retried as wanted. This leads to extra resilient and environment friendly error dealing with. - Dynamic Congestion Management
The SDK now options clever per-partition concurrency management. It routinely adjusts the variety of concurrent requests primarily based on real-time suggestions—scaling up when operations full efficiently and cutting down when throttling (HTTP 429) responses are detected. This ensures optimum efficiency whereas respecting throughput limits.
These enhancements make the JavaScript SDK’s bulk help extra scalable, fault-tolerant, and adaptive, excellent for high-volume workloads in trendy cloud purposes.
Comply with the pattern right here for extra particulars.
Shopper-side encryption help
Azure Cosmos DB now helps All the time Encrypted for Node.js purposes, enabling client-side encryption to guard delicate information earlier than it ever leaves the appliance. With the Cosmos DB JavaScript SDK, builders can simply encrypt and decrypt particular properties inside paperwork—whereas maintaining encryption keys totally below their management.
The combination is straightforward: outline a protected information encryption key and apply encryption insurance policies immediately in container operations. Right here’s a fast instance!
This characteristic empowers builders to satisfy stricter compliance and safety necessities, all whereas sustaining a well-known growth expertise in Node.js.
New AI Search Capabilities
The Azure Cosmos DB JavaScript SDK now contains highly effective AI-driven options. With built-in help for Vector Search, Full-Textual content Seek for superior textual content indexing and querying, and Hybrid Search that mixes key phrase and vector semantics, builders can seamlessly construct clever, search-enhanced purposes. Study extra about Full-Textual content Search and Hybrid Search.
And Far more!
This launch introduces key secure enhancements together with Partition Merge help, partial hierarchical partition key dealing with in Change Feed, index metrics, client-side request diagnostics, and extra options to optimize JavaScript purposes with Azure Cosmos DB.
Improve to JavaScript SDK v4
Considering of upgrading to JavaScript SDK v4? Right here’s a fast abstract of the variations we’ve launched thus far and the related Change Log.
We suggest upgrading to JavaScript SDK v4 for one of the best efficiency, the latest options, and continued long-term help. Look and provides it your greatest shot!
Get began Azure Cosmos DB JavaScript SDK
It’s alright for those who’re utterly new to the JavaScript SDK – observe these three steps to get began quick:
- Set up the newest Nodejs model so you should use the SDK.
- Work by means of the Quickstart Information for Javascript SDK v4 which will get you entry to the Javascript SDK v4 npm bundle and walks you thru fundamental Azure Cosmos DB requests.
- Learn the JavaScript SDK greatest practices to optimize the SDK on your software.
Then go to the JavaScript SDK v4 Launch Notes web page for the remainder of our documentation and pattern code.
Blissful coding!
Depart a evaluation
Inform us about your Azure Cosmos DB expertise! Depart a evaluation on PeerSpot and we’ll present you $50. .
About Azure Cosmos DB
Azure Cosmos DB is a completely managed and serverless NoSQL and vector database for contemporary app growth, together with AI purposes. With its SLA-backed velocity and availability in addition to instantaneous dynamic scalability, it’s excellent for real-time NoSQL and MongoDB purposes that require excessive efficiency and distributed computing over huge volumes of NoSQL and vector information.
To remain within the loop on Azure Cosmos DB updates, observe us on , , and .
To rapidly construct your first database, watch our Get Began movies on YouTube and discover methods to dev/check free.
