База данных
PostgreSQL 18, выделенная база данных для каждого проекта в кластере вашей организации, изолированные схемы, автоматически создаваемые типы TypeScript, собственный RLS. Никаких вилок и перезаписываемых прокси — ваши расширения, триггеры и PL/pgSQL работают как есть.
Postgres 18, без абстракции#
Служба aura-db предоставляет общий CRUD поверх PostgreSQL 18: каждый проект имеет собственную базу данных, размещенную в кластере 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()… в HTTP-запрос к aura-db, который делегирует дополнительную функцию PostgREST. 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_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- циттекст
- магазин
- lдерево
- без акцента
- 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) и хост формы <project-slug>.db.<your-domain> на порту 5432. Пароль выдается по запросу и отображается один раз: платформа не сохраняет его в открытом виде, поэтому утерянный пароль заменяется и никогда не восстанавливается.
# Хост, порт, база данных и роль связанного проекта (без пароля)
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 …. PostgREST узнает о новой таблице при запускеNOTIFY pgrst, 'reload schema'. Таблицы, созданные через это соединение до существования этого правила, закрываются при следующем вводе пароля (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.tcp.enabled за ingress-nginx или pgproxy.nodePort); Studio и aura db connection сообщат вам, когда это не так.
Чтобы пойти дальше#
- Безопасность на уровне строк
Собственные политики, тестирование, многопользовательские шаблоны.
- Конвенции
Именование схем, столбцов, политик, помощников RLS.
- Ветви базы данных
Копия проекта для каждого запроса на включение, удаленная по сроку жизни.
- Архитектура
Как aura-db вписывается в 8 сервисов.
- ОТДЫХ API
Необработанная поверхность HTTP для базы данных, аутентификации и хранилища.
- Supabase Миграция
pg_dump + RLS remap, 1 час для среднего проекта.