azure-stream-analytics について
Azure Stream Analytics を扱うエージェント向けのリファレンススキルです。ローカルの早見情報とリモート文書の取得を組み合わせ、ジョブ設計、診断、セキュリティ、連携、デプロイを扱います。
主な機能
- 01ジョブのエラーと性能の診断
- 02クエリとジョブ設計のガイダンス
- 03スケーリングとアーキテクチャ計画
- 04セキュリティ構成の参照情報
- 05連携とコーディングパターン
活用シーン
- 01入力、出力、クエリのエラー特定
- 02ジョブ性能と並列化の改善
- 03ジョブの拡張とデプロイの計画
MCP 対応
mcp_microsoftdocs のツールでリモート文書を取得できます。利用できない場合の代替として fetch_webpage が案内されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-stream-analyticsインストール後、Claude Code で/azure-stream-analyticsを入力して読み込まれたか確認します。
詳細
Azure Stream Analytics スキル
このスキルでは、Azure Stream Analytics に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートのドキュメント取得機能を組み合わせています。
このスキルの使い方
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-L58 | ログとジョブ図(論理/物理)を使った、Stream Analytics ジョブのエラー(構成、データ、内部/外部)、パフォーマンスの問題、入力/出力/クエリの問題の診断と修正。 |
| ベストプラクティス | L59-L73 | Stream Analytics ジョブの設計、クエリパターン、パフォーマンスチューニング、スケーリング、信頼性、時間処理、地理空間ロジック、ML/Cosmos/SQL 出力、アラートに関するベストプラクティス。 |
| 意思決定 | L74-L82 | Stream Analytics のツールとサービスの選択、Visual Studio/.NET UDF からの移行、自動スケーリングとリアルタイム処理オプションの構成に関するガイダンス。 |
| アーキテクチャと設計パターン | L83-L88 | 回復性と地理冗長性を備えた Stream Analytics トポロジの設計、Streaming Units、入力/出力のパーティション分割、パフォーマンスチューニングパターンを使ったジョブのスケーリング。 |
| 制限とクォータ | L89-L96 | Stream Analytics の制限、サイズ設定、パフォーマンス:Event Hubs の出力サイズ上限、Streaming Unit/クラスターのスケーリング、IoT Edge 固有の制限とサポート。 |
| セキュリティ | L97-L117 | 入力/出力(Event Hubs、SQL、Synapse、Cosmos、Blob、Service Bus、Power BI)のマネージド ID、VNet/プライベートエンドポイント、データ保護、Azure Policy への準拠による Stream Analytics ジョブのセキュリティ保護。 |
| 構成 | L118-L149 | Stream Analytics ジョブの構成:入力、出力(Cosmos DB、SQL、Event Hubs、Kafka、Power BI、Delta Lake など)、自動スケーリング、順序付け、エラー処理、監視、互換性。 |
| 統合とコーディングパターン | L150-L166 | Stream Analytics と Kafka、SQL、Azure ML、UDF(C#/JS)、異常検出、スキーマレジストリを統合するパターンとコード、および HFT や .NET によるジョブ管理などの高度なシナリオ。 |
| デプロイ | L167-L180 | ARM/Bicep、GitHub Actions、Azure DevOps、REST、エッジ/Stack Hub ツールを使った、Stream Analytics のジョブとクラスターのデプロイ、移行、ライフサイクル(開始/停止/削除)の自動化。 |
トラブルシューティング
ベストプラクティス
意思決定
| トピック | URL |
|---|---|
| Azure Stream Analytics ポータルと VS Code ツールのどちらを選ぶか | https://learn.microsoft.com/en-us/azure/stream-analytics/feature-comparison |
| Stream Analytics プロジェクトを Visual Studio から VS Code に移行する | https://learn.microsoft.com/en-us/azure/stream-analytics/migrate-to-vscode |
| Stream Analytics SU のオートスケールを選択して構成する | https://learn.microsoft.com/en-us/azure/stream-analytics/stream-analytics-autoscale |
| Stream Analytics の .NET UDF から JavaScript に移行する | https://learn.microsoft.com/en-us/azure/stream-analytics/stream-analytics-edge-csharp-udf-methods |
| Azure のリアルタイム処理サービスとストリーム処理サービスを選択する | https://learn.microsoft.com/en-us/azure/stream-analytics/streaming-technologies |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| 地理冗長性を備えた Azure Stream Analytics ジョブのアーキテクチャを設計する | https://learn.microsoft.com/en-us/azure/stream-analytics/geo-redundancy |
| SU とパーティション分割で Azure Stream Analytics ジョブをスケーリングする | https://learn.microsoft.com/en-us/azure/stream-analytics/stream-analytics-scale-jobs |
制限とクォータ
| トピック | URL |
|---|---|
| サイズ制限のある Stream Analytics 出力として Event Hubs を使用する | https://learn.microsoft.com/en-us/azure/stream-analytics/event-hubs-output |
| ストリーミングユニットで Azure Stream Analytics クラスターのサイズを変更する | https://learn.microsoft.com/en-us/azure/stream-analytics/scale-cluster |
| IoT Edge 上の Azure Stream Analytics の制限とサポートについて理解する | https://learn.microsoft.com/en-us/azure/stream-analytics/stream-analytics-edge |
| Azure Stream Analytics のストリーミングユニットを理解し、調整する | https://learn.microsoft.com/en-us/azure/stream-analytics/stream-analytics-streaming-unit-consumption |