Is this optimized for FastAPI?

Yes, it includes async wrappers for the synchronous Cosmos SDK and provides patterns for dependency injection within FastAPI routers.

How do I test my database logic with this skill?

The skill provides standardized pytest fixtures and mocking patterns to test your service layer without requiring a live connection to Cosmos DB.

What is the five-tier model pattern?

It is a structural convention using Pydantic to separate shared fields, creation requests, partial updates, API responses, and internal database documents.

Does this skill support local development?

Yes, it includes specific configurations and patterns for connecting to the local Azure Cosmos DB Emulator using well-known keys while maintaining production security.

How does it handle database security?

The skill enforces industry best practices by using DefaultAzureCredential for RBAC in Azure environments and requiring parameterized queries to prevent NoSQL injection.

Azure Cosmos DB for Python

Name: Azure Cosmos DB for Python
Author: microsoft

bymicrosoft

•

1,777

•

Database Management

Implements production-grade Azure Cosmos DB NoSQL service layers for Python and FastAPI applications using best-practice architecture.

This skill provides a comprehensive framework for building robust, secure, and testable Azure Cosmos DB implementations using the Python SDK. It guides developers through setting up singleton client modules with dual-authentication (RBAC via DefaultAzureCredential and local Emulator support), architecting service layers for clean separation of concerns, and implementing five-tier Pydantic model hierarchies. Ideal for developers needing to implement reliable persistence, complex partitioning strategies, and TDD-based database interactions within FastAPI or general Python backend environments.

Key Features

01Standardized five-tier Pydantic model patterns for scalable schema management

02Production-ready service layer architecture with document-to-model conversion

03Dual authentication setup supporting DefaultAzureCredential and local Cosmos Emulator

041,777 GitHub stars

05Secure, parameterized query implementation to prevent NoSQL injection

06Comprehensive TDD patterns with pytest fixtures for mocking Cosmos DB containers

Use Cases

01Implementing complex NoSQL data models using Pydantic and partitioning strategies

02Transitioning from local development to Azure production environments using RBAC

03Building a scalable FastAPI backend with Cosmos DB NoSQL persistence

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microsoft/skills azure-cosmos-db-py

For use in Claude.ai and ChatGPT

Download Skill