azure-data-explorer について
Azure Data Explorer を扱うエージェント向けのガイダンススキルです。運用、設計、セキュリティ、デプロイを扱い、ローカルの索引とネットワーク経由のドキュメント取得を組み合わせています。
主な機能
- 01トラブルシューティングとベストプラクティス
- 02容量、SKU、コストの選定
- 03アーキテクチャ、制限、セキュリティの指針
- 04構成、連携、コーディングパターン
- 05デプロイと移行のガイダンス
活用シーン
- 01クラスター接続やデータ取り込みの問題診断
- 02クラスター容量と事業継続性の計画
- 03セキュリティポリシーやマルチテナント構成の設計
MCP 対応
mcp_microsoftdocs の microsoft_docs_fetch を使ったドキュメント取得に対応します。MCP サーバーとしてツールやリソースを公開するとは記載されていません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/azure-data-explorerを入力して読み込まれたか確認します。
詳細
Azure Data Explorer スキル
このスキルでは、Azure Data Explorer に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使い方
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-L49 | エラーコードや一般的な障害パターンを含め、ADX クラスターの正常性、接続、作成、取り込み、ダッシュボード、データベース／テーブル、プライベートエンドポイント、リソースの正常性に関する問題の診断と解決方法です。 |
| ベストプラクティス | L50-L61 | ADX クラスターとスキーマの最適化、重複と JSON の取り込みへの対処、高い同時実行性に向けた調整、キューに入った取り込みの監視、ホットウィンドウの使用、Power BI のベストプラクティスの適用に関するガイダンスです。 |
| 意思決定 | L62-L76 | ADX の容量計画、SKU とコンピューティングの選択、スケーリング、コスト最適化、予約、事業継続性、コンフィデンシャルコンピューティング、ストリーミング取り込み、Elasticsearch からの移行に関するガイダンスです。 |
| アーキテクチャと設計パターン | L77-L83 | DR／BCP 向けの ADX アーキテクチャ、フォロワーデータベースを介したクラスター間アクセス、マルチテナントパターン（分離、スケーリング、リソース共有）の設計方法です。 |
| 制限とクォータ | L84-L93 | クラスターの制限と動作：無料クラスターのクォータ、自動停止、安全な削除と復旧、取り込みファイルのサイズと無効なデータの処理、サポートされているデータ形式と圧縮形式です。 |
| セキュリティ | L94-L121 | Azure Data Explorer の保護：認証／認可（RBAC、プリンシパル、Entra アプリ、条件付きアクセス）、暗号化、マネージド ID、ネットワーク分離、ポリシー、データのパージ、送信アクセス／パブリックアクセスの制御です。 |
| 構成 | L122-L136 | ADX 環境の構成：データベース／テーブルのポリシー、保持／キャッシュ、テナント間の Event Hubs、Kusto エミュレーター、プラグイン、監視、スキーマ同期、T-SQL、Web UI の設定／ショートカットです。 |
| 統合とコーディングパターン | L137-L171 | Azure Data Explorer とツールやプラットフォーム（SQL、ODBC／JDBC、Power Automate／Apps、Functions、Grafana、Splunk、OpenTelemetry など）を統合する方法と、クエリ、取り込み、自動化のコーディングパターンです。 |
| デプロイ | L172-L178 | ADX クラスターのプロビジョニングとスキーマのデプロイの自動化に加え、クラスターを可用性ゾーンに移行する方法と、VNet インジェクションからプライベートエンドポイントに移行する方法に関するガイダンスです。 |
トラブルシューティング
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Advisor の推奨事項を適用して Data Explorer クラスターを最適化する | https://learn.microsoft.com/en-us/azure/data-explorer/azure-advisor |
| Azure Data Explorer で重複データを処理する | https://learn.microsoft.com/en-us/azure/data-explorer/dealing-with-duplicates |
| 高い同時実行性が求められるワークロード向けに Azure Data Explorer クラスターを最適化する | https://learn.microsoft.com/en-us/azure/data-explorer/high-concurrency |
| ホットウィンドウを使用して Azure Data Explorer のコールドデータを効率的にクエリする | https://learn.microsoft.com/en-us/azure/data-explorer/hot-windows |
| KQL、C#、Python を使用して JSON を Azure Data Explorer に取り込む | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-json-formats |
| ADX でキューに登録された取り込みメトリックを監視する | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-queued-ingestion |
| Azure Data Explorer に Power BI のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/data-explorer/power-bi-best-practices |
| Azure Data Explorer のテーブルスキーマ設計を最適化する | https://learn.microsoft.com/en-us/azure/data-explorer/schema-best-practice |
意思決定
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure Data Explorer の事業継続とディザスター リカバリーを設計する | https://learn.microsoft.com/en-us/azure/data-explorer/business-continuity-create-solution |
| クラスター間で ADX にアクセスするためにフォロワー データベースを使用する | https://learn.microsoft.com/en-us/azure/data-explorer/follower |
| Azure Data Explorer のマルチテナント アーキテクチャを選択する | https://learn.microsoft.com/en-us/azure/data-explorer/multi-tenant |
制限とクォータ
| トピック | URL |
|---|---|
| 非アクティブなクラスターの自動停止動作について理解する | https://learn.microsoft.com/en-us/azure/data-explorer/auto-stop-clusters |
| Azure Data Explorer で Event Grid のインジェスト ファイルサイズ制限を適用する | https://learn.microsoft.com/en-us/azure/data-explorer/create-event-grid-connection |
| Azure Data Explorer クラスターを安全に削除して復旧する | https://learn.microsoft.com/en-us/azure/data-explorer/delete-cluster |
| ADX のインジェスト中に無効なデータがどのように扱われるかを理解する | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-invalid-data |
| Azure Data Explorer のインジェストでサポートされるデータ形式と圧縮形式 | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-supported-formats |
| 無料の Azure Data Explorer クラスターをアップグレードして制限を解除する | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free-upgrade |
セキュリティ
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| Azure Data Explorer 環境のプロビジョニングを自動化する | https://learn.microsoft.com/en-us/azure/data-explorer/automated-deploy-overview |
| Azure Data Explorer のスキーマのデプロイに Azure DevOps パイプラインを使用する | https://learn.microsoft.com/en-us/azure/data-explorer/devops |
| Azure Data Explorer クラスターを複数の可用性ゾーンに移行する | https://learn.microsoft.com/en-us/azure/data-explorer/migrate-cluster-to-multiple-availability-zone |
| Azure Data Explorer の VNet インジェクションをプライベート エンドポイントに移行する | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-migrate-vnet-to-private-endpoint |
コメント
Markdown 対応