azure-horizondb

Azure Horizondb 技能

此技能为 Azure Horizondb 提供专业指导，涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式以及部署。它将本地快速参考内容与远程文档获取功能相结合。

如何使用此技能

重要提示（面向 Agent）：使用下方的类别索引查找相关部分。对于带有行号范围的类别（例如 L35-L120），使用 read_file 读取指定行。对于带有文件链接的类别（例如 [security.md](security.md)），使用 read_file 读取链接指向的参考文件

重要提示（面向 Agent）：如果 metadata.generated_at 的日期早于 3 个月以上，建议用户从存储库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，建议用户安装该工具：安装指南

此技能需要网络访问权限才能获取文档内容：

• 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并在查询字符串中添加 from=learn-agent-skill。返回 Markdown。
• 备用：使用 fetch_webpage，并在查询字符串中添加 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别	行号	说明
故障排除	L37-L44	诊断和解决 HorizonDB 问题：扩展管理错误、TLS/证书轮换故障、autovacuum 调优，以及防止事务 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 模型/管道、搜索/向量索引、扩展、网络/防火墙、高可用性/复制、autovacuum、连接、日志记录、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 中的 autovacuum	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 应用和 Agent 在 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
为 HorizonDB 集群启用删除保护	https://learn.microsoft.com/en-us/azure/horizondb/configure-maintain/how-to-enable-deletion-protection
管理 HorizonDB 的 SSL 配置参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-connections-authentication-ssl
在 Azure HorizonDB 中配置 TLS 安全参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-tls
在 Azure HorizonDB 中配置访问控制和角色	https://learn.microsoft.com/en-us/azure/horizondb/security/security-access-control
为 Azure HorizonDB 连接配置 SCRAM 身份验证	https://learn.microsoft.com/en-us/azure/horizondb/security/security-connect-scram
了解并配置 Azure HorizonDB 的静态数据加密	https://learn.microsoft.com/en-us/azure/horizondb/security/security-data-encryption
管理 Azure HorizonDB 中的数据库用户和账户	https://learn.microsoft.com/en-us/azure/horizondb/security/security-manage-database-users
应用 Azure HorizonDB 安全最佳实践	https://learn.microsoft.com/en-us/azure/horizondb/security/security-overview
在 Azure HorizonDB 中安全地重置管理员密码	https://learn.microsoft.com/en-us/azure/horizondb/security/security-reset-admin-password
HorizonDB 中的 TLS 要求和加密行为	https://learn.microsoft.com/en-us/azure/horizondb/security/security-tls
配置到 HorizonDB 的 TLS/SSL 客户端连接	https://learn.microsoft.com/en-us/azure/horizondb/security/security-tls-how-to-connect
更新 Azure HorizonDB Java 应用的 TLS 客户端证书	https://learn.microsoft.com/en-us/azure/horizondb/security/security-update-trusted-root-java

配置

