数据库
PostgreSQL 18,组织集群上每个项目的专用数据库、隔离模式、自动生成的 TypeScript 类型、本机 RLS。没有分叉,没有重写代理——您的扩展、触发器和 PL/pgSQL 按原样工作。
Postgres 18,无抽象#
aura-db 服务在 PostgreSQL 18 之上公开通用 CRUD:每个项目都有自己的数据库,托管在组织的 PostgreSQL 集群(完全专用于企业产品上的单个项目的集群)上。每个 SDK 调用都会通过一个薄层转换为本机 SQL,该薄层尊重注入到会话中的 RLS policies。
您还可以绕过 SDK 并将 psql、 Prisma、Drizzle、Kysely、Metabase 或 pg_dump 指向您的数据库:标准 PostgreSQL 有线协议、TLS,该角色只能访问您项目的数据库。请参阅下面的 直接连接。 (不发布 PostgreSQL 端口的部署在 Studio › 设置 › 连接:使用 SDK、REST API、SQL 编辑器或 CLI、aura db raw中如此说明。)
pg_dump 为您提供完整的数据库(架构、数据、扩展、策略)。没有锁定,简单的出境迁移。
SDK 调用 PostgREST,后者又调用 Postgres#
在底层,SDK 将您的 .from().select()… 调用序列化为对 aura-db 的 HTTP 请求,该请求委托给 PostgREST sidecar。 PostgREST 转换为 SQL,并通过 PgBouncer 与注入项目的 search_path 打开池连接。
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# 与 search_path 项目的连接
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
RLS 策略可以访问 auth.uid()、 auth.role()、 auth.tenant()。这些帮助程序读取网关注入的 request.jwt.claims - 客户端无法篡改。
六种原生能力#
- 每个项目的架构。 由 PostgreSQL应用的分区:没有tenant_id 列,每个项目一个连接角色,从未向 PUBLIC 开放权限。
- 版本化迁移。 版本化 SQL、原子回滚、零停机时间。 每次迁移时都会重新生成 TypeScript 类型。
- 代码生成 TypeScript 和 Rust。 从实时模式自动生成表、视图、枚举和 RPC 函数的类型。
- 本机 RLS。 可测试的声明性策略。 SDK 将声明租户注入到每个连接中。
- 列入允许列表的扩展程序。 创建项目时平台安装的 14 个扩展:
pgvector、pgcrypto、uuid-ossp、pg_trgm、pg_graphql、pg_stat_statements、citext、hstore、ltree、unaccent、btree_gin、btree_gist、fuzzystrmatch、intarray。 - 数据库分支。
aura branch create将项目(架构、策略、函数、触发器、视图和行)复制到具有自己的 URL 和密钥的新项目中,并在其生存时间后自动删除。在创建时制作的副本,而不是实时副本。
CRUD 完成,类型化#
四个基本操作共享相同的 .from(table)表面。返回的类型是从您的架构中推断出来的 - 打开您的 IDE,自动完成功能适用于列、连接和返回。
// 列出最近 50 个活动传感器
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
需要更复杂的 SQL?创建一个 Postgres 函数并通过 aura.rpc('function_name', args)调用它。函数受益于与表相同的 RLS 策略。
14 个列入许可名单的扩展程序已准备就绪#
14 个列入许可名单的扩展程序,可用于每个新项目
平台会在创建项目时安装它们(项目角色无法运行 CREATE EXTENSION 本身,因此无需忘记激活步骤)。列出随 aura db extensions list 或 Studio 安装的内容 › 数据库 › 扩展; aura db extensions enable <name> 和 POST /v1/db/{project_id}/schema/extensions 重新应用允许的一个。
- pgvector (
vector) - pg_graphql (当您 启用 GraphQL时安装)
- pg_stat_语句
- PG加密
- uuid ossp
- pg_trgm
- 西文本
- 商店
- 树
- 不带口音的
- btree_gin
- btree_gist
- 模糊匹配
- 内部数组
postgis、 pg_cron、 timescaledb、 pgmq和 pg_partman 未捆绑在标准托管映像中。对于计划的工作负载,请在 Cron中的 cron 计划上触发边缘函数。在平台运行下一次架构更新之前,在此更改之前创建的项目仅具有五个历史扩展(vector、 pgcrypto、 uuid-ossp、 pg_trgm、 pg_graphql);您不能自己添加其他的,因为只有数据库操作员才能安装它们。
直接连接:psql、Prisma、Drizzle、pg_dump#
每个项目都有自己的 PostgreSQL 登录角色 (proj_xxxxxxxx) 和端口 5432 上的 <project-slug>.db.<your-domain> 形式的主机。密码是 按需发出并显示一次:平台不会将其保持清晰,因此丢失的密码将被替换,永远不会恢复。
# 链接项目的主机、端口、数据库和角色(无密码)
aura db connection
# 发出密码并打印完整的连接字符串(撤销之前的密码)
aura db connection --new-password
# 打开psql就可以了(psql要求输入密码)
aura connect
aura db connection --new-password 打印一个可以粘贴到任何地方的字符串:
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
Studio 中存在同一张卡 › 设置 › 连接 › 数据库(生成密码/重置密码)。
- 需要 TLS。 端点拒绝明文连接 (
sslmode=require)。在本地 k3d 堆栈上,证书是自签名的 (*.db.localhost),因此sslmode=verify-full在设计上会失败;生产使用为*.db.<your-domain>颁发的证书。 - 仅限于您的项目。 路由器从角色名称中选择您的数据库并强制它:请求另一个数据库名称仍然落在您的数据库名称中,并且在另一个项目的主机上呈现您的角色被拒绝。您的角色不是超级用户,并且不会绕过 RLS;要以表所有者身份运行迁移,请使用
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;。 - 您在此处创建的表是平台私有的。对于通过此连接创建的表(需要 PostgreSQL 超级用户,托管项目永远不会公开),无法自动打开 行级安全性,因此公钥没有任何权限:REST API 将
permission denied应答给匿名密钥和登录用户,而service_role密钥、Studio 和您自己的角色读取和写入它。要将其公开给 SDK,请启用 RLS、授予,然后添加策略(请参阅 行级安全性):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …。 当您运行NOTIFY pgrst, 'reload schema'时,PostgREST 会了解新表。在此规则存在之前通过此连接创建的表将在您下次发出密码 (aura db connection --new-password) 时关闭,除非它们已启用 RLS 。 - 事务池。 连接在事务模式下经过 PgBouncer。会话状态不会从一个事务转移到下一个事务:在事务内使用
SET LOCAL,并期望命名准备好的语句、LISTEN和会话级咨询锁不可靠(Prisma:将pgbouncer=true添加到 URL)。 - 客户端版本。
pg_dump拒绝比其自身更新的服务器:使用 PostgreSQL 18 客户端 (pg_dump --version)。
直接访问取决于发布 PostgreSQL 端口的部署。它适用于本地 k3d 堆栈以及 Helm 值启用它的部署( ingress-nginx 后面的ingress.tcp.enabled 或 pgproxy.nodePort); Studio 和 aura db connection 会告诉您何时不是。