【研发类-数据库开发Skills】azure-cosmos-db-py 技能

构建生产级Azure Cosmos DB NoSQL服务遵循整洁代码、安全最佳实践和TDD原则技能概述azure-cosmos-db-py 技能是一个专门用于Azure Cosmos DB Python开发的技能提供了生产级的服务实现指南。该技能涵盖了整洁代码实践、安全最佳实践和测试驱动开发TDD原则帮助开发者构建高质量、可维护的Cosmos DB应用。下载地址https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-db-py主要功能双重认证支持支持DefaultAzureCredentialAzure生产环境和密钥认证本地模拟器异步操作通过run_in_threadpool实现异步包装单例模式容器初始化采用单例模式优化性能优雅降级当Cosmos不可用时提供优雅降级处理文档模型转换自动处理文档与模型之间的转换触发条件在以下情况下应该调用此技能需要使用Python开发Azure Cosmos DB应用需要实现生产级的Cosmos DB服务层需要配置Cosmos DB客户端和容器需要实现文档CRUD操作需要处理Cosmos DB认证和连接处理过程1. 安装依赖安装azure-cosmos和azure-identity包pip install azure-cosmos azure-identity2. 配置环境变量设置Cosmos DB端点、数据库名称和容器ID等环境变量3. 初始化客户端创建Cosmos客户端支持双重认证方式4. 实现服务层构建服务层处理业务逻辑和文档转换输入要求使用此技能时用户需要提供Cosmos DB账户端点数据库名称和容器ID认证凭据Azure凭据或模拟器密钥数据模型定义输出说明技能将提供完整的Cosmos DB客户端配置代码服务层实现示例文档CRUD操作封装最佳实践和安全建议使用示例示例客户端初始化from azure.cosmos import CosmosClientfrom azure.identity import DefaultAzureCredentialclient CosmosClient(urlos.environ[COSMOS_ENDPOINT],credentialDefaultAzureCredential())最佳实践安全性生产环境使用DefaultAzureCredential避免硬编码密钥性能使用单例模式管理容器实例可靠性实现优雅降级和错误处理测试使用模拟器进行本地开发和测试