azure-data-api-builder
Azure Data API Builderの開発全般をサポートし、SQLやCosmos DBをREST/GraphQLで公開する際のトラブルシューティング、ベストプラクティス、セキュリティ設定、デプロイなどに関する専門知識を提供するSkillです。
📜 元の英語説明(参考)
Expert knowledge for Azure Data Api Builder development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when exposing SQL/Cosmos via REST/GraphQL, tuning pagination/filters, securing JWT/Entra auth, or deploying DAB to Azure, and other Azure Data Api Builder related development tasks. Not for Azure API Management (use azure-api-management), Azure Functions (use azure-functions), Azure App Service (use azure-app-service), Azure Logic Apps (use azure-logic-apps).
🇯🇵 日本人クリエイター向け解説
Azure Data API Builderの開発全般をサポートし、SQLやCosmos DBをREST/GraphQLで公開する際のトラブルシューティング、ベストプラクティス、セキュリティ設定、デプロイなどに関する専門知識を提供するSkillです。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-data-api-builder.zip https://jpskill.com/download/5667.zip && unzip -o azure-data-api-builder.zip && rm azure-data-api-builder.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5667.zip -OutFile "$d\azure-data-api-builder.zip"; Expand-Archive "$d\azure-data-api-builder.zip" -DestinationPath $d -Force; ri "$d\azure-data-api-builder.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
azure-data-api-builder.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
azure-data-api-builderフォルダができる - 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 Data Api Builder スキル
このスキルは、Azure Data Api Builder に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイメントをカバーしています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使い方
エージェントへの重要事項: 以下のカテゴリインデックスを使用して、関連するセクションを見つけてください。行範囲が指定されているカテゴリ（例:
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 を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L36-L47 | DAB の問題の診断と修正: 構成/CLI エラー、SQL/Cosmos/MySQL/Postgres の接続またはクエリの問題、GraphQL スキーマ/認証、REST ルーティング、CORS/エンドポイントの障害。 |
| ベストプラクティス | L48-L54 | 信頼性とパフォーマンスのための Data API builder の構成、エンドポイントと認証の保護、より良い AI 統合のための SQL MCP エンティティへのセマンティックな説明/メタデータの追加。 |
| 意思決定 | L55-L59 | Data API builder をどこにどのようにデプロイするかについてのガイダンス、およびサポートされているデータベース間での機能ごとの比較と制限。 |
| 制限とクォータ | L60-L67 | SQL タイムアウトの構成、REST/GraphQL ページネーション制限の設定、および Data API builder におけるデータベース固有の機能と制約の理解。 |
| セキュリティ | L68-L81 | DAB の認証とセキュリティの構成: JWT/Entra/EasyAuth/Simulator/匿名、OBO SQL アクセス、行レベルセキュリティとポリシー、および SQL MCP Server 認証。 |
| 構成 | L82-L127 | Data API builder の構成: CLI ベースの構成、エンティティと自動エンティティ、データソース (SQL/Cosmos)、REST/GraphQL 公開、キャッシュ、セキュリティ/シークレット、ログ/テレメトリ、および MCP SQL ツール。 |
| 統合とコーディングパターン | L128-L141 | DAB における GraphQL/REST の使用パターン: スキーマのエクスポート、トランザクションミューテーション、ページネーション、フィルタリング、ソート、および API レスポンスのためのフィールドの整形/プロジェクション。 |
| デプロイメント | L142-L148 | Data API builder と SQL MCP Server のデプロイ: Azure オプションの比較、Docker またはソースビルドによる実行、および Azure Container Apps へのコンテナのデプロイ。 |
トラブルシューティング
| トピック | URL |
|---|---|
| DAB 構成の検証と CLI 終了コードの解釈 | https://learn.microsoft.com/en-us/azure/data-api-builder/command-line/dab-validate |
| Data API builder での Azure Cosmos DB の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/cosmos |
| DAB での GraphQL スキーマと認証のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/graphql |
| DAB での SQL MCP Server の問題の診断と修正 | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/mcp |
| Data API builder での SQL Server の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/mssql |
| Data API builder での MySQL の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/mysql |
| Data API builder での PostgreSQL の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/postgresql |
| DAB での REST エンドポイントと CORS の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/data-api-builder/troubleshooting/rest |
ベストプラクティス
| トピック | URL |
|---|---|
| Data API builder で構成のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/config/best-practices |
| Data API builder のセキュリティのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/security/best-practices |
| SQL MCP Server エンティティにセマンティックな説明を追加する | https://learn.microsoft.com/en-us/azure/data-api-builder/mcp/how-to-add-descriptions |
意思決定
| トピック | URL |
|---|---|
| データベースごとの Data API builder の機能の可用性を比較する | https://learn.microsoft.com/en-us/azure/data-api-builder/feature-availability |
制限とクォータ
| トピック | URL |
|---|---|
| Data API builder の SQL コマンドタイムアウトを構成する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/database/timeout |
DAB で first を使用して GraphQL ページサイズを制限する |
https://learn.microsoft.com/en-us/azure/data-api-builder/keywords/first-graphql |
DAB で $first を使用して REST ページサイズを制御する |
https://learn.microsoft.com/en-us/azure/data-api-builder/keywords/first-rest |
| Data API builder のデータベース固有の機能要件 | https://learn.microsoft.com/en-us/azure/data-api-builder/reference-database-specific-features |
セキュリティ
| トピック | URL |
|---|---|
| Data API builder で認証モデルを選択して構成する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/security/ |
| Data API builder のカスタム JWT プロバイダーを構成する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/security/authenticate-custom |
| Data API builder で Azure App Service EasyAuth を構成する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/security/authenticate-easy-auth |
| Data API builder の Microsoft Entra ID 認証を構成する | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/secu |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure Data Api Builder Skill
This skill provides expert guidance for Azure Data Api Builder. Covers troubleshooting, best practices, decision making, 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 | L36-L47 | Diagnosing and fixing DAB issues: config/CLI errors, SQL/Cosmos/MySQL/Postgres connection or query problems, GraphQL schema/auth, REST routing, and CORS/endpoint failures. |
| Best Practices | L48-L54 | Configuring Data API builder for reliability and performance, securing endpoints and auth, and adding semantic descriptions/metadata to SQL MCP entities for better AI integration. |
| Decision Making | L55-L59 | Guidance on where and how to deploy Data API builder, plus feature-by-feature comparisons and limitations across supported databases. |
| Limits & Quotas | L60-L67 | Configuring SQL timeouts, setting REST/GraphQL pagination limits, and understanding database-specific capabilities and constraints in Data API builder. |
| Security | L68-L81 | Configuring auth and security for DAB: JWT/Entra/EasyAuth/Simulator/anonymous, OBO SQL access, row-level security and policies, and SQL MCP Server authentication. |
| Configuration | L82-L127 | Configuring Data API builder: CLI-based config, entities and autoentities, data sources (SQL/Cosmos), REST/GraphQL exposure, caching, security/secrets, logging/telemetry, and MCP SQL tools. |
| Integrations & Coding Patterns | L128-L141 | GraphQL/REST usage patterns in DAB: exporting schemas, transactional mutations, pagination, filtering, sorting, and shaping/projecting fields for API responses. |
| Deployment | L142-L148 | Deploying Data API builder and SQL MCP Server: compare Azure options, run via Docker or source builds, and deploy containers to Azure Container Apps. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Apply configuration best practices in Data API builder | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/config/best-practices |
| Apply security best practices for Data API builder | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/security/best-practices |
| Add semantic descriptions to SQL MCP Server entities | https://learn.microsoft.com/en-us/azure/data-api-builder/mcp/how-to-add-descriptions |
Decision Making
| Topic | URL |
|---|---|
| Compare Data API builder feature availability by database | https://learn.microsoft.com/en-us/azure/data-api-builder/feature-availability |
Limits & Quotas
| Topic | URL |
|---|---|
| Configure SQL command timeouts for Data API builder | https://learn.microsoft.com/en-us/azure/data-api-builder/concept/database/timeout |
| Limit GraphQL page size with first in DAB | https://learn.microsoft.com/en-us/azure/data-api-builder/keywords/first-graphql |
| Control REST page size with $first in DAB | https://learn.microsoft.com/en-us/azure/data-api-builder/keywords/first-rest |
| Database-specific feature requirements for Data API builder | https://learn.microsoft.com/en-us/azure/data-api-builder/reference-database-specific-features |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Compare Data API builder deployment options in Azure | https://learn.microsoft.com/en-us/azure/data-api-builder/deployment/ |
| Run Data API builder in a Docker container | https://learn.microsoft.com/en-us/azure/data-api-builder/deployment/local-container |
| Build and run Data API builder from source | https://learn.microsoft.com/en-us/azure/data-api-builder/deployment/run-from-source |
| Deploy SQL MCP Server to Azure Container Apps | https://learn.microsoft.com/en-us/azure/data-api-builder/mcp/quickstart-azure-container-apps |