azure-database-postgresql
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Database for PostgreSQL Skill
Azure Database for PostgreSQL Skill
This skill provides expert guidance for Azure Database for PostgreSQL. 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.
本Skill为Azure Database for PostgreSQL提供专业指导,涵盖故障排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署等内容。它结合了本地快速参考内容与远程文档获取功能。
How to Use This Skill
如何使用本Skill
IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then usewith specific line ranges (e.g.,read_file) to read the sections needed for the user's questionL136-L144
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent注意事项:本文件可能较大,请使用下方的分类索引定位相关章节,然后使用工具并指定具体行范围(例如read_file)来读取用户问题所需的章节内容L136-L144
本Skill需要网络访问权限来获取文档内容:
- 优先方式:使用工具,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备选方式:使用工具,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L58 | Diagnosing and fixing Azure PostgreSQL issues: connectivity/TLS, HA and replicas, CPU/memory/IOPS, slow queries, autovacuum, extensions/CLI/storage, capacity, and migration validation errors. |
| Best Practices | L59-L76 | Performance, security, migration, and tooling best practices for Azure PostgreSQL: tuning queries, extensions, pooling, bulk load, stats, partitioning, pgvector, Oracle migration, and backups. |
| Decision Making | L77-L89 | Guidance on sizing, scaling, and hosting Azure PostgreSQL, planning geo-replication/DR, and making cost/support decisions like reserved capacity and version extended support. |
| Architecture & Design Patterns | L90-L100 | Patterns for using Azure PostgreSQL (often with OpenAI) to build recommendation/semantic search apps, microservices, multitenancy, real-time dashboards, and sharded/elastic data architectures. |
| Limits & Quotas | L101-L120 | Backup/restore behavior, geo-restore and recovery, storage types/limits/performance, quotas and capacity limits, replica and connection limits, and known migration/conversion constraints |
| Security | L121-L151 | Securing Azure Database for PostgreSQL: auth (Entra, SCRAM, TLS/SSL), firewall/VNet/Private Link, managed identities, encryption, auditing, roles, policies, and Defender for Cloud. |
| Configuration | L152-L241 | Configuring Azure Database for PostgreSQL: server parameters, extensions, HA, maintenance, logging/monitoring, performance tuning, networking, migration settings, and WAL/replication options. |
| Integrations & Coding Patterns | L242-L271 | Using Azure PostgreSQL with AI/ML (Azure AI, OpenAI, LangChain, Foundry), app SDKs (C#, Java, Python, Go, PHP), VS Code/Copilot, Storage, Data Factory, and migration tools (Ora2Pg, pg_dump). |
| Deployment | L272-L282 | CI/CD deployment to Azure PostgreSQL, major upgrades, Bicep-based provisioning, app deployments (Django/AKS, Web Apps + VNet), maintenance rollout behavior, and point-in-time restore. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排查 | L37-L58 | 诊断并修复Azure PostgreSQL问题:连接性/TLS、高可用与副本、CPU/内存/IOPS、慢查询、自动清理、扩展/CLI/存储、容量以及迁移验证错误。 |
| 最佳实践 | L59-L76 | Azure PostgreSQL的性能、安全、迁移与工具最佳实践:查询调优、扩展、连接池、批量加载、统计信息、分区、pgvector、Oracle迁移以及备份。 |
| 决策制定 | L77-L89 | Azure PostgreSQL的规格选型、扩容与托管方式指导,地理复制/灾难恢复规划,以及成本/支持决策(如预留容量、版本扩展支持)。 |
| 架构与设计模式 | L90-L100 | 使用Azure PostgreSQL(常结合OpenAI)构建推荐系统/语义搜索应用、微服务、多租户、实时仪表板以及分片/弹性数据架构的模式。 |
| 限制与配额 | L101-L120 | 备份/恢复行为、异地恢复、存储类型/限制/性能、配额与容量限制、副本与连接限制,以及已知的迁移/转换约束 |
| 安全 | L121-L151 | 保护Azure Database for PostgreSQL:身份验证(Entra、SCRAM、TLS/SSL)、防火墙/VNet/专用链接、托管标识、加密、审计、角色、策略以及Defender for Cloud。 |
| 配置 | L152-L241 | 配置Azure Database for PostgreSQL:服务器参数、扩展、高可用、维护、日志/监控、性能调优、网络、迁移设置以及WAL/复制选项。 |
| 集成与编码模式 | L242-L271 | 将Azure PostgreSQL与AI/ML(Azure AI、OpenAI、LangChain、Foundry)、应用SDK(C#、Java、Python、Go、PHP)、VS Code/Copilot、Storage、Data Factory以及迁移工具(Ora2Pg、pg_dump)结合使用。 |
| 部署 | L272-L282 | 向Azure PostgreSQL进行CI/CD部署、大版本升级、基于Bicep的资源部署、应用部署(Django/AKS、Web Apps + VNet)、维护发布行为以及时间点恢复。 |
Troubleshooting
故障排查
Best Practices
最佳实践
Decision Making
决策制定
Architecture & Design Patterns
架构与设计模式
| 主题 | 链接 |
|---|---|
| 使用Azure PostgreSQL与OpenAI构建推荐系统 | https://learn.microsoft.com/en-us/azure/postgresql/azure-ai/generative-ai-recommendation-system |
| 使用Azure PostgreSQL与OpenAI实现语义搜索 | https://learn.microsoft.com/en-us/azure/postgresql/azure-ai/generative-ai-semantic-search |
| 使用PostgreSQL弹性集群设计微服务数据架构 | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/tutorial-microservices |
| 使用Azure PostgreSQL弹性集群设计多租户应用 | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/tutorial-multitenant-database |
| 使用PostgreSQL弹性集群设计实时仪表板 | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/tutorial-real-time-dashboard |
| 为Azure PostgreSQL弹性集群选择分片模型 | https://learn.microsoft.com/en-us/azure/postgresql/elastic-clusters/concepts-elastic-clusters-sharding-models |
| 在Azure PostgreSQL弹性集群中选择表类型 | https://learn.microsoft.com/en-us/azure/postgresql/elastic-clusters/concepts-elastic-clusters-table-types |
Limits & Quotas
限制与配额
Security
安全
Configuration
配置
Integrations & Coding Patterns
集成与编码模式
Deployment
部署
| 主题 | 链接 |
|---|---|
| 通过Azure Pipelines将数据库更新部署到Azure PostgreSQL | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/azure-pipelines-deploy-database-task |
| 使用GitHub Actions将更改部署到Azure PostgreSQL | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/how-to-deploy-github-action |
| 在Azure PostgreSQL上执行原地大版本升级 | https://learn.microsoft.com/en-us/azure/postgresql/configure-maintain/how-to-perform-major-version-upgrade |
| 使用Bicep部署Azure PostgreSQL灵活服务器 | https://learn.microsoft.com/en-us/azure/postgresql/developer/create-server-bicep |
| 在AKS上部署Django并使用Azure PostgreSQL作为后端 | https://learn.microsoft.com/en-us/azure/postgresql/developer/django-aks-database |
| 在同一VNet中部署Azure Web App与PostgreSQL | https://learn.microsoft.com/en-us/azure/postgresql/developer/webapp-server-vnet |
| 了解PostgreSQL维护版本发布行为 | https://learn.microsoft.com/en-us/azure/postgresql/release-notes-maintenance/release-notes-maintenance-index |
| 将PostgreSQL灵活服务器恢复到指定时间点 | https://learn.microsoft.com/en-us/azure/postgresql/samples/sample-point-in-time-restore |