Node.js examples to manage data in Azure Cosmos DB
APPLIES TO: SQL API
Sample solutions that perform CRUD operations and other common operations on Azure Cosmos DB resources are included in the azure-cosmos-js GitHub repository. This article provides:
- Links to the tasks in each of the Node.js example project files.
- Links to the related API reference content.
- You can activate Visual Studio subscriber benefits: Your Visual Studio subscription gives you credits every month that you can use for paid Azure services.
You can Try Azure Cosmos DB for free without an Azure subscription, free of charge and commitments, or create an Azure Cosmos DB free tier account, with the first 400 RU/s and 5 GB of storage for free. You can also use the Azure Cosmos DB Emulator with a URI of
https://localhost:8081. For the key to use with the emulator, see Authenticating requests.
Each sample is self-contained, it sets itself up and cleans up after itself. As such, the samples issue multiple calls to Containers.create. Each time this is done your subscription will be billed for 1 hour of usage per the performance tier of the container being created.
The DatabaseManagement file shows how to perform the CRUD operations on the database. To learn about the Azure Cosmos databases before running the following samples, see Working with databases, containers, and items conceptual article.
|Create a database if it does not exist||Databases.createIfNotExists|
|List databases for an account||Databases.readAll|
|Read a database by ID||Database.read|
|Delete a database||Database.delete|
The ContainerManagement file shows how to perform the CRUD operations on the container. To learn about the Azure Cosmos collections before running the following samples, see Working with databases, containers, and items conceptual article.
|Create a container if it does not exist||Containers.createIfNotExists|
|List containers for an account||Containers.readAll|
|Read a container definition||Container.read|
|Delete a container||Container.delete|
The ItemManagement file shows how to perform the CRUD operations on the item. To learn about the Azure Cosmos documents before running the following samples, see Working with databases, containers, and items conceptual article.
The IndexManagement file shows how to manage indexing. To learn about indexing in Azure Cosmos DB before running the following samples, see indexing policies, indexing types, and indexing paths conceptual articles.
Server-side programming examples
The index.ts file of the ServerSideScripts project shows how to perform the following tasks. To learn about Server-side programming in Azure Cosmos DB before running the following samples, see Stored procedures, triggers, and user-defined functions conceptual article.
|Create a stored procedure||StoredProcedures.create|
|Execute a stored procedure||StoredProcedure.execute|
For more information about server-side programming, see Azure Cosmos DB server-side programming: Stored procedures, database triggers, and UDFs.
Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.
- If all you know is the number of vcores and servers in your existing database cluster, read about estimating request units using vCores or vCPUs
- If you know typical request rates for your current database workload, read about estimating request units using Azure Cosmos DB capacity planner