azure-documentdb について
このスキルは Azure DocumentDB を扱う開発者やアーキテクト向けに、設定からセキュリティ、デプロイ、連携までを案内します。運用と設計のテーマ別に、ローカルのクイックリファレンスと外部ドキュメントを整理しています。
主な機能
- 01クエリ、ネットワーク、レプリケーションの問題調査
- 02インデックスと高可用性の計画
- 03MongoDB 移行方法の評価
- 04検索、レプリケーション、トランザクションの設定
- 05セキュリティ制御とクォータの確認
- 06クラスターのデプロイ、バックアップ、アップグレード
活用シーン
- 01クエリ性能や接続問題の診断
- 02MongoDB から DocumentDB への移行計画
- 03ベクトル検索や高可用性システムの設計
- 04セキュアなクラスターとデプロイワークフローの設定
MCP 対応
このスキルは Microsoft ドキュメントの取得に mcp_microsoftdocs MCP ツールを推奨し、代替手段としてウェブページ取得を案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-documentdbインストール後、Claude Code で/azure-documentdbを入力して読み込まれたか確認します。
詳細
Azure DocumentDB スキル
このスキルでは、Azure DocumentDB に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行の範囲が指定されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先のリファレンスファイルをread_fileで読み取ってください
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールが利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでドキュメントの内容を取得するには、ネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L46 | DocumentDB の問題の診断と解決:クエリのパフォーマンス、CMK 暗号化、レプリケーション、移行関連の問題を含む一般的な接続およびネットワークエラー。 |
| ベストプラクティス | L47-L57 | DocumentDB のインデックスとクエリ、安全なインデックス変更、回復性とパフォーマンスに優れたデータアクセスを実現するクロスリージョンレプリケーションと高可用性の構成に関するベストプラクティス。 |
| 意思決定 | L58-L73 | DocumentDB と MongoDB/Atlas の選択、MongoDB の移行計画、接続方法とクロスリージョンフェールオーバーの選択、.NET、Go、TS、Python で最適なベクトルインデックス/検索アルゴリズムを選ぶためのガイド。 |
| アーキテクチャと設計パターン | L74-L85 | Azure DocumentDB でのスケーリング、HA/DR、シャーディング、マルチクラウド構成、Go/TypeScript AI エージェント(自律型旅行エージェントを含む)の構築パターン。 |
| 制限とクォータ | L86-L99 | DocumentDB の制限、クォータ、構成上の制約:コンピューティング/ストレージ階層、無料利用枠の上限、SSD のパフォーマンス、インデックス/テキストインデックスの制限、ドキュメント/バッチのサイズ、診断、機能の利用可否。 |
| セキュリティ | L100-L111 | DocumentDB クラスターのセキュリティ保護:保存データの暗号化と顧客管理キー、ファイアウォールとパブリックアクセスの制御、Private Link、Entra ID RBAC、ネイティブユーザー/権限、セキュリティのベストプラクティス。 |
| 構成 | L112-L132 | DocumentDB の機能の構成:検索(BM25、ベクトル、あいまい検索、フレーズ検索、地理空間検索)、MongoDB 互換性、変更ストリーム、レプリケーション/スケーリング、トランザクション、Data API、アラート、監視。 |
| 統合とコーディングパターン | L133-L155 | Azure DocumentDB と各種言語、ドライバー、RAG ツール、ベクトル検索を統合するためのパターンとコードサンプルに加え、移行(Mongo/Cassandra)や MERN、AI 広告などのアプリケーションシナリオ。 |
| デプロイ | L156-L162 | DocumentDB クラスターのデプロイと管理に関するガイド:ローカル開発から Azure への移行、バックアップ/復元、バージョンアップグレード、Bicep と Terraform による IaC デプロイ。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure DocumentDB の一般的な問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/documentdb/faq |
| Azure DocumentDB の CMK 暗号化の問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/documentdb/how-to-database-encryption-troubleshoot |
| DocumentDB の explain() を使用してクエリのパフォーマンスを診断する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-read-explain-output |
| Azure DocumentDB の一般的なエラーと接続の問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-common-issues |
| DocumentDB の移行におけるネットワーク接続をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-connectivity |
| Azure DocumentDB のレプリケーションの問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-replication |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure DocumentDB でバックグラウンドインデックス作成を安全に使用する | https://learn.microsoft.com/en-us/azure/documentdb/background-indexing |
| DocumentDB でリージョン間レプリケーションのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/documentdb/cross-region-replication |
| DocumentDB で HA とレプリケーションのベストプラクティスを実装する | https://learn.microsoft.com/en-us/azure/documentdb/high-availability-replication-best-practices |
| Azure DocumentDB コレクションにインデックス作成のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-create-indexes |
| Azure DocumentDB の実践的なインデックス作成シナリオを確認する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-index |
| DocumentDB で非順序インデックスから順序付きインデックスへ安全に移行する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-migrate-ordered-indexes |
| Index Advisor で Azure DocumentDB のクエリを最適化する | https://learn.microsoft.com/en-us/azure/documentdb/index-advisor |
意思決定
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure DocumentDB ワークロードに自動スケーリング動作を適用する | https://learn.microsoft.com/en-us/azure/documentdb/autoscale |
| Azure DocumentDB の HA と DR の内部動作を理解する | https://learn.microsoft.com/en-us/azure/documentdb/availability-disaster-recovery-under-hood |
| Azure DocumentDB クラスターの高可用性を計画する | https://learn.microsoft.com/en-us/azure/documentdb/high-availability |
| Azure DocumentDB を使用してマルチクラウドアーキテクチャを設計する | https://learn.microsoft.com/en-us/azure/documentdb/multi-cloud |
| Azure DocumentDB のシャーディング戦略を設計する | https://learn.microsoft.com/en-us/azure/documentdb/partitioning |
| DocumentDB を使用して Go ベースの AI エージェントを実装する | https://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-go |
| DocumentDB のベクトル検索を使用して TypeScript AI エージェントを構築する | https://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-nodejs |
| DocumentDB を使用して自律型旅行エージェントを設計する | https://learn.microsoft.com/en-us/azure/documentdb/tutorial-ai-agent |
制限とクォータ
セキュリティ
| トピック | URL |
|---|---|
| Azure DocumentDB の保存データの暗号化について理解する | https://learn.microsoft.com/en-us/azure/documentdb/database-encryption-at-rest |
| Azure DocumentDB のファイアウォールアクセス規則を構成する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-configure-firewall |
| Azure DocumentDB の Entra ID RBAC 認証を構成する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-connect-role-based-access-control |
| Azure DocumentDB のカスタマー管理の暗号化キーを構成する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-data-encryption |
| Azure Private Link を使用して Azure DocumentDB を保護する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-private-link |
| Azure DocumentDB クラスターへのパブリックネットワークアクセスを管理する | https://learn.microsoft.com/en-us/azure/documentdb/how-to-public-access |
| DocumentDB のセカンダリネイティブユーザーと権限を管理する | https://learn.microsoft.com/en-us/azure/documentdb/secondary-users |
| Azure DocumentDB クラスターにセキュリティのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/documentdb/security |
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| DocumentDB を使用してローカルで開発し、Azure にデプロイする | https://learn.microsoft.com/en-us/azure/documentdb/development-loop |
| Azure DocumentDB クラスターを新しい MongoDB バージョンにアップグレードする | https://learn.microsoft.com/en-us/azure/documentdb/how-to-upgrade-cluster |
| Bicep で Azure DocumentDB クラスターをデプロイする | https://learn.microsoft.com/en-us/azure/documentdb/quickstart-bicep |
| Terraform を使用して Azure DocumentDB クラスターをデプロイする | https://learn.microsoft.com/en-us/azure/documentdb/quickstart-terraform |