azure-database-mysql について
Azure Database for MySQL の計画や運用を支援するエージェント向けガイダンススキルです。ローカルのクイックリファレンスとネットワーク経由のドキュメント取得を組み合わせ、障害対応からセキュリティ、構成、デプロイまで扱います。
主な機能
- 01障害対応と運用ガイダンス
- 02アーキテクチャとサービス階層の選定
- 03セキュリティと構成のリファレンス
- 04移行とデプロイのガイダンス
- 05ローカル資料とリモート文書取得
活用シーン
- 01接続やクエリ性能の問題を調査
- 02MySQL の Azure 移行を計画
- 03セキュリティと高可用性の選択肢を確認
MCP 対応
Microsoft ドキュメントの取得には `mcp_microsoftdocs:microsoft_docs_fetch` ツールを推奨しています。代替手段として `fetch_webpage` も記載されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-database-mysqlインストール後、Claude Code で/azure-database-mysqlを入力して読み込まれたか確認します。
詳細
Azure Database for MySQL スキル
このスキルでは、Azure Database for MySQL に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使い方
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-L53 | MySQL Flexible Server の問題を診断して解決する方法:接続エラーや CLI エラー、パフォーマンス(CPU/メモリ/クエリ)、容量、破損、レプリケーションの遅延、ログやセルフヒールツールの使用。 |
| ベストプラクティス | L54-L73 | Azure Database for MySQL の監視、パフォーマンスチューニング、メンテナンス、レプリカ、BCDR、トラブルシューティング、安全な再起動、移行および移行後の最適化に関するベストプラクティス。 |
| 意思決定 | L74-L90 | Azure で MySQL を計画するためのガイダンス:バージョンポリシー、HA/DR と事業継続性、サイズとサービスレベル、パフォーマンスのベースライン、Flexible Server の選択/移行/アップグレード。 |
| アーキテクチャと設計パターン | L91-L97 | AKS と MySQL Flexible Server の接続、バックアップ/復元の設計、データのイン/アウトレプリケーション、高可用性(ゾーン冗長)、読み取りレプリカを利用したスケーリングのパターン。 |
| 制限とクォータ | L98-L106 | MySQL Flexible Server の制限、クォータ、パフォーマンス上限:最大接続数/コア数/IOPS、ストレージ IOPS の動作、クォータ引き上げの申請、再起動/停止の上限、削除/復元にかかる時間の上限。 |
| セキュリティ | L107-L132 | Azure MySQL のネットワーク、認証、暗号化のセキュリティ:プライベート/パブリックアクセス、ファイアウォール、TLS、証明書のローテーション、監査ログ、CMK/保存データの暗号化、Entra 認証、安全なユーザー/移行のセットアップ。 |
| 構成 | L133-L163 | Azure Database for MySQL Flexible Server の構成:パラメーター、HA、ネットワーク、ログ、監視、アラート、メンテナンスウィンドウ、レプリケーション、スケーリング、バックアップ、読み取りレプリカ。 |
| 統合とコーディングパターン | L164-L175 | MySQL Flexible Server へのアプリとツールの接続(CLI、JDBC、Power BI)、接続文字列の管理、各種ツールを使用した RDS、オンプレミス/VM、または大規模データベースからの MySQL データの移行。 |
| デプロイ | L176-L184 | Azure Pipelines、GitHub Actions、Automation を使用した MySQL Flexible Server のデプロイと変更の自動化、バックアップ、geo-restore、バージョンアップグレード、定期メンテナンスへの対応。 |
トラブルシューティング
ベストプラクティス
意思決定
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure Kubernetes Service を MySQL Flexible Server に接続する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/concepts-aks |
| MySQL Flexible Server へのデータインレプリケーションを設計する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/concepts-data-in-replication |
| MySQL Flexible Server からのデータアウトレプリケーションを設計する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/concepts-data-out-replication |
制限とクォータ
| トピック | URL |
|---|---|
| Azure MySQL Flexible Server のサービス制限 | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/concepts-limitations |
| MySQL Flexible Server のストレージ IOPS のパフォーマンス特性 | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/concepts-storage-iops |
| Azure MySQL Flexible Server のクォータ増加を要求する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/how-to-request-quota-increase |
| 保持期間の制限内で削除された Azure MySQL フレキシブルサーバーを復元する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/how-to-restore-dropped-server |
| 停止期間の制限に従って MySQL フレキシブルサーバーを再起動、停止、起動する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/scripts/sample-cli-restart-stop-start |
セキュリティ
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| Azure MySQL のデプロイ用に Azure Pipelines タスクを構成する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/azure-pipelines-deploy-database-task |
| MySQL Flexible Server の管理用に Azure Automation タスクを作成する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/create-automation-tasks |
| geo-restore を使用して Azure MySQL Flexible Server をリージョン間で移動する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/how-to-move-regions |
| CLI を使用してバックアップから Azure MySQL Flexible Server を復元する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/how-to-restore-server-cli |
| ポータルからバックアップを使用して Azure MySQL Flexible Server を復元する | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/how-to-restore-server-portal |
| GitHub Actions を使用して Azure MySQL に変更をデプロイする | https://learn.microsoft.com/en-us/azure/mysql/flexible-server/quickstart-mysql-github-actions |