azure-cosmos-db-py
Construir Servicios Azure Cosmos DB con Python
Implemente servicios Azure Cosmos DB NoSQL de nivel de producción con autenticación adecuada, arquitectura limpia y desarrollo guiado por pruebas. Esta habilidad proporciona plantillas y patrones para integración segura de bases de datos en aplicaciones FastAPI.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“azure-cosmos-db-py”。 Crear un módulo cliente Cosmos DB con autenticación dual
预期结果:
Un archivo cosmos.py completo con función singleton get_container(), helper _is_emulator_endpoint(), y soporte para ambos modos de autenticación DefaultAzureCredential y clave de emulador.
正在使用“azure-cosmos-db-py”。 Construir un ProjectService con operaciones CRUD
预期结果:
Clase de servicio con métodos get_by_id, create, update, y delete usando envoltorios asíncronos, conversión adecuada de modelo Pydantic, y degradación elegante devolviendo None cuando Cosmos no está disponible.
安全审计
安全All 37 static analysis findings are false positives. The scanned file (SKILL.md) is a documentation file containing code examples in markdown format, not executable code. External command detections are bash examples in documentation blocks. Network and environment variable references are configuration templates for Azure Cosmos DB connectivity. The skill demonstrates proper security practices including RBAC via DefaultAzureCredential, parameterized queries, and secure secret management.
质量评分
你能构建什么
Desarrollador Backend Construyendo Aplicación SaaS
Implemente almacenamiento de datos multiinquilino usando Cosmos DB con aislamiento de clave de partición por espacio de trabajo, aprovechando DefaultAzureCredential para despliegue seguro en producción.
Ingeniero DevOps Configurar Entorno de Desarrollo
Configure desarrollo local con emulador Cosmos DB, usando variables de entorno para configuración de endpoint y fixtures de prueba para pipelines CI/CD.
Arquitecto de Soluciones Diseñando Aplicaciones Cloud-Native
Aplique patrones de arquitectura limpia con capas de repositorio y servicio, asegurando separación de lógica de negocio de la implementación de base de datos para mantenibilidad a largo plazo.
试试这些提示
Cree un módulo cliente Cosmos DB con patrón singleton que use DefaultAzureCredential para producción y clave de emulador para desarrollo local. Incluya configuración SSL e inicialización de contenedor.
Construya una clase de servicio para entidad Project con operaciones CRUD. Use el patrón de modelo Pydantic de cinco niveles e implemente degradación elegante cuando Cosmos DB no esté disponible.
Implemente consultas SQL de Cosmos DB usando sintaxis @parameter para filtrar proyectos por workspace_id y name. Incluya manejo adecuado de errores para CosmosResourceNotFoundError.
Cree fixtures de pytest para simular operaciones de contenedor Cosmos DB. Incluya ejemplos de pruebas asíncronas para métodos de capa de servicio con simulación adecuada de la función get_container.
最佳实践
- Siempre use DefaultAzureCredential en entornos de producción - nunca codifique claves o secretos directamente en el código fuente
- Use consultas parametrizadas con sintaxis @parameter para prevenir inyección SQL en consultas de Cosmos DB
- Implemente degradación elegante devolviendo None o listas vacías cuando Cosmos DB no esté disponible en lugar de lanzar excepciones
避免
- Codificar claves de conexión o secretos directamente en el código fuente en lugar de usar variables de entorno o identidad gestionada
- Usar concatenación de strings para construir consultas en lugar de sintaxis de consulta parametrizada con placeholders @parameter
- Crear nuevas instancias de CosmosClient por petición en lugar de usar patrón singleton para pooling de conexiones