migrating-documentdb-to-cosmos

What problem does it solve?

This Skill simplifies the migration process from the deprecated Microsoft.Azure.DocumentDB SDK (V2) to the modern Microsoft.Azure.Cosmos SDK (V3) for Azure Cosmos DB, ensuring compatibility and performance upgrades.

Core Features & Use Cases

• Automatic SDK Version Detection: Identifies usage of the DocumentDB SDK V2 in the project.
• Package Reference Update: Recommends replacing the old package reference with the latest stable version of the Cosmos SDK.
• Client and Resource Model Replacement: Provides instructions for updating the client and resource model to use the V3 SDK.
• CRUD Operation Conversion: Offers guidance on converting CRUD operations from V2 to V3.
• Query Update: Shows how to update queries to work with the V3 SDK.
• Error Handling Migrations: Explains how to adapt error handling from V2 to V3.
• Build and Verification Steps: Ensures the migration is successful through build and verification steps.
• API Differences: Details the differences between the DocumentDB V2 and Cosmos V3 SDKs.
• Troubleshooting: Offers solutions for common migration issues.
• Use Case: Suitable for developers looking to upgrade their applications to leverage the benefits of the newer Cosmos SDK.

Quick Start

Run the 'migrating-documentdb-to-cosmos' skill to begin the migration process from DocumentDB SDK V2 to Cosmos SDK V3.