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

@azure/cosmos (TypeScript/JavaScript)

آمن

Cosmos DB-Anwendungen mit TypeScript entwickeln

Entwickler müssen CRUD-Operationen auf Azure Cosmos DB-Dokumenten effizient durchführen. Dieses Skill bietet TypeScript-Muster für Abfragen, Massenoperationen und ordnungsgemäße Authentifizierung.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "@azure/cosmos (TypeScript/JavaScript)". Erstellen Sie ein Produktdokument mit name 'Laptop', price 999.99, category 'electronics'

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

Dokument mit id 'prod-8a7b2c' erfolgreich in Container 'products' erstellt. Anforderungsgebühr: 5.21 RUs.

استخدام "@azure/cosmos (TypeScript/JavaScript)". Abfragen von Produkten, bei denen price < 1000 und category = 'electronics'

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

15 Produkte, die den Kriterien entsprechen, abgerufen. Gesamte Anforderungsgebühr: 3.47 RUs. Ergebnisse umfassen: 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
الامتثال للمواصفات

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

Backend-Entwickler erstellt eine SaaS-Anwendung

Implementieren Sie eine mehrmandantenfähige Datenzugriffsschicht mit hierarchischen Partitionsschlüsseln, um Kundendaten zu isolieren und gleichzeitig die Abfrageleistung zu erhalten.

Dateningenieur verarbeitet Hochvolumen-Transaktionen

Verwenden Sie Massenoperationen, um effizient Tausende von Dokumenten pro Sekunde einzufügen, zu aktualisieren und zu löschen, mit ordnungsgemäßer Fehlerbehandlung.

Full-Stack-Entwickler erstellt Echtzeit-Anwendungen

Erstellen Sie Change-Feed-Prozessoren und implementieren Sie optimistische Nebenläufigkeit, um gleichzeitige Aktualisierungen von mehreren Clients zu verarbeiten.

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

Grundlegende Dokumentenerstellung 
Erstellen Sie eine TypeScript-Funktion, die ein neues Produktdokument in Azure Cosmos DB einfügt. Das Produkt sollte die Felder id, name, price und category haben. Verwenden Sie DefaultAzureCredential für die Authentifizierung und geben Sie eine ordnungsgemäße Fehlerbehandlung für doppelte Dokumente ein.
Parametrisierte Abfrageimplementierung 
Schreiben Sie eine TypeScript-Dienstmethode, die Cosmos DB nach Produkten in einem Preisbereich abfragt. Verwenden Sie SqlQuerySpec mit benannten Parametern, um Injektionsangriffe zu verhindern. Fügen Sie Paginierungsunterstützung mit Fortsetzungs-Tokens ein.
Massenoperation für Datenmigration 
Implementieren Sie eine Massenimportfunktion, die ein Array von 1000+ Dokumenten mit executeBulkOperations verarbeitet. Behandeln Sie Teilfehler, indem Sie fehlgeschlagene Operationen mit ihren Statuscodes protokollieren, während erfolgreiche fortgesetzt werden.
Optimistische Nebenläufigkeit mit ETags 
Erstellen Sie eine Aktualisierungsfunktion, die ETags verwendet, um verloren gegangene Aktualisierungen zu verhindern, wenn mehrere Benutzer dasselbe Dokument ändern. Geben Sie einen spezifischen Fehler zurück, wenn die ETag-Voraussetzung fehlschlägt, damit der Client aktualisieren und wiederholen kann.

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

  • Verwenden Sie DefaultAzureCredential für die Authentifizierung anstelle von Kontoschlüsseln in Produktionsumgebungen
  • Verwenden Sie immer parametrisierte Abfragen mit SqlQuerySpec, um Injektionen zu verhindern und die Abfrageplan-Caching zu verbessern
  • Geben Sie Partitionsschlüsselwerte in allen Punktoperationen an, um den Aufwand für partitionübergreifende Abfragen zu vermeiden

تجنب

  • Direkte Verwendung von Kontoschlüsseln im Code anstelle von Umgebungsvariablen oder verwalteter Identität
  • Ausführen von SELECT *-Abfragen ohne WHERE-Klauseln auf großen Containern
  • Ignorieren von 429-Ratenlimit-Fehlern anstelle der Implementierung von exponentiellem Backoff-Wiederholungslogik

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

Welche Authentifizierungsmethode sollte ich für Cosmos DB verwenden?
Verwenden Sie DefaultAzureCredential mit Azure AD-Authentifizierung für die Produktion. Es unterstützt verwaltete Identität, CLI-Anmeldeinformationen und Umgebungsvariablen. Verwenden Sie Kontoschlüssel nur für die lokale Entwicklung.
Wie wähle ich einen guten Partitionsschlüssel?
Wählen Sie eine Eigenschaft mit hoher Kardinalität und gleichmäßiger Verteilung. Häufige Wahlmöglichkeiten sind customerId, tenantId oder ein synthetischer Schlüssel. Vermeiden Sie Eigenschaften mit niedriger Kardinalität wie status oder boolesche Werte.
Was ist der Unterschied zwischen create, upsert und replace?
Create schlägt fehl, wenn das Dokument vorhanden ist. Upsert erstellt oder aktualisiert basierend auf id. Replace erfordert, dass das Dokument vorhanden ist, und ersetzt das gesamte Dokument. Verwenden Sie patch für teilweise Aktualisierungen.
Wie gehe ich mit Ratenbegrenzung um (429-Fehler)?
Das SDK enthält integrierte Wiederholungslogik. Für benutzerdefinierte Behandlung fangen Sie ErrorResponse mit Code 429 ab und verwenden die Eigenschaft retryAfterInMs, um exponentielles Backoff zu implementieren.
Kann ich dieses Skill mit Cosmos DB MongoDB API verwenden?
Nein. Dieses Skill ist nur für die NoSQL (SQL)-API. Verwenden Sie für die MongoDB-API die offiziellen MongoDB-Treiber oder den Azure Cosmos DB MongoDB-Treiber.
Wie optimiere ich die Abfrageleistung?
Verwenden Sie selektive Projektionen anstelle von SELECT *, filtern Sie mit WHERE-Klauseln für indizierte Eigenschaften, geben Sie partitionKey in FeedOptions an und aktivieren Sie partitionübergreifende Abfragen nur bei Bedarf.

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

المؤلف

sickn33

الترخيص

MIT

المستودع

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

مرجع

main

بنية الملفات

📄 SKILL.md