المهارات @azure/cosmos (TypeScript/JavaScript)
📦

@azure/cosmos (TypeScript/JavaScript)

آمن

TypeScript으로 Azure Cosmos DB 애플리케이션 구축

개발자는 Azure Cosmos DB 문서에서 CRUD 작업을 효율적으로 수행해야 합니다. 이 스킬은 쿼리, 대량 작업 및 적절한 인증을 위한 TypeScript 패턴을 제공합니다.

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "@azure/cosmos (TypeScript/JavaScript)". Create a product document with name 'Laptop', price 999.99, category 'electronics'

النتيجة المتوقعة:

Successfully created document with id 'prod-8a7b2c' in container 'products'. Request charge: 5.21 RUs.

استخدام "@azure/cosmos (TypeScript/JavaScript)". Query products where price < 1000 and category = 'electronics'

النتيجة المتوقعة:

Retrieved 15 products matching criteria. Total request charge: 3.47 RUs. Results include: Laptop, Tablet, Wireless Mouse, USB Hub...

التدقيق الأمني

آمن
v1 • 2/24/2026

Prompt-only instructional skill containing documentation for Azure Cosmos DB SDK usage. Static analysis scanned 0 files with 0 findings and risk score 0/100. No executable code, network access, or security concerns detected. The skill teaches proper security practices including AAD authentication and parameterized queries.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

SaaS 애플리케이션을 구축하는 백엔드 개발자

계층적 파티션 키를 사용하여 쿼리 성능을 유지하면서 고객 데이터를 격리하는 다중 테넌트 데이터 레이어를 구현합니다.

대량 트랜잭션을 처리하는 데이터 엔지니어

대량 작업을 사용하여 적절한 오류 처리와 함께 초당 수천 개의 문서를 효율적으로 삽입, 업데이트 및 삭제합니다.

실시간 애플리케이션을 만드는 풀스택 개발자

변경 피드 프로세서를 구축하고 낙관적 동시성을 구현하여 여러 클라이언트의 동시 업데이트를 처리합니다.

جرّب هذه الموجهات

기본 문서 생성 
Azure Cosmos DB에 새 제품 문서를 삽입하는 TypeScript 함수를 만듭니다. 제품에는 id, name, price, category 필드가 있어야 합니다. 인증에는 DefaultAzureCredential을 사용하고 중복 문서에 대한 적절한 오류 처리를 포함합니다.
매개변수화된 쿼리 구현 
가격 범위 내의 제품을 쿼리하는 TypeScript 서비스 메서드를 작성합니다. SqlQuerySpec과 명명된 매개변수를 사용하여 주입 공격을 방지합니다. 연속 토큰이 있는 페이지네이션 지원을 포함합니다.
데이터 마이그레이션을 위한 대량 작업 
executeBulkOperations를 사용하여 1000개 이상의 문서 배열을 처리하는 대량 가져오기 함수를 구현합니다. 성공적인 작업을 계속하면서 실패한 작업을 상태 코드와 함께 기록하여 부분적 실패를 처리합니다.
ETags를 통한 낙관적 동시성 
여러 사용자가 동일한 문서를 수정할 때 손실된 업데이트를 방지하는 ETag를 사용하는 업데이트 함수를 만듭니다. ETag 전제 조건이 실패할 때 클라이언트가 새로고침하고 재시도할 수 있도록 특정 오류를 반환합니다.

أفضل الممارسات

  • 프로덕션 환경에서는 계정 키 대신 DefaultAzureCredential을 인증에 사용합니다.
  • 주입을 방지하고 쿼리 플랜 캐싱을 개선하려면 항상 SqlQuerySpec과 매개변수화된 쿼리를 사용합니다.
  • 크로스 파티션 쿼리 오버헤드를 피하려면 모든 포인트 작업에서 파티션 키 값을 지정합니다.

تجنب

  • 환경 변수 또는 관리 ID 대신 코드에서 계정 키를 직접 사용
  • 대형 컨테이너에서 WHERE 절 없이 SELECT * 쿼리 실행
  • 지수 백오프 재시도 로직을 구현하는 대신 429速率 제한 오류를 무시

الأسئلة المتكررة

Cosmos DB에 어떤 인증 방법을 사용해야 합니까?
Azure AD 인증과 함께 DefaultAzureCredential을 프로덕션에 사용합니다. 관리 ID, CLI 자격 증명 및 환경 변수를 지원합니다. 로컬 개발에서만 계정 키를 사용합니다.
좋은 파티션 키를 어떻게 선택합니까?
카디널리티가 높고 균등한 분포를 가진 속성을 선택합니다. 일반적인 선택에는 customerId, tenantId 또는 합성 키가 포함됩니다. status 또는布尔 값과 같이 카디널리티가 낮은 속성은 피합니다.
create, upsert, replace의 차이점은 무엇입니까?
Create는 문서가 존재하면 실패합니다. Upsert는 id를 기준으로 생성 또는 업데이트합니다. Replace는 문서가 존재해야 전체 문서를 바꿉니다. 부분 업데이트에는 patch를 사용합니다.
速率 제한(429 오류)을 어떻게 처리합니까?
SDK에는内置 재시도 로직이 포함되어 있습니다. 사용자 지정 처리의 경우, 코드 429의 ErrorResponse를 catch하고 retryAfterInMs 속성을 사용하여 지수 백오프를 구현합니다.
Cosmos DB MongoDB API와 함께 이 스킬을 사용할 수 있습니까?
아닙니다. 이 스킬은 NoSQL(SQL) API에만 해당합니다. MongoDB API의 경우 공식 MongoDB 드라이버 또는 Azure Cosmos DB MongoDB 드라이버를 사용하세요.
쿼리 성능을 어떻게 최적화합니까?
SELECT * 대신 선택적 프로젝션을 사용하고, 인덱스된 속성으로 WHERE 절로 필터링하고, FeedOptions에서 partitionKey를 지정하고, 필요할 때만 크로스 파티션 쿼리를 활성화합니다.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-ts

مرجع

main

بنية الملفات

📄 SKILL.md