真正的 PostgreSQL 18
您的数据及其类型、约束、触发器和函数都存在于 PostgreSQL 中。
数据库
适用于每个项目的真正的 PostgreSQL 18 数据库,可通过流畅的 SDK 从您的应用程序访问,受行级安全性保护并从您自己的架构键入。
import { createClient } from '@aurabase/aurabase-js'const aura = createClient('https://my-project.aurabase.cloud','aura_anon_xxx',)const { data, error } = await aura.db.from('posts').select('id,title,author:authors(*)').eq('published', true).order('created_at', 'desc').limit(10)
包含什么
您的数据及其类型、约束、触发器和函数都存在于 PostgreSQL 中。
相等、范围、模式、数组、范围类型和全文过滤器、排序、计数和分页。
使用像author:authors(*)这样的嵌入在一个请求中获取相关行。
将 PostgreSQL 函数公开给您的应用程序。设置返回函数像表格一样进行过滤。
使用 auth.uid() 在 SQL 中编写策略,以便每个用户只能访问自己的行。数据库强制执行它们,而不是客户端。
从您的模式生成数据库类型并获取类型化列、插入和函数参数。
pgvector 扩展随数据库图像一起提供,用于相似性搜索。
当您希望在项目的架构上使用 GraphQL API 时,请为项目启用 pg_graphql。
选择 MongoDB 作为项目的引擎。然后,隔离使用文档所有者而不是行级安全性。
它是如何运作的
使用 Studio 表编辑器或纯 SQL。
打开行级安全性并描述谁可以看到哪些行。
运行 aurabase-gen 为您的客户端获取数据库类型。
从您的应用程序中使用用户会话调用 aura.db.from(...)。
REST API
SDK 是这些路由之上的一个薄层。在每个请求中发送您项目的 API 密钥。
| 方法 | 端点 | 描述 |
|---|---|---|
| GET | /v1/db/{table} | 使用过滤器、排序和嵌入读取行。 |
| POST | /v1/db/{table} | 插入一行或多行,或更新插入。 |
| PATCH | /v1/db/{table} | 更新行。 |
| DELETE | /v1/db/{table} | 删除行。 |
| POST | /v1/db/rpc/{function} | 调用 PostgreSQL 函数。 |
| GET | /v1/db/schema | 列出项目的表和函数。 |
| GET | /v1/db/functions | 列出项目中定义的函数。 |
| POST | /v1/db/raw | 运行 SQL 语句。保留给服务角色。 |
问题
aura.db.sql() 或 Studio 中的 SQL 编辑器。它不适用于匿名或登录用户,因此请将其保留在服务器上。 npx aurabase-gen 写入 database.types.ts 文件,然后将其数据库类型传递给 createClient 。 limit() 和 offset() 。游标分页仅适用于 MongoDB 项目和本机引擎路径。