新Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2查看变更日志 →

数据库

PostgreSQL,只需敲一行字。

适用于每个项目的真正的 PostgreSQL 18 数据库,可通过流畅的 SDK 从您的应用程序访问,受行级安全性保护并从您自己的架构键入。

16
PostgreSQL 版本
2
引擎:PostgreSQL、MongoDB
db.tsTS
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)

包含什么

您的应用程序可以与之通信的数据库。 无需编写API。

发动机

真正的 PostgreSQL 18

您的数据及其类型、约束、触发器和函数都存在于 PostgreSQL 中。

查询生成器

流利的键入查询

相等、范围、模式、数组、范围类型和全文过滤器、排序、计数和分页。

关系

嵌入

使用像author:authors(*)这样的嵌入在一个请求中获取相关行。

功能

使用 rpc() 调用函数

将 PostgreSQL 函数公开给您的应用程序。设置返回函数像表格一样进行过滤。

安全性

行级安全性

使用 auth.uid() 在 SQL 中编写策略,以便每个用户只能访问自己的行。数据库强制执行它们,而不是客户端。

类型

生成的 TypeScript 类型

从您的模式生成数据库类型并获取类型化列、插入和函数参数。

人工智能

带有 pgvector 的向量

pgvector 扩展随数据库图像一起提供,用于相似性搜索。

选择加入

每个项目的 GraphQL

当您希望在项目的架构上使用 GraphQL API 时,请为项目启用 pg_graphql。

替代发动机

MongoDB,如果您喜欢文档

选择 MongoDB 作为项目的引擎。然后,隔离使用文档所有者而不是行级安全性。

它是如何运作的

从表到类型化查询。

  1. 1

    创建一个表

    使用 Studio 表编辑器或纯 SQL。

  2. 2

    添加政策

    打开行级安全性并描述谁可以看到哪些行。

  3. 3

    生成类型

    运行 aurabase-gen 为您的客户端获取数据库类型。

  4. 4

    查询

    从您的应用程序中使用用户会话调用 aura.db.from(...)。

REST API

更喜欢纯 HTTP? 一切都在这里。

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 语句。保留给服务角色。

问题

很高兴知道。

这是真正的 PostgreSQL 吗?+
是的。项目运行带有 pgvector 扩展的 PostgreSQL 18,因此您的 SQL、约束、触发器和函数按编写的方式工作。
如何让用户远离彼此的数据?+
在表上启用行级安全性并编写将列与 auth.uid() 进行比较的策略。数据库将其应用于使用用户令牌发出的每个请求。
我可以运行原始 SQL 吗?+
是的,使用服务角色,通过 aura.db.sql() 或 Studio 中的 SQL 编辑器。它不适用于匿名或登录用户,因此请将其保留在服务器上。
我可以获得表的 TypeScript 类型吗?+
是的。运行 npx aurabase-gen 写入 database.types.ts 文件,然后将其数据库类型传递给 createClient 。
如何对结果进行分页?+
使用 limit() 和 offset() 。游标分页仅适用于 MongoDB 项目和本机引擎路径。
MongoDB 有什么变化?+
没有行级安全性。登录用户的读取会被过滤到他们拥有的文档,并且使用服务角色创建的文档没有所有者,因此用户无法看到它们。

准备好存储数据了吗?

您的数据库仅差一个项目。

每个项目都包含一个数据库。无需信用卡。