主题	URL
在 HorizonDB 中配置 AI 模型管理（AIMM）	https://learn.microsoft.com/en-us/azure/horizondb/ai/ai-model-management
在 HorizonDB 中配置 pg_textsearch BM25 搜索	https://learn.microsoft.com/en-us/azure/horizondb/ai/full-text-search
在 Azure HorizonDB 中配置 DiskANN 向量索引	https://learn.microsoft.com/en-us/azure/horizondb/ai/vector-index-diskann
在 HorizonDB 中启用和配置 pgvector	https://learn.microsoft.com/en-us/azure/horizondb/ai/vector-search-pgvector
对 HorizonDB 群集使用时间点还原	https://learn.microsoft.com/en-us/azure/horizondb/backup-restore/how-to-restore-custom-restore-point
在 HorizonDB 中配置 pg_durable 工作流	https://learn.microsoft.com/en-us/azure/horizondb/development/durable-functions
按引擎版本列出的 HorizonDB PostgreSQL 扩展	https://learn.microsoft.com/en-us/azure/horizondb/extensions/concepts-extensions-by-engine
支持的 HorizonDB 扩展和模块目录	https://learn.microsoft.com/en-us/azure/horizondb/extensions/concepts-extensions-versions
允许并配置 HorizonDB 扩展	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-allow-extensions
在 HorizonDB 中配置 Azure Storage 扩展设置	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-configure-azure-storage-extension
在 Azure HorizonDB 群集中创建扩展	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-create-extensions
在 HorizonDB 群集中安全删除扩展	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-drop-extensions
在 HorizonDB 中配置 shared_preload_libraries	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-load-libraries
更新 Azure HorizonDB 实例中的扩展	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-update-extensions
列出 HorizonDB 中已安装的扩展及其版本	https://learn.microsoft.com/en-us/azure/horizondb/extensions/how-to-view-installed-extensions
在 HorizonDB 中启用和管理高可用性	https://learn.microsoft.com/en-us/azure/horizondb/high-availability/how-to-configure-high-availability
在 HorizonDB 中执行计划内和强制故障转移	https://learn.microsoft.com/en-us/azure/horizondb/high-availability/how-to-perform-failover
了解 HorizonDB 公共访问网络模型	https://learn.microsoft.com/en-us/azure/horizondb/network/concepts-network-public
配置 HorizonDB 群集的网络和连接	https://learn.microsoft.com/en-us/azure/horizondb/network/how-to-network
为 HorizonDB 添加公共访问防火墙规则	https://learn.microsoft.com/en-us/azure/horizondb/network/how-to-network-cluster-public-access-add-firewall
删除 HorizonDB 公共访问防火墙规则	https://learn.microsoft.com/en-us/azure/horizondb/network/how-to-network-cluster-public-access-delete-firewall
列出 HorizonDB 群集上的现有防火墙规则	https://learn.microsoft.com/en-us/azure/horizondb/network/how-to-network-cluster-public-access-list-firewall
更新 HorizonDB 防火墙规则 IP 范围和元数据	https://learn.microsoft.com/en-us/azure/horizondb/network/how-to-network-cluster-public-access-update-firewall
在 HorizonDB 中配置自适应 autovacuum 参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-adaptive-autovacuum
为 HorizonDB 群集调整 autovacuum 参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-autovacuum
在 HorizonDB 中配置其他客户端连接默认值	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-client-connection-defaults-defaults
在 HorizonDB 中设置客户端区域设置和格式默认值	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-client-connection-defaults-locale-formatting
在 HorizonDB 中管理共享库预加载参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-client-connection-defaults-shared-library-preload
为 HorizonDB 客户端调整语句行为默认值	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-client-connection-defaults-statement-behavior
配置 HorizonDB 的身份验证参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-connections-authentication-authentication
配置 HorizonDB 连接设置和 max_connections	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-connections-authentication-connection-settings
调整 HorizonDB 连接的 TCP 设置参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-connections-authentication-tcp-settings
使用 blob_block_size_mb 等自定义选项参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-customized-options
在 HorizonDB 中配置开发人员选项参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-developer-options
设置 HorizonDB 的错误处理参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-error-handling
配置 HorizonDB 存储的文件位置参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-file-locations
调整 HorizonDB 的智能优化参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-intelligent-tuning
管理 HorizonDB 中的锁管理参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-lock-management
配置 HorizonDB 的指标收集参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-metrics
为 HorizonDB 群集设置迁移相关参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-migration
为 Azure HorizonDB 配置 PgBouncer 参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-pgbouncer
调整 Azure HorizonDB 中的预设选项参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-preset-options
在 Azure HorizonDB 中管理进程标题参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-process-title
在 HorizonDB 中配置遗传查询优化器参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-query-tuning-genetic-query-optimizer
在 Azure HorizonDB 中配置规划器成本常量	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-query-tuning-planner-cost-constants
在 Azure HorizonDB 中控制规划器方法配置	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-query-tuning-planner-method-configuration
调整 HorizonDB 查询的规划器选项参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-query-tuning-planner-options
在 HorizonDB 中设置复制主服务器参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-replication-master-server
了解 HorizonDB 中主复制参数的可用性	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-replication-primary-server
为 HorizonDB 高可用性配置复制槽	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-replication-sending-servers
在 HorizonDB 中管理备用服务器复制参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-replication-standby-servers
在 Azure HorizonDB 中配置复制订阅服务器参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-replication-subscribers
使用 HorizonDB 参数控制日志记录内容	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-reporting-logging-what-log
在 HorizonDB 中配置日志记录频率和时间	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-reporting-logging-when-log
使用 HorizonDB 参数设置日志记录目标	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-reporting-logging-where-log
在 HorizonDB 中调整异步行为资源使用情况	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-asynchronous-behavior
在 HorizonDB 中配置后台写入器资源使用情况	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-background-writer
调整 HorizonDB 中基于成本的 vacuum 延迟参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-cost-based-vacuum-delay
管理 HorizonDB 中与磁盘相关的资源使用参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-disk
配置 HorizonDB 内核资源使用参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-kernel-resources
在 HorizonDB 中配置内存和大页使用情况	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-resource-usage-memory
在 HorizonDB 中配置累计查询和索引统计信息	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-statistics-cumulative-query-index-statistics
在 Azure HorizonDB 中配置监视统计信息参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-statistics-monitoring
了解 HorizonDB 中统计信息收集器参数的可用性	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-statistics-query-index-statistics-collector
在 HorizonDB 中配置平台和客户端兼容性参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-version-platform-compatibility-platforms-clients
管理与先前 PostgreSQL 版本的兼容性参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-version-platform-compatibility-postgresql-versions
配置 HorizonDB 归档恢复预写日志参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-archive-recovery
在 Azure HorizonDB 中设置 WAL 归档参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-archiving
在 HorizonDB 中配置 WAL 检查点大小参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-checkpoints
在 Azure HorizonDB 中管理 WAL 恢复参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-recovery
在 HorizonDB 中配置 WAL 恢复目标参数	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-recovery-target
为 Azure HorizonDB 调整 WAL 缓冲区设置	https://learn.microsoft.com/en-us/azure/horizondb/parameters/parameters-write-ahead-log-settings

