НОВЫЙPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Посмотреть список изменений →

Инженерное дело · 9 минута чтения

Совместимость PostgREST: что она охватывает и альтернативы

Affane Daylami · Fondateur · 3 августа 2026 г.

Вернуться в блог

PostgREST преобразует схему PostgreSQL в REST API без необходимости записи серверной части. Это четкий ответ на конкретную потребность, а не полноценный бэкэнд. Путаница между этими двумя понятиями объясняет большую часть разочарований, которые мы читаем в онлайн-отзывах.

Эта страница была переведена автоматически. Английская версия является авторитетной.

В этой статье подробно описывается, что на самом деле покрывает PostgREST, что он оставляет на ваше усмотрение, и сравниваются серьезные альтернативы — вплоть до того, что на самом деле охватывает Aurabase, проверенное в его коде, а не предполагаемое.

Самое необходимое

  • PostgREST генерирует REST API из схемы Postgres: фильтры, внедрение отношений, вызовы RPC, RLS, управляемый JWT, спецификация OpenAPI — без строки внутреннего кода.
  • Чего он не делает изначально: не генерирует JWT, не сохраняет файлы, не отправляет сообщения в режиме реального времени и не предоставляет пул соединений со встроенным переключателем ролей.
  • В Aurabase проект движка Postgres выполняется на реальном выделенном экземпляре PostgREST 16.5, а не на его повторной реализации. Проект движка MongoDB проходит через уровень REST, специфичный для Aurabase, основанный на тех же соглашениях, но с другими ограничениями.
  • Альтернативы варьируются от локального PostgREST (все, что нужно собрать вокруг него) до полноценного бэкэнда (Supabase, Aurabase) через API-интерфейсы GraphQL, такие как Hasura или PostGraphile.
#
Определение

Что такое PostgREST?

PostgREST — это автономный веб-сервер, который преобразует существующую базу данных PostgreSQL в REST API непосредственно из ее схемы. Никакого прикладного уровня для записи: таблицы, представления и функции становятся маршрутами, а разрешения SQL — ролями, политиками RLS — становятся уровнем авторизации.

Конкретно, PostgREST охватывает пять возможностей, которые встречаются почти во всех оценках:

  • Горизонтальная фильтрация — около тридцати операторов (eq, gt, like, ilike, in, is, cs, ov, fts...) непосредственно в строке запроса.
  • Вертикальная фильтрация и внедрение — ?select= проецирует столбцы и внедряет связи через внешний ключ, например customer:customers(email).
  • RPC — POST /rpc/{fonction} напрямую вызывает функцию SQL, которая становится конечной точкой.
  • RLS, управляемый JWT — PostgREST переключает активную роль Postgres в соответствии с полученным токеном (SET LOCAL ROLE), поэтому ваши политики применяются как есть, без дублирующей логики авторизации на стороне приложения.
  • Самогенерируемый OpenAPI — спецификация выводится из открытой схемы без файла, который нужно поддерживать вручную.
Типичный запрос PostgRESTbash
curl "https://<gateway>/v1/db/<project_id>/orders \
  ?select=id,total,customer:customers(email) \
  &status=eq.paid \
  &order=created_at.desc" \
  -H "apikey: <votre-cle-api>"

Один HTTP-запрос фильтрует оплаченные заказы, встраивает электронную почту клиента с помощью внешнего ключа и сортирует по дате — без необходимости прописывать отдельный маршрут вручную.

RPC следует той же логике: функция SQL, уже написанная в вашей базе данных, становится конечной точкой POST, а ее аргументы передаются в формате JSON.

RPC-вызовbash
curl -X POST "https://<gateway>/v1/db/<project_id>/rpc/monthly_revenue" \
  -H "apikey: <votre-cle-api>" \
  -H "Content-Type: application/json" \
  -d '{"year": 2026, "month": 8}'

Этот принцип (схема Postgres является единственным источником истины API) делает PostgREST предсказуемым: каждое изменение поведения происходит через миграцию SQL, а не через отдельный уровень приложения, который может быть получен из реальной схемы. Проект с открытым исходным кодом, разработанный на GitHub независимо от какого-либо конкретного поставщика BaaS.

#
Пределы

Чего PostgREST не делает

PostgREST разрешает уровень CRUD. Он не разрешает остальную часть серверной части приложения. Четыре недостатка систематически возникают среди команд, которые применяют его в одиночку.

  • Аутентификация — без выдачи JWT или интегрированного управления пользователями. Вы должны создать его на SQL или делегировать внешней службе.
  • Файловое хранилище — нет. Ведро S3 или его эквивалент необходимо подключить отдельно.
  • в реальном времени — PostgREST отвечает на одноразовые HTTP-запросы, не отправляя никаких событий.
  • Пул соединений — PostgREST сам подключается к Postgres, но не интегрирует какие-либо расширенные средства пула. В масштабе управление им становится самостоятельным операционным решением: пулер в классическом режиме транзакций конфликтует с механизмом перезагрузки схемы PostgREST (см. ниже, как Aurabase разрешает этот компромисс).
Информация

Ни один из этих недостатков не является недостатком дизайна: PostgREST добровольно выполняет определенную работу (схема → REST API). Именно этот узкий периметр делает его поведение предсказуемым.

Следует четко обозначить практический вывод: без аутентификации ваши политики RLS становятся единственной границей безопасности между анонимным клиентом и вашими данными. Плохо написанная политика для роли anon не заменяется дополнительным уровнем приложения — его нет.

#
Проверено в коде

PostgREST и Aurabase: что на самом деле раскрыто

В проекте механизма Aurabase Postgres — механизме по умолчанию — шлюз направляет каждый запрос CRUD непосредственно в экземпляр PostgREST 16.5, выделенный для этого проекта, две реплики, расположенные рядом с кластером Postgres арендатора. Это не приблизительная совместимость: это сам исходный двоичный файл PostgREST с теми же операторами, тем же встраиванием, тем же RPC, тем же RLS, управляемым JWT.

В проекте движка MongoDB ситуация иная. MongoDB не имеет эквивалента PostgREST: эти запросы перенаправляются во внутренний сервис Aurabase, который переопределяет подмножество тех же соглашений — идентичные имена операторов, синтаксис ?select= с встраиванием, заголовки Prefer и Content-Range — но в механизме документов, а не в реляционном. Этот уровень имеет свои ограничения: встраивание, запрошенное в представление, возвращаемое мутацией, явно отвергается, а не игнорируется молча, и не существует маршрута RPC, эквивалентного функциям SQL.

Различие имеет значение при выборе

Полная совместимость PostgREST, включая RPC и RLS, является фактом движка Postgres, а не гарантией совместимости между движками. Если ваш проект зависит от функций SQL, представленных в RPC, на сегодняшний день единственным вариантом является механизм Postgres.

Техническая деталь контрастирует с интуицией: каждый выделенный экземпляр PostgREST остается напрямую подключенным к основному Postgres без прохождения через пулер PgBouncer, развернутый для этого клиента. Предполагаемая причина: режим объединения транзакций нарушит перезагрузку схемы PostgREST, которая опирается на LISTEN/NOTIFY — постоянное соединение, несовместимое с пулом, который перезапускает соединение для каждой транзакции.

Еще одна полезная деталь в продакшене: неактивный проект можно поставить на паузу для экономии ресурсов. Первый запрос к спящему проекту запускает его пробуждение и получает 503 с задержкой повтора, временем, в течение которого выделенный экземпляр PostgREST может вернуться в исходное состояние — предполагаемый компромисс между стоимостью и холодной задержкой, а не скрытый инцидент.

#
Сравнение

Какие альтернативы PostgREST существуют?

PostgREST имеет четкое применение: схема Postgres является источником истины, и команда хочет избежать написания слоя CRUD вручную. Помимо этого конкретного случая, существует несколько семейств альтернатив в зависимости от того, что вы хотите добавить — от вообще ничего (только самостоятельный хостинг) до полностью готового к использованию бэкэнда.

В таблице ниже сравнивается то, что каждый вариант охватывает изначально, и то, что он оставляет на ваше усмотрение — без оценочного суждения об архитектуре, выбранной каждым проектом.

Самостоятельный хостинг PostgRESTСамогенерируемый REST API (фильтры, внедрение, RPC, RLS).Аутентификация, хранилище, режим реального времени, пользовательский интерфейс администратора — все, что нужно собрать воедино.
SupabaseИнтегрированные PostgREST + аутентификация (GoTrue), хранилище, функции реального времени, периферийные функции.Гетерогенный стек (Elixir/Go/TS/Node), собранный сервис за сервисом.
Hasura / PostGraphileАвтоматически сгенерированный GraphQL API от Postgres.Подход GraphQL, а не REST — специальное сравнение ниже.
ДиректусПользовательский интерфейс администратора + общий API REST/GraphQL, несколько СУБД.Предназначен для управления данными/CMS, а не для полной серверной части приложения.
Фреймворк ручной работы (Express, FastAPI, Rails…)Полный контроль на любой дороге.CRUD, валидация, аутентификация, объединение — все написано от руки.
AurabaseНастоящий PostgREST выделен для каждого проекта Postgres + аутентификация, хранилище, функции реального времени, периферийные функции и уже интегрированный искусственный интеллект.В движке MongoDB уровень REST перестроен Aurabase, а не самим PostgREST.

Момент, который часто недооценивают при выборе «самостоятельного размещения»: PostgREST сам по себе остается легким для запуска, но производственная операция (обновление версии, высокая доступность, связь с пулером, мониторинг) остается полностью вашей ответственностью — именно эта операционная работа, а не программное обеспечение, поглощается управляемыми платформами.

Подробное сравнение подходов GraphQL — pg_graphql, Hasura и PostGraphile — см. в нашей статье, посвящённой API GraphQL на Postgres.

#
Решение

Как выбрать

Чаще всего возникают четыре ситуации. Правильный выбор зависит главным образом от того, что вы готовы собрать и обслуживать самостоятельно.

  • Вам просто нужен REST API поверх существующей схемы Postgres, и ничего больше. Самостоятельного PostgREST достаточно: он делает именно то, что должен, и больше ничего устанавливать не нужно.
  • Вам нужна дополнительная аутентификация, хранилище и реалтайм, и вы готовы собрать несколько сервисов. Supabase или PostgREST в сопровождении вашего собственного стека приложений удовлетворяет эту потребность.
  • Вы предпочитаете GraphQL REST. Hasura или PostGraphile закрывают эту тему — это другой архитектурный выбор, а не прямая замена PostgREST.
  • Вам нужен полноценный бэкэнд Postgres без объединения нескольких отдельных сервисов. Это угол, который документирует наша унифицированная архитектура Rust: настоящий PostgREST для уровня CRUD, изначально окруженный функциями аутентификации, хранения, реального времени и пограничных функций.
#
Часто задаваемые вопросы

Часто задаваемые вопросы

Что такое PostgREST?+
PostgREST — это веб-сервер с открытым исходным кодом, который преобразует существующую базу данных PostgreSQL в REST API непосредственно из ее схемы: таблицы, представления и функции становятся маршрутами без необходимости написания бэкэнда.
Может ли PostgREST заменить полный бэкэнд?+
Нет. PostgREST охватывает уровень CRUD (фильтры, внедрение, RPC, RLS), но не JWT выбросы, хранение файлов или режим реального времени. Полноценный бэкэнд требует самостоятельной сборки этих блоков или использования платформы, которая их уже интегрирует.
Совместим ли Aurabase на 100% с PostgREST?+
В проекте ядра Postgres да: Aurabase направляется к фактическому вышестоящему экземпляру PostgREST, а не к повторной реализации. В проекте движка MongoDB нет: уровень REST представляет собой подмножество соглашений PostgREST, реконструированных Aurabase в движке документов, с другими ограничениями (без RPC, встраивание запрещено при мутациях).
Как получить автоматический REST API на Postgres без написания бэкэнда?+
Два основных варианта: установить PostgREST самостоятельно перед своей базой данных (он читает диаграмму и предоставляет маршруты) или использовать платформу, которая уже интегрирует его — например, Supabase или Aurabase— чтобы избежать использования экземпляра в дополнение к его использованию.

ГОТОВЫ К РАЗВЕРТЫВАНИЮ?

Ваш бэкэнд за пять минут.

Кредитная карта не требуется · 500 МБ бесплатно · 50 000 MAU