azure-synapse-analytics
Azure Synapse Analyticsの開発において、トラブルシューティング、ベストプラクティス、アーキテクチャ設計、セキュリティ、設定、統合、デプロイに関する専門知識を提供するSkill。
📜 元の英語説明(参考)
Expert knowledge for Azure Synapse Analytics development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Synapse SQL pools, Spark pools, serverless SQL, Synapse Link, or ELT/PolyBase pipelines, and other Azure Synapse Analytics related development tasks. Not for Azure Analysis Services (use azure-analysis-services), Azure Data Explorer (use azure-data-explorer), Azure Data Factory (use azure-data-factory), Azure Databricks (use azure-databricks).
🇯🇵 日本人クリエイター向け解説
Azure Synapse Analyticsの開発において、トラブルシューティング、ベストプラクティス、アーキテクチャ設計、セキュリティ、設定、統合、デプロイに関する専門知識を提供するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-synapse-analytics.zip https://jpskill.com/download/5788.zip && unzip -o azure-synapse-analytics.zip && rm azure-synapse-analytics.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5788.zip -OutFile "$d\azure-synapse-analytics.zip"; Expand-Archive "$d\azure-synapse-analytics.zip" -DestinationPath $d -Force; ri "$d\azure-synapse-analytics.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
azure-synapse-analytics.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
azure-synapse-analyticsフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 この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 Synapse Analytics スキル
このスキルは、Azure Synapse Analytics に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使い方
エージェントへの重要事項: 以下のカテゴリインデックスを使用して、関連するセクションを見つけてください。行範囲が指定されているカテゴリ（例:
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-L66 | Synapse ワークスペース、SQL プール、Spark、Studio、Synapse Link の問題（接続、パフォーマンス、ジョブ失敗、テナント移動、ワークロードの誤分類など）の診断と修正。 |
| ベストプラクティス | L67-L128 | Synapse のパフォーマンス、SQL/T-SQL パターン、Spark の最適化、インデックス/統計、データロード、Netezza、Oracle、Teradata からの移行/モダナイゼーションに関するベストプラクティス。 |
| 意思決定 | L129-L149 | Synapse コンポーネントの選択、サイジングとコストモデル、環境の計画/評価、データウェアハウスを Synapse SQL に移行またはアップグレードするためのツール/手順に関するガイダンス。 |
| アーキテクチャと設計パターン | L150-L169 | Synapse ワークスペース、SQL/サーバーレス/Spark プール、データウェアハウスの移行、テーブル/分散/パーティション戦略、ELT/PolyBase ロード、ワークロード管理に関するアーキテクチャと設計ガイダンス。 |
| 制限とクォータ | L170-L178 | SQL および Synapse Link の制限: メモリ/同時実行数の上限、専用プール容量/クォータ、Delta Lake v1 のサーバーレス SQL 制限、Synapse Link (Cosmos DB、SQL) の機能/既知の問題。 |
| セキュリティ | L179-L239 | Synapse ワークスペースのエンドツーエンドのセキュリティ: 認証と RBAC、ネットワークとプライベートエンドポイント、ファイアウォールとデータ流出、暗号化/TDE、ポリシー、マネージドID、安全なデータアクセス/移行。 |
| 構成 | L240-L288 | Synapse ワークスペース、Spark プール、SQL プールの構成: ランタイム、スケーリング、ライブラリ、監視/メトリック、バックアップ/復元、ワークロード管理、統合 (Purview、AML)。 |
| 統合とコーディングパターン | L289-L338 | Synapse (Spark、サーバーレス、専用 SQL) をストレージ、ML、監視、外部ツール、その他の Azure サービスと統合するためのパターンとコード、および外部データ形式のクエリ。 |
| デプロイ | L339-L346 | CI/CD と ARM テンプレートを使用した Synapse ワークスペースと専用 SQL プールのデプロイガイド、運用準備状況チェック、SQL プールメンテナンスウィンドウの構成。 |
トラブルシューティング
（原文がここで切り詰められています）
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure Synapse Analytics Skill
This skill provides expert guidance for Azure Synapse Analytics. 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-L66 | Diagnosing and fixing Synapse workspace, SQL pool, Spark, Studio, and Synapse Link issues, including connectivity, performance, job failures, tenant moves, and workload misclassification. |
| Best Practices | L67-L128 | Best practices for Synapse performance, SQL/T-SQL patterns, Spark optimization, indexing/statistics, data loading, and migrating/modernizing from Netezza, Oracle, and Teradata. |
| Decision Making | L129-L149 | Guidance for choosing Synapse components, sizing and cost models, planning/assessing environments, and tools/steps to migrate or upgrade data warehouses to Synapse SQL. |
| Architecture & Design Patterns | L150-L169 | Architecture and design guidance for Synapse workspaces, SQL/serverless/Spark pools, data warehouse migrations, table/distribution/partition strategies, ELT/PolyBase loading, and workload management. |
| Limits & Quotas | L170-L178 | SQL and Synapse Link limits: memory/concurrency caps, dedicated pool capacity/quotas, serverless SQL constraints for Delta Lake v1, and feature/known issues for Synapse Link (Cosmos DB, SQL). |
| Security | L179-L239 | Securing Synapse workspaces end-to-end: auth and RBAC, network and private endpoints, firewall and data exfiltration, encryption/TDE, policies, managed identities, and secure data access/migration. |
| Configuration | L240-L288 | Configuring Synapse workspaces, Spark pools, and SQL pools: runtimes, scaling, libraries, monitoring/metrics, backups/restore, workload management, and integrations (Purview, AML). |
| Integrations & Coding Patterns | L289-L338 | Patterns and code to integrate Synapse (Spark, serverless, dedicated SQL) with storage, ML, monitoring, external tools, and other Azure services, plus querying external data formats. |
| Deployment | L339-L346 | Guides for deploying Synapse workspaces and dedicated SQL pools with CI/CD and ARM templates, plus operational readiness checks and configuring SQL pool maintenance windows. |
Troubleshooting
Best Practices
Decision Making
Architecture & Design Patterns
Limits & Quotas
| Topic | URL |
|---|---|
| Understand memory and concurrency limits in Synapse SQL pool | https://learn.microsoft.com/en-us/azure/synapse-analytics/sql-data-warehouse/memory-concurrency-limits |
| Dedicated SQL pool capacity limits and quotas | https://learn.microsoft.com/en-us/azure/synapse-analytics/sql-data-warehouse/sql-data-warehouse-service-capacity-limits |
| Query Delta Lake v1 with Synapse serverless SQL | https://learn.microsoft.com/en-us/azure/synapse-analytics/sql/query-delta-lake-format |
| Supported features and limitations of Synapse Link for Cosmos DB | https://learn.microsoft.com/en-us/azure/synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support |
| Limitations and known issues for Synapse Link for SQL | https://learn.microsoft.com/en-us/azure/synapse-analytics/synapse-link/synapse-link-for-sql-known-issues |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Implement CI/CD for Azure Synapse workspaces | https://learn.microsoft.com/en-us/azure/synapse-analytics/cicd/continuous-integration-delivery |
| Perform operational readiness review for Synapse deployment | https://learn.microsoft.com/en-us/azure/synapse-analytics/guidance/implementation-success-perform-operational-readiness-review |
| Deploy Synapse workspaces using ARM templates | https://learn.microsoft.com/en-us/azure/synapse-analytics/quickstart-deployment-template-workspaces |
| Plan and configure Synapse SQL pool maintenance windows | https://learn.microsoft.com/en-us/azure/synapse-analytics/sql-data-warehouse/maintenance-scheduling |
| Set up CI/CD for Synapse dedicated SQL pools | https://learn.microsoft.com/en-us/azure/synapse-analytics/sql-data-warehouse/sql-data-warehouse-continuous-integration-and-deployment |