集成与编码模式

主题	URL
将 AI 框架与 Azure HorizonDB 集成	https://learn.microsoft.com/en-us/azure/horizondb/ai/ai-frameworks
使用 azure_ai SQL 函数在 HorizonDB 中实现生成式 AI	https://learn.microsoft.com/en-us/azure/horizondb/ai/ai-functions
使用 HorizonDB AI 从文本构建知识图谱	https://learn.microsoft.com/en-us/azure/horizondb/ai/build-knowledge-graph
将 HorizonDB 用作 LangChain 向量存储	https://learn.microsoft.com/en-us/azure/horizondb/ai/develop-with-langchain
在 HorizonDB 中使用 create_embeddings() AI 函数	https://learn.microsoft.com/en-us/azure/horizondb/ai/generate-vector-embeddings
在 HorizonDB 中应用 azure_ai.rank() 语义重排序	https://learn.microsoft.com/en-us/azure/horizondb/ai/semantic-rank-function
使用 Azure Storage 扩展通过 HorizonDB 移动数据	https://learn.microsoft.com/en-us/azure/horizondb/extensions/concepts-storage-extension
运行 HorizonDB Azure Storage 扩展快速入门示例	https://learn.microsoft.com/en-us/azure/horizondb/extensions/quickstart-azure-storage-extension
在 HorizonDB 中使用 Azure Storage 扩展函数	https://learn.microsoft.com/en-us/azure/horizondb/extensions/reference-azure-storage-extension

部署

主题	URL
将 PostgreSQL 数据库转储并还原到 HorizonDB	https://learn.microsoft.com/en-us/azure/horizondb/migrate/how-to-migrate-dump-restore