azure-cosmos-py

Topics in the source

• Azure Cosmos DB SDK for Python
• Installation
• Environment Variables
• Authentication & Lifecycle
• Client Hierarchy
• Core Workflow
• Setup Database and Container
• Create Item

Client library for Azure Cosmos DB NoSQL API — globally distributed, multi-model database. 🔑 Two rules apply to every code sample below: 1. Prefer DefaultAzureCredential. It works locally (Azure CLI / VS Code / Developer CLI) and in Azure (managed identity, workload identity) with no code change. Avoid connection strings, account/API keys — they bypass Entra audit and rotation. - Local dev: DefaultAzureCredential works as-is. - Production: set AZURETOKENCREDENTIALS=prod (or AZURETOKENCREDENTIALS= ) to constrain the credential chain to production-safe credentials. 2. Wrap every client in a context manager so HTTP transports, sockets, and token caches are released deterministically: - Sync: with (...) as client: - Async: async with (...) as client: and async with DefaultAzureCredential() as credential: (from azure.identity.aio) Snippets may abbreviate this setup, but production code should always follow both rules. | Client | Purpose | Get From | |--------|---------|----------| | CosmosClient | Account-level operations | Direct instantiation | | DatabaseProxy | Database operations | client.getdatabaseclient() | | ContainerProxy | Container/item operations | database.getcontainerclie

This is an excerpt. Refer to the complete source and its current requirements.