SuperAPI AI 工具集

netlify-db

智能体与模型

查看项目

更新于 10-16 01:35

技能介绍

用途:Netlify DB 自动开通托管的 Neon Postgres 数据库,无需单独注册 Neon 账号。适合存储结构化、关系型数据,数据会随时间增长,或需要查询、过滤、连接、聚合的场景。若只是存文件(图片、文档、导出)或少量不增长的记录、简单键值存储,应改用 Netlify Blobs。

主要能力:提供原始 SQL 访问,@netlify/neon 封装 @neondatabase/serverless,无需连接字符串即可自动配置;支持在其上使用 Drizzle ORM 定义 schema、查询与迁移;支持部署预览分支,生产分支使用生产数据库,其他分支和部署预览使用独立的预览分支,便于先在预览环境测试迁移再合并到主分支应用到生产。

使用方式:先安装依赖并初始化,命令为 npm install @netlify/neon 和 netlify db init(会开通数据库并配置 Drizzle ORM)。前置条件是已登录 Netlify CLI 且站点已链接(netlify link)。原始 SQL 用法:import { neon } from "@netlify/neon"; const sql = neon(); 之后可执行 SELECT、INSERT、UPDATE、DELETE 等语句。Drizzle 集成需配置 drizzle.config.ts(dialect 为 postgresql,dbCredentials.url 取 process.env.NETLIFY_DATABASE_URL,schema 指向 ./db/schema.ts,out 为 ./migrations,migrations.prefix 为 timestamp 以避免跨分支冲突)和 db/index.ts(用 neon 与 drizzle-orm/neon-http 创建 db 实例)。迁移脚本示例:db:generate 用 drizzle-kit generate,db:migrate 用 netlify dev:exec drizzle-kit migrate,db:push 用 netlify dev:exec drizzle-kit push,db:studio 用 netlify dev:exec drizzle-kit studio;工作流为修改 schema、运行 db:generate、再运行 db:migrate。环境变量 NETLIFY_DATABASE_URL 由 Netlify 在开通数据库时自动设置,也可用 netlify env:get NETLIFY_DATABASE_URL 手动获取。本地开发运行 netlify dev 或使用 @netlify/vite-plugin 获得数据库访问,迁移命令用 netlify dev:exec 以带正确环境执行。

限制:资料未提供价格、配额、区域、性能指标等细节,暂未提供。