render-postgres

Render 托管 PostgreSQL

本技能介绍 Render 上的托管 Postgres：如何连接、创建后哪些内容无法更改、存储行为、限制、高可用性、副本和安全删除。深入内容请参阅 references/。

适用场景

在以下情况使用本技能：

• 为 Render 上的应用配置 Postgres（URL、TLS、连接池）
• 创建或更改 数据库、套餐、磁盘或副本
• 询问有关备份、PITR、导出或删除数据库的问题
• 遇到连接数限制、SSL 错误，或服务与数据库之间的延迟问题
• 编写 Blueprint databases / readReplicas，或配置 fromDatabase

关于部署流程和 Blueprint 基础知识，请参阅 render-deploy 和 render-blueprints。关于服务之间的私有网络，请参阅 render-networking。关于环境变量模式，请参阅 render-env-vars。

在配置或排查内部数据库连接之前，请阅读 references/private-networking.md。

连接模式

Render 为同一个逻辑数据库提供两个连接 URL：

URL	使用场景	TLS
内部	位于同一区域和工作区的 Render 应用或服务	不需要（私有网络）
外部	本地开发、CI 或 Render 之外的工具	必需（TLS 1.2+）

Render 托管的应用应始终优先使用内部 URL，这样流量会留在 Render 的网络中，并避免额外延迟和公网出站流量。

• IP 允许列表仅适用于外部访问。同一区域内的 Render 服务无论允许列表如何，都会使用内部 URL。
• 外部客户端必须使用 TLS；客户端配置错误时通常会出现 SSL 握手或 sslmode 错误。

有关 URL 格式、Dashboard 位置、Blueprint fromDatabase、连接池和常见错误，请参阅 references/connection-guide.md。

创建和设置

• 实例显示名称：之后可以更改（前提是 Dashboard 允许重命名该资源）。
• 创建后不可更改：databaseName、数据库用户、区域、PostgreSQL 主版本。请在创建前规划好；若要更改，必须创建新数据库并进行迁移。
• 存储大小：配置时可选 1 GB 或 5 GB 的倍数。

使用 Blueprint fromDatabase 为应用配置连接，可以指定 property: connectionString；启用托管 PgBouncer 时可指定 connectionPoolString；也可以分别指定 host、port、user、password 和 database。请参阅 render-blueprints。

多个逻辑数据库

你可以在同一实例的 psql 中运行 CREATE DATABASE new_db;。主机、端口和凭据保持不变；只有 URL 路径中的数据库名称会变化（例如，.../myapp 与 .../new_db）。

存储管理

• 自动扩容：磁盘使用量达到约 ~90% 时，Render 可以将存储容量增加约 ~50%，并向上取整至下一个 5 GB 的倍数，最高为 16 TB。
• 磁盘增加后无法缩小。
• 冷却期：存储容量增加后，12 小时内不能再次增加。
• 超过限额 / 状态不健康：如果磁盘超出配置限额，数据库可能会变为状态不健康；Render 可能会暂停该数据库，直至问题解决。

请监控磁盘用量，并在达到硬性限额前规划导出或清理。备份和恢复选项请参阅 references/backup-and-recovery.md。

连接限制

连接限制取决于数据库的计算计划。请使用 references/compute-plans.md 获取当前 Postgres 计划目录和连接限制，不要依赖记忆中的表格。

Render 为付费 Postgres 实例提供集成的 PgBouncer 连接池。在 Blueprint 中使用 connectionPool: pgbouncer 启用，然后使用数据库的 connectionPoolString 连接客户端。应用的连接池大小应与数据库连接限制保持一致；需要会话级状态或专用长连接的客户端必须使用直接连接字符串。启用托管连接池会重启数据库，导致数分钟不可用。更多详情请参阅：references/connection-guide.md 和 references/performance-tuning.md。

高可用性和计算计划

HA 资格和计划变更行为取决于 Postgres 计算计划和版本。建议计划或更改现有数据库前，请参阅 references/compute-plans.md。

只读副本

• 每个数据库最多 5 个只读副本。
• 在 Blueprint 中，在 readReplicas 下以名称列表的形式声明副本。
• CAUTION — 声明式同步：
  • 空的 readReplicas 列表可能会销毁所有现有副本。
  • Blueprint 与在线副本之间的名称不匹配可能会创建新副本，并移除名称不再列出的副本。

始终将 readReplicas 视为权威的期望状态，而非仅用于追加。

实用的 MCP 命令

使用 Render MCP 工具（工具名称可能因集成而略有不同；请与服务端的工具列表保持一致）：

目标	工具／模式
列出数据库	list_postgres_instances
实例详情	使用 postgresId 调用 get_postgres
只读 SQL	使用 postgresId 和 sql 调用 query_render_postgres
连接负载	使用 resourceId（Postgres ID）和 metricTypes: ["active_connections"] 调用 get_metrics

query_render_postgres 在只读事务中运行，并且每次查询都会打开新连接——不要用它代替应用连接池。

简写（相同工具）：list_postgres_instances()、get_postgres(postgresId)、query_render_postgres(postgresId, sql)、get_metrics(resourceId, metricTypes: ["active_connections"])。

删除与数据安全

• 删除数据库后，不会保留备份和快照。请先导出（pg_dump、通过 Dashboard 从现有备份恢复的工作流等）。
• 执行破坏性操作前，请在 references/backup-and-recovery.md 中确认保留策略和恢复路径。

参考资料

文档	内容
references/compute-plans.md	当前 Postgres 计划 ID、连接限制、停机时间、HA 和旧版计划迁移
references/private-networking.md	当前私有网络范围、内部寻址、隔离和故障排查
references/connection-guide.md	内部与外部 URL、SSL、允许列表、Blueprint 配置、连接池、多数据库 URL、故障排查
references/backup-and-recovery.md	快照、PITR、pg_dump / pg_restore、恢复流程、删除、跨区域
references/performance-tuning.md	pg_stat_statements、索引、膨胀、EXPLAIN ANALYZE、指标、扩缩容

相关技能

• render-deploy — 端到端部署、服务和 MCP／Dashboard 流程
• render-blueprints — databases、fromDatabase、readReplicas、不可变字段
• render-networking — 私有服务、区域，以及资源之间的流量路由方式
• render-env-vars — 存储 DATABASE_URL 和密钥配置模式

当前文档检索

每当此技能指示你查阅 Render 的当前文档时：

1. 使用可用的 URL 获取工具或 HTTP 客户端（例如 curl）直接获取链接的 Markdown 文档。不要用网页搜索摘要代替文档。
2. 确认获取成功且返回的是预期文档，然后阅读其内容。仅保存文件或输出其路径并不足够。
3. 如果请求失败，或你的工具无法读取 Markdown 响应，则打开并阅读链接的 HTML 版本。
4. 如果两个版本都无法获取，请说明当前参考资料不可用，并遵循技能中针对该主题的备用方案。仅将随附指南用于稳定的限制条件，不要猜测可能变动的平台详情。

如果任务需要多个参考资料，请对每份资料都执行此流程，并区分已验证的文档与仍不可用的文档。