azure-horizondb について
Azure HorizonDB ユーザー向けに、運用、アーキテクチャ、セキュリティ、設定、デプロイを扱うガイダンススキルです。PostgreSQL のチューニング、AI 検索、連携、移行などの参照資料を索引からたどれます。
主な機能
- 01トラブルシューティングと保守の案内
- 02ベクトル・全文・ハイブリッド検索の選択
- 03セキュリティとアクセス制御の設定
- 04クラスターと PostgreSQL パラメーターの調整
- 05AI、グラフ、ストレージとの連携
- 06PostgreSQL 移行の案内
活用シーン
- 01TLS や拡張機能のエラー診断
- 02検索方式とベクトルインデックスの選択
- 03データベースアクセスと暗号化の保護
- 04クラスターの調整と PostgreSQL データの移行
MCP 対応
mcp_microsoftdocs の microsoft_docs_fetch によるドキュメント取得を推奨し、代替手段として fetch_webpage を案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-horizondbインストール後、Claude Code で/azure-horizondbを入力して読み込まれたか確認します。
詳細
Azure Horizondb スキル
このスキルでは、Azure Horizondb に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて扱います。ローカルのクイックリファレンスコンテンツと、リモートからドキュメントを取得する機能を組み合わせています。
このスキルの使い方
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-L44 | HorizonDB の問題を診断して解決します。拡張機能の管理エラー、TLS/証明書のローテーション失敗、自動バキュームの調整、トランザクション ID のラップアラウンド防止などを扱います。 |
| ベストプラクティス | L45-L55 | HorizonDB のパフォーマンスと運用に関するガイダンスです。AI 向けのデータ準備、pgvector の調整、パーティション分割、拡張機能、Apache AGE、Query Store、クラスターのメンテナンスに関するベストプラクティスを扱います。 |
| 意思決定 | L56-L61 | HorizonDB でベクトル検索、全文検索、ハイブリッド検索のいずれを選ぶか、またデータ、クエリ、パフォーマンスのニーズに最適なベクトルインデックスの種類を選ぶためのガイダンスです。 |
| アーキテクチャと設計パターン | L62-L66 | HorizonDB でグラフデータを使った RAG を構築するパターンや、ハイブリッド BM25+ベクトル検索を実装するパターンを、設計上の選択肢やクエリ戦略も含めて紹介します。 |
| 制限とクォータ | L67-L72 | HorizonDB のレプリカ数や読み取りスケールの制限を管理する方法と、HorizonDB リソースのクォータまたは制限の引き上げを申請する方法を説明します。 |
| セキュリティ | L73-L88 | HorizonDB のセキュリティ保護について説明します。TLS/SSL のセットアップ、証明書の管理、SCRAM 認証、アクセス制御/ロール、ユーザーアカウント、保存データの暗号化、削除保護、パスワードのリセット、セキュリティのベストプラクティスを扱います。 |
| 構成 | L89-L164 | HorizonDB クラスターの構成方法を説明します。AI モデル/パイプライン、検索/ベクトルインデックス、拡張機能、ネットワーク/ファイアウォール、高可用性/レプリケーション、自動バキューム、接続、ログ、WAL、PostgreSQL パラメーターの詳細な調整を扱います。 |
| 統合とコーディングパターン | L165-L177 | HorizonDB を AI とともに使用する方法を説明します。azure_ai の SQL/埋め込み/再ランキング関数、LangChain ベクトルストア、ナレッジグラフの構築、Azure Storage 拡張機能を使ったデータの統合/移動を扱います。 |
| デプロイ | L178-L181 | PostgreSQL データベースをダンプして HorizonDB に復元し、データを移行するためのガイドです。必要なツール、コマンド、互換性に関する考慮事項を含みます。 |
トラブルシューティング
| トピック | URL |
|---|---|
| HorizonDB の拡張機能管理でよくあるエラーを解決する | https://learn.microsoft.com/en-us/azure/horizondb/extensions/errors-extensions |
| HorizonDB の証明書ローテーション後に発生する TLS 接続エラーのトラブルシューティング | https://learn.microsoft.com/en-us/azure/horizondb/security/security-tls-troubleshoot |
| Azure HorizonDB で自動バキュームを監視および調整する | https://learn.microsoft.com/en-us/azure/horizondb/troubleshoot/how-to-autovacuum-monitor-tune |
| HorizonDB でトランザクション ID のラップアラウンドを防止および解決する | https://learn.microsoft.com/en-us/azure/horizondb/troubleshoot/how-to-prevent-resolve-wraparound |
ベストプラクティス
| トピック | URL |
|---|---|
| AI アプリとエージェント向けに HorizonDB でデータを準備する | https://learn.microsoft.com/en-us/azure/horizondb/ai/ai-data-preparation |
| HorizonDB で pgvector のパフォーマンスを最適化する | https://learn.microsoft.com/en-us/azure/horizondb/ai/optimize-pgvector-performance |
| HorizonDB クラスターの定期メンテナンスを計画および管理する | https://learn.microsoft.com/en-us/azure/horizondb/configure-maintain/concepts-maintenance |
| pg_partman パーティショニングで HorizonDB を最適化する | https://learn.microsoft.com/en-us/azure/horizondb/configure-maintain/how-to-use-pg-partman |
| 拡張機能を使用する際に HorizonDB 固有の考慮事項を適用する | https://learn.microsoft.com/en-us/azure/horizondb/extensions/concepts-extensions-considerations |
| Apache AGE のパフォーマンスに関するベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/horizondb/graph/age-performance |
| HorizonDB で Query Store のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/horizondb/monitor/concepts-query-store-best-practices |
意思決定
| トピック | URL |
|---|---|
| ベクトル検索、全文検索、ハイブリッド検索から選択する | https://learn.microsoft.com/en-us/azure/horizondb/ai/ai-search-overview |
| 適切な HorizonDB ベクトルインデックスを選択する | https://learn.microsoft.com/en-us/azure/horizondb/ai/vector-index-selection-guide |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| HorizonDB でグラフ拡張 RAG を設計する | https://learn.microsoft.com/en-us/azure/horizondb/ai/graph-rag |
制限とクォータ
| トピック | URL |
|---|---|
| HorizonDB レプリカと読み取りスケールの制限を管理する | https://learn.microsoft.com/en-us/azure/horizondb/configure-maintain/how-to-add-remove-replica |
| HorizonDB リソースのクォータと制限の引き上げを申請する | https://learn.microsoft.com/en-us/azure/horizondb/configure-maintain/how-to-request-quota-increase |
セキュリティ
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| PostgreSQL データベースを HorizonDB にダンプして復元する | https://learn.microsoft.com/en-us/azure/horizondb/migrate/how-to-migrate-dump-restore |