スキル @azure/cosmos (TypeScript/JavaScript)
📦

@azure/cosmos (TypeScript/JavaScript)

安全

TypeScript で Azure Cosmos DB アプリケーションを構築する

開発者は Azure Cosmos DB ドキュメントに対して効率的に CRUD 操作を行う必要があります。このスキルは、クエリ、バッチ操作、適切な認証のための TypeScript パターンmos DB ドキュメントに対して効率的に CRUD 操作を行う必要があります。このスキルは、クエリ、バルク操作、適切な認証のための TypeScript パターンを提供します。

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「@azure/cosmos (TypeScript/JavaScript)」を使用しています。 名前が 'Lughter'、価格が 999.99、カテゴリが 'electronics' の商品ドキュメントを作成

期待される結果:

コンテナ 'products' に ID 'prod-8a7b2c' のドキュメントが正常に作成されました。要求ユニット: 5.21 RU。

「@azure/cosmos (TypeScript/JavaScript)」を使用しています。 price < 1000 かつ category = 'electronics' の商品をクエリ

期待される結果:

条件に一致する 15 件の商品を取得しました。合計要求ユニット: 3.47 RU。結果: 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
コンテンツ
31
コミュニティ
100
セキュリティ
74
仕様準拠

作れるもの

SaaS アプリケーションを構築するバックエンド開発者

階層パーティションキーを使用して顧客データを分離しながらクエリパフォーマンスを維持するマルチテナントデータレイヤーを実装します。

高ボリュームトランザクションを処理するデータエンジニア

適切なエラー処理により毎秒数千件のドキュメントを効率的に挿入、更新、削除するためにバルク操作を使用します。

リアルタイムアプリケーションを作成するフルスタック開発者

変更フィードプロセッサを構築し、複数のクライアントからの同時更新を処理するために楽観的同時性を実装します。

これらのプロンプトを試す

基本的なドキュメント作成 
Azure Cosmos DB に新しい商品ドキュメントを挿入する TypeScript 関数を作成します。商品には id、name、price、category フィールドが必要です。認証には DefaultAzureCredential を使用し、重複ドキュメントのための適切なエラー処理を含めます。
パラメータ化クエリの実装 
価格範囲内の商品をクエリする TypeScript サービスメソッドを作成します。インジェクション攻撃を防ぐために名前付きパラメータを持つ SqlQuerySpec を使用します。継続トークンを含むページネーションサポートを含めます。
データ移行用のバルク操作 
executeBulkOperations を使用して 1000 以上のドキュメントの配列を処理するバルクインポート関数を実装します。成功したものを続行しながら、失敗した操作とそのステータスコードをログすることで部分的失敗を処理します。
ETag による楽観的同時性 
複数のユーザーが同じドキュメントを変更した場合の失更新を防ぐために ETag を使用する更新関数を作成します。ETag 前提条件が失敗した場合にクライアントが更新して再試行できるように、具体的なエラーを返します。

ベストプラクティス

  • 本番環境ではアカウントキーではなく DefaultAzureCredential を使用して認証を行います
  • インジェクションを防ぎ、クエリプランのキャッシュを改善するために SqlQuerySpec でパラメータ化クエリを常に使用します
  • クロスパーティションクエリのオーバーヘッドを避けるため、すべてのポイント操作でパーティションキー値を指定します

回避

  • 本番環境コードで環境変数やmanaged identity の代わりにアカウントキーを直接使用すること
  • 大容量コンテナで WHERE 句なしで SELECT * クエリを実行すること
  • 指数バックオフリトライロジックを実装する代わりに 429 レート制限エラーを無視すること

よくある質問

Cosmos DB にはどのような認証方法を使用すべきですか？
本番環境には Azure AD 認証で DefaultAzureCredential を使用します。Managed Identity、CLI 資格情報、环境変数をサポートしています。アカウントキーはローカル開発のみに使用してください。
どのようにパーティションキー選択すればよいですか？
カーディナリティが高く均一に分散するプロパティを選択します。一般的な選択には customerId、tenantId、または合成キーが含まれます。status やブール値などのカーディナリティの低いプロパティは避けてください。
create、upsert、replace の違いは何ですか？
Create はドキュメントが存在する場合は失敗します。Upsert は id に基づいて作成または更新します。Replace はドキュメントが存在する必要があり、ドキュメント全体を置換します。部分更新には patch を使用してください。
レート制限（429 エラー）はどのように処理すればよいですか？
SDK には組み込みのリトライロジックが含まれています。カスタム処理を行うには、エラーコード 429 の ErrorResponse をキャッチし、指数バックオフを実装するために 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