azure-cosmos-db-py
Python 으로 Azure Cosmos DB 서비스 구축하기
적절한 인증, 깔끔한 아키텍처, 테스트 주도 개발을 갖춘 프로덕션 등급의 Azure Cosmos DB NoSQL 서비스를 구현합니다. 이 스킬은 FastAPI 애플리케이션에서 안전한 데이터베이스 통합을 위한 템플릿과 패턴을 제공합니다.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "azure-cosmos-db-py". 이중 인증을 사용한 Cosmos DB 클라이언트 모듈 생성
النتيجة المتوقعة:
get_container() 싱글턴 함수, _is_emulator_endpoint() 감지 도우미, 그리고 DefaultAzureCredential 과 에뮬레이터 키 인증 모드를 모두 지원하는 완전한 cosmos.py 파일.
استخدام "azure-cosmos-db-py". CRUD 작업을 갖춘 ProjectService 구축
النتيجة المتوقعة:
비동기 래퍼, 적절한 Pydantic 모델 변환, 그리고 Cosmos 를 사용할 수 없을 때 예외를 발생시키는 대신 None 을 반환하는 우아한 기능 저하를 사용한 get_by_id, create, update, delete 메서드가 있는 서비스 클래스.
التدقيق الأمني
آمن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.
درجة الجودة
ماذا يمكنك بناءه
SaaS 애플리케이션을 구축하는 백엔드 개발자
워크스페이스당 파티션 키 격리를 사용한 멀티테넌트 데이터 스토리지를 Cosmos DB 로 구현하며, 안전한 프로덕션 배포를 위해 DefaultAzureCredential 을 활용합니다.
개발 환경을 설정하는 DevOps 엔지니어
Cosmos DB 에뮬레이터를 사용한 로컬 개발 환경을 구성하며, 환경 변수를 통한 엔드포인트 설정 및 CI/CD 파이프라인을 위한 테스트 픽스처를 사용합니다.
클라우드 네이티브 애플리케이션을 설계하는 솔루션 아키텍트
리포지터리 및 서비스 계층을 갖춘 깔끔한 아키텍처 패턴을 적용하여, 장기적인 유지보수성을 위해 비즈니스 로직과 데이터베이스 구현을 분리합니다.
جرّب هذه الموجهات
프로덕션용 DefaultAzureCredential 과 로컬 개발용 에뮬레이터 키를 사용하는 싱글턴 패턴의 Cosmos DB 클라이언트 모듈을 생성하세요. SSL 구성 및 컨테이너 초기화를 포함하세요.
Project 엔티티에 대한 CRUD 작업을 제공하는 서비스 클래스를 구축하세요. 5 계층 Pydantic 모델 패턴을 사용하고 Cosmos DB 를 사용할 수 없을 때 우아하게 기능 저하되도록 구현하세요.
@parameter 구문을 사용하여 workspace_id 와 name 으로 프로젝트를 필터링하는 Cosmos DB SQL 쿼리를 구현하세요. CosmosResourceNotFoundError 에 대한 적절한 오류 처리를 포함하세요.
Cosmos DB 컨테이너 작업을 모킹하기 위한 pytest 픽스처를 생성하세요. get_container 함수를 적절히 모킹하여 서비스 계층 메서드에 대한 비동기 테스트 예제를 포함하세요.
أفضل الممارسات
- 프로덕션 환경에서는 항상 DefaultAzureCredential 을 사용하세요 - 소스 코드에 키나 비밀을 하드코딩하지 마세요
- Cosmos DB 쿼리에서 SQL 인젝션을 방지하기 위해 @parameter 구문을 사용한 매개변수화된 쿼리를 사용하세요
- Cosmos DB 를 사용할 수 없을 때 예외를 발생시키는 대신 None 이나 빈 목록을 반환하여 우아하게 기능 저하되도록 구현하세요
تجنب
- 환경 변수나 관리형 ID 를 사용하는 대신 소스 코드에 직접 연결 키나 비밀을 하드코딩
- @parameter 플레이스홀더가 있는 매개변수화된 쿼리 구문 대신 문자열 연결을 사용하여 쿼리 구축
- 연결 풀링을 위한 싱글턴 패턴 대신 요청마다 새 CosmosClient 인스턴스 생성