azure-data-explorer
Azure Data Explorerの開発全般について、トラブルシューティングから設計、セキュリティ、パフォーマンス改善まで幅広く支援するSkill。
📜 元の英語説明(参考)
Expert knowledge for Azure Data Explorer development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when securing clusters, configuring ingestion, integrating clients/BI tools, tuning queries, or troubleshooting ADX, and other Azure Data Explorer related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure Stream Analytics (use azure-stream-analytics), Azure HDInsight (use azure-hdinsight), Azure Databricks (use azure-databricks).
🇯🇵 日本人クリエイター向け解説
Azure Data Explorerの開発全般について、トラブルシューティングから設計、セキュリティ、パフォーマンス改善まで幅広く支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure Data Explorer スキル
このスキルは、Azure Data Explorer に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイメントを網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使い方
エージェントへの重要事項: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ（例:
L35-L120）については、指定された行でread_fileを使用してください。ファイルリンクが指定されているカテゴリ（例:[security.md](security.md)）については、リンクされた参照ファイルでread_fileを使用してください。
エージェントへの重要事項:
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-L47 | ADX クラスターの正常性、作成、接続、プライベートエンドポイント、取り込み、DB/テーブル操作のエラーの診断と修正。エラーコードの解釈や Azure Resource Health の使用を含みます。 |
| ベストプラクティス | L48-L59 | ADX のパフォーマンスと信頼性に関するガイダンス: スキーマ設計、重複の処理、JSON 取り込み、キューイングされた取り込みの監視、ホット/コールドデータクエリ、高同時実行性、Power BI 統合。 |
| 意思決定 | L60-L73 | ADX クラスター SKU の選択、スケーリング、機密/分離されたコンピューティング、ストリーミング取り込み、Elasticsearch からの移行、予約と GB あたりのコストによる最適化/価格設定に関するガイダンス。 |
| アーキテクチャと設計パターン | L74-L80 | DR、リージョンレプリケーション、ビジネス継続性、フォロワー DB を介したクラスター間アクセス、マルチテナントデプロイメントパターン向けの ADX アーキテクチャの設計。 |
| 制限とクォータ | L81-L91 | クラスターの制限と動作: 無料クラスターのクォータ、自動停止、安全な削除/回復、取り込みファイルサイズと無効なデータ処理、サポートされるデータ/圧縮形式。 |
| セキュリティ | L92-L119 | ADX クラスターのセキュリティ保護: 認証/RBAC、マネージドID、暗号化/CMK、ネットワーク分離（プライベートエンドポイント、アウトバウンド/パブリックアクセス）、ポリシー、ロック、プライバシーデータパージ。 |
| 構成 | L120-L136 | ADX クラスター、スキーマ、ポリシー、プラグイン、データ接続の構成、エミュレーターのセットアップ、KQL/T-SQL の使用、監視リファレンス、Web UI 設定/プロファイル/ショートカット。 |
| 統合とコーディングパターン | L137-L170 | ADX とツールおよびサービス（SQL、ODBC/JDBC、Power Automate/Apps、Functions、Grafana、Splunk、OpenTelemetry、Tableau、MATLAB など）の統合、およびそれらの接続のためのコーディング/クエリパターン。 |
| デプロイメント | L171-L177 | ADX 環境のプロビジョニングと自動化、Azure DevOps を介したスキーマのデプロイ、クラスターのアベイラビリティゾーンへの移行、VNet インジェクションからプライベートエンドポイントへの移行。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Data Explorer クラスターの正常性を監視およびトラブルシューティングする | https://learn.microsoft.com/en-us/azure/data-explorer/check-cluster-health |
| ADX 取り込みエラーコードと失敗を解釈する | https://learn.microsoft.com/en-us/azure/data-explorer/error-codes |
| Resource Health を使用して ADX の問題を診断する | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-with-resource-health |
| Azure Data Explorer プライベートエンドポイントの問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-private-endpoint-troubleshoot |
| Azure Data Explorer クラスター接続の問題を修正する | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-connect-cluster |
| Azure Data Explorer クラスター作成の失敗をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-create-cluster |
| Azure Data Explorer DB およびテーブル操作の失敗を解決する | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-database-table |
ベストプラクティス
| トピック | URL |
|---|---|
| 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 |
| Azure Data Explorer 取り込みに関する FAQ とガイダンス | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-faq |
| 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/confidential-compute |
| Azure Data Explorer でストリーミング取り込みを使用するタイミングを決定する | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-data-streaming |
| Data Explorer クラスターに分離されたコンピューティング SKU を選択する | https://learn.microsoft.com/en-us/azure/data-explorer/isolated-compute |
| 最適な Azure Data Explorer コンピューティング SKU を選択する | https:// |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure Data Explorer Skill
This skill provides expert guidance for Azure Data Explorer. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L47 | Diagnosing and fixing ADX cluster health, creation, connection, private endpoint, ingestion, and DB/table operation errors, including interpreting error codes and using Azure Resource Health. |
| Best Practices | L48-L59 | Guidance on ADX performance and reliability: schema design, handling duplicates, JSON ingestion, monitoring queued ingestion, hot/cold data querying, high concurrency, and Power BI integration. |
| Decision Making | L60-L73 | Guidance on choosing ADX cluster SKUs, scaling, confidential/isolated compute, streaming ingestion, migration from Elasticsearch, and optimizing/pricing with reservations and cost per GB. |
| Architecture & Design Patterns | L74-L80 | Designing ADX architectures for DR, regional replication, business continuity, cross-cluster access via follower DBs, and multi-tenant deployment patterns. |
| Limits & Quotas | L81-L91 | Cluster limits and behaviors: free cluster quotas, auto-stop, safe delete/recover, ingestion file size and invalid data handling, and supported data/compression formats. |
| Security | L92-L119 | Securing ADX clusters: auth/RBAC, managed identities, encryption/CMK, network isolation (private endpoints, outbound/public access), policies, locks, and privacy data purge. |
| Configuration | L120-L136 | Configuring ADX clusters, schemas, policies, plugins, and data connections, plus emulator setup, KQL/T-SQL use, monitoring refs, and web UI settings/profiles/shortcuts. |
| Integrations & Coding Patterns | L137-L170 | Integrating ADX with tools and services (SQL, ODBC/JDBC, Power Automate/Apps, Functions, Grafana, Splunk, OpenTelemetry, Tableau, MATLAB, etc.) and coding/query patterns for those connections. |
| Deployment | L171-L177 | Provisioning and automating ADX environments, deploying schema via Azure DevOps, and migrating clusters to availability zones and from VNet injection to private endpoints. |
Troubleshooting
| Topic | URL |
|---|---|
| Monitor and troubleshoot Azure Data Explorer cluster health | https://learn.microsoft.com/en-us/azure/data-explorer/check-cluster-health |
| Interpret ADX ingestion error codes and failures | https://learn.microsoft.com/en-us/azure/data-explorer/error-codes |
| Use Resource Health to diagnose ADX issues | https://learn.microsoft.com/en-us/azure/data-explorer/monitor-with-resource-health |
| Troubleshoot Azure Data Explorer private endpoint issues | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-private-endpoint-troubleshoot |
| Fix Azure Data Explorer cluster connection issues | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-connect-cluster |
| Troubleshoot Azure Data Explorer cluster creation failures | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-create-cluster |
| Resolve Azure Data Explorer DB and table operation failures | https://learn.microsoft.com/en-us/azure/data-explorer/troubleshoot-database-table |
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design ADX regional DR and replication solutions | https://learn.microsoft.com/en-us/azure/data-explorer/business-continuity-create-solution |
| Use follower databases for cross-cluster ADX access | https://learn.microsoft.com/en-us/azure/data-explorer/follower |
| Choose Azure Data Explorer multi-tenant architecture | https://learn.microsoft.com/en-us/azure/data-explorer/multi-tenant |
Limits & Quotas
| Topic | URL |
|---|---|
| Understand automatic stop behavior for inactive clusters | https://learn.microsoft.com/en-us/azure/data-explorer/auto-stop-clusters |
| Apply Event Grid ingestion file size limits in Azure Data Explorer | https://learn.microsoft.com/en-us/azure/data-explorer/create-event-grid-connection |
| Delete and recover Azure Data Explorer clusters safely | https://learn.microsoft.com/en-us/azure/data-explorer/delete-cluster |
| Understand invalid data behavior during ADX ingestion | https://learn.microsoft.com/en-us/azure/data-explorer/ingest-invalid-data |
| Supported data and compression formats for Azure Data Explorer ingestion | https://learn.microsoft.com/en-us/azure/data-explorer/ingestion-supported-formats |
| Use Azure Data Explorer free cluster limits | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free |
| Upgrade free Azure Data Explorer clusters and remove limits | https://learn.microsoft.com/en-us/azure/data-explorer/start-for-free-upgrade |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Automate provisioning of Azure Data Explorer environments | https://learn.microsoft.com/en-us/azure/data-explorer/automated-deploy-overview |
| Use Azure DevOps pipelines for Azure Data Explorer schema deployment | https://learn.microsoft.com/en-us/azure/data-explorer/devops |
| Migrate Azure Data Explorer clusters to availability zones | https://learn.microsoft.com/en-us/azure/data-explorer/migrate-cluster-to-multiple-availability-zone |
| Migrate Azure Data Explorer VNet injection to private endpoints | https://learn.microsoft.com/en-us/azure/data-explorer/security-network-migrate-vnet-to-private-endpoint |