НОВЫЙ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 с его типами, ограничениями, триггерами и функциями.

Конструктор запросов

Свободные типизированные запросы

Фильтры равенства, диапазона, шаблона, массива, типа диапазона и полнотекстовые фильтры, упорядочивание, подсчет и нумерация страниц.

Отношения

Встраивает

Получите связанные строки одним запросом с помощью встраивания типа автора:авторы(*).

Функции

Вызов функций с помощью rpc()

Предоставьте функции PostgreSQL своему приложению. Функции, возвращающие множество, фильтруют как таблицы.

Безопасность

Безопасность на уровне строк

Напишите политики в SQL с помощью auth.uid(), чтобы каждый пользователь получал доступ только к своим строкам. База данных обеспечивает их соблюдение, а не клиент.

Типы

Созданные типы TypeScript

Создайте тип базы данных из своей схемы и получите типизированные столбцы, вставки и аргументы функции.

ИИ

Векторы с pgvector

Расширение pgvector поставляется с изображением базы данных для поиска по сходству.

Подписаться

GraphQL для каждого проекта

Включите pg_graphql для проекта, если вам нужен API 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?+
Да. В проектах используется PostgreSQL 18 с расширением pgvector, поэтому ваш SQL, ограничения, триггеры и функции работают так, как написано.
Как защитить пользователей от доступа к данным друг друга?+
Включите безопасность на уровне строк в таблице и напишите политику, которая сравнивает столбец с помощью auth.uid(). База данных применяет его к каждому запросу, сделанному с использованием токена пользователя.
Могу ли я запустить необработанный SQL?+
Да, с ролью службы, через aura.db.sql() или редактор SQL в Studio. Он недоступен анонимным или вошедшим в систему пользователям, поэтому сохраните его на сервере.
Получаю ли я типы TypeScript для своих таблиц?+
Да. Запустите npx aurabase-gen , чтобы записать файл data.types.ts , затем передайте его тип базы данных в createClient .
Как разбить результаты на страницы?+
Используйте limit() и offset() . Разбиение на страницы курсора доступно только в проектах MongoDB и на собственном пути движка.
Что изменится в MongoDB?+
Безопасность на уровне строк отсутствует. Чтения вошедших пользователей фильтруются по документам, которыми они владеют, а документы, созданные с помощью роли службы, не имеют владельца, поэтому пользователи не могут их видеть.

Готовы хранить данные?

Ваша база данных находится на расстоянии одного проекта.

База данных включена в каждый проект. Кредитная карта не требуется.