Repository files navigation

A collection of## Examples

The following table shows all the numbered example directories and what each demonstrates:

To run any demo:

1. Ensure Azure infrastructure is deployed (azd up)
2. Load sample data (cd data && ./mongoimport.sh)
3. Navigate to the desired sample directory
4. Runnpm install && node index.jsdemonstrating how to use Azure Cosmos DB with the MongoDB API. This project is designed to run in a development container and deploy to Azure using the Azure Developer CLI.

This project provides the following features:

• Azure Cosmos DB MongoDB vCore integration samples
• Development container with pre-configured environment
• Azure Developer CLI (azd) deployment automation
• AdventureWorks sample database seeding
• Multiple JavaScript examples demonstrating CRUD operations

• Docker Desktop
• Visual Studio Code withDev Containers extension
• Azure Developer CLI
• Active Azure subscription

1. Clone the repository:

   git clone https://github.com/Azure-Samples/cosmos-db-mongodb-api-javascript-samples.gitcd cosmos-db-mongodb-api-javascript-samples

2. Open in development container:

   • Open the project in VS Code
   • When prompted, select "Reopen in Container" or useCtrl+Shift+P → "Dev Containers: Reopen in Container"

3. Deploy to Azure:

   azd up

1. Deploy infrastructure: Theazd up command provisions Azure Cosmos DB vCore and creates a root.env file with connection strings
2. Load sample data: Navigate to the data directory and run the import script:

   cd data./mongoimport.sh

3. Run samples: Each subdirectory contains a focused example:

   cd 001-quickstartnpm installnode index.js

• Root.env: Contains Azure connection strings (auto-generated by azd)
• /data: Contains AdventureWorks sample data and import scripts
• /001-quickstart: Basic CRUD operations example
• /275-find: Query and find operations example
• /infra: Bicep templates for Azure infrastructure

Each sample directory references the root.env file for Azure Cosmos DB connection details.

The included samples demonstrate:

1. Basic Operations (001-quickstart):

   • Connect to Azure Cosmos DB MongoDB vCore
   • Create database and collection
   • Insert, update, and query documents

2. Advanced Queries (275-find):

   • Point reads with partition keys
   • Complex query operations
   • Index usage examples

To run any demo:

1. Ensure Azure infrastructure is deployed (azd up)
2. Load sample data (cd data && ./create-adventureworks.sh)
3. Navigate to the desired sample directory
4. Runnpm install && node index.js

• Azure Cosmos DB MongoDB API Documentation
• Azure Developer CLI Documentation
• MongoDB Node.js Driver Documentation
• Development Containers Documentation