Ultimate Cosmosdb Demo

The one demo to rule them all. The goal of this repo is to keep a single demo up to date that evolves with new features.

Code Tour

Install the Code Tour extension in VS Code.

Use the command palette to launch "CodeTour: Start Tour"

introduction.tour will review the basics.

models.tour will review the data models and generation of example data.

cosmos.tour will review the methods in the Cosmos service.

Prereqs

Add packages from NuGet

dotnet add package Microsoft.Azure.Cosmos
dotnet add package Azure.Identity
dotnet add package Bogus
dotnet add package Spectre.Console
dotnet add package Newtonsoft.Json

Initialize and set local environment variables using dotnet secrets store

dotnet user-secrets init
dotnet user-secrets set "cosmosEndpoint" ""
dotnet user-secrets set "cosmosDatabase" ""
dotnet user-secrets set "cosmosContainer" ""

Optional: Explicity define Entra ID Tenant Directory

dotnet user-secrets set "entraTenantId" ""

Cosmos DB Account

Deploy an Azure Cosmos DB account with the NoSQL API.

If you'd like to test the "Hot Partition" functionality, deploy a container with 15k RUs.

This will create 3 physical partitions. Be aware of the costs! Delete the container when you are done using it.

Spectre.Console

Library for a simple and pretty console based menu selector. Launch.json needs edited to support Spectre.Console while debugging.

    "configurations": [
        {
            "name": ".NET Core Launch (console)",
            "type": "coreclr",
            "request": "launch",
            "program": "${workspaceFolder}/bin/Debug/<targeted .net version>/ultimate-cosmosdb-demo.dll",
            "console" : "integratedTerminal"
        }
    ]

Where to start for beginners

First create your Cosmos DB account and container as well as set your dotnet user-secrets.

Next, run the application and bulk load users.

Use data from those user documents to test the queries and other operations ie. id, partitionKey, email, etc...