Netlify Database icon

Netlify Database

Netlify Database 是内置于 Netlify 的全托管 Postgres 数据库,专为全栈应用打造。支持隔离数据库分支和自动迁移,帮助团队在 deploy previews 和 agent runs 中安全测试改动。

Netlify Database

概述

Netlify Database 是内置于 Netlify 平台的全托管 Postgres 数据库。它旨在为 Netlify 项目提供集成的数据库原语,而无需单独配置或独立的数据库工作流。

该产品围绕生产部署、deploy previews 和 agent runs 的隔离数据库分支展开。这样的设置让团队可以在生产数据副本中测试模式和数据更改,然后通过常规部署生命周期推进更改,并自动应用迁移。

功能

Netlify 内置托管 Postgres

Netlify 会在平台内创建并管理 Postgres 数据库,替你处理供应和运维配置。

自动数据库分支

生产部署使用主数据库,而 deploy previews 和 agent runs 会获得带有生产数据副本的隔离分支。

平台管理的迁移

模式变更会记录在仓库迁移文件中,并在正确的部署阶段自动应用,以保持代码和数据库同步。

平台级访问

数据库可从 Functions、Edge Functions、Builds 和 Agent Runners 访问,因此应用代码可以在平台的多个部分读写关系数据。

适合 agents 的 CLI

CLI 以自动化为目标,提供结构化的 `--json` 输出和非交互式标志,便于编排数据库工作流。

基于额度的使用模型

数据库启用时,会按计算和带宽消耗额度;文档注明存储空间免费至 2026 年 7 月 1 日。

使用场景

  • 全栈应用后端

    将关系型应用数据存储在已经属于 Netlify 工作流的托管 Postgres 数据库中,这样你就无需为新应用额外接入独立数据库服务。

  • 更安全的模式变更

    在与生产数据相匹配的 deploy-preview 分支中测试模式更新和数据变更,然后在合并到生产前验证这些更改。

  • 由 agents 驱动的开发

    为 AI agents 提供隔离的数据库分支,使其可以在不影响线上数据或生产部署的情况下尝试查询和模式变更。

  • 平台集成的数据访问

    当应用需要跨多个 Netlify 运行时表面访问数据库时,可从 Functions、Edge Functions、Builds 和 Agent Runners 读写数据。

Pros and Cons

Pros

  • 托管 Postgres 内置于 Netlify 平台,减少了设置开销。
  • deploy previews 和 agent runs 默认获得隔离的数据库分支,有助于保护生产数据。
  • 迁移会在部署生命周期的正确阶段自动应用。
  • 数据库可用于 Functions、Edge Functions、Builds 和 Agent Runners。
  • CLI 提供结构化输出和非交互式标志,便于自动化。

Cons

  • 仅适用于基于额度的套餐。
  • 存储空间仅在 2026 年 7 月 1 日之前免费,因此根据所提供文档,长期成本并未完全固定。
  • 原生迁移系统虽可选,但如果使用自己的工具,你需要自行管理预览和生产迁移。

FAQ

使用 Netlify Database 需要什么套餐?

Netlify Database 仅适用于基于额度的套餐。文档说明,在启用时它会消耗用于计算和带宽的额度,而数据库存储空间在 2026 年 7 月 1 日之前免费。

如何处理模式迁移?

迁移文件存放在 `netlify/database/migrations` 中,并会在部署生命周期的正确阶段自动应用:在生产部署发布之前,以及在 deploy previews 可用之前。

在 deploy preview 中会发生什么?

deploy previews 会获得自己的数据库分支,该分支在预览首次创建时会从生产数据副本生成。该分支中的更改不会影响生产环境,且在需要时可以重置。

Netlify Database 是为 AI agents 设计的吗?

是的。文档说明每次 agent run 都会自动获得自己的数据库分支,而且 CLI 采用结构化 `--json` 输出和非交互式标志,便于程序化使用。

我可以使用自己的工具管理迁移吗?

Netlify 表示原生迁移系统是推荐方案,但并非强制。你可以使用自己的迁移工具,不过需要自行管理 deploy-preview 分支,并在平台钩子之外处理生产迁移。

Quick Facts

类别
开发者工具
产品类型
托管 Postgres 数据库
平台
Netlify
主要用户
在 Netlify 上构建全栈应用的开发者
来源域名
docs.netlify.com
工作流
带自动迁移的基于分支预览数据库