This article extends two comparisons already published on this blog: our review of PostgREST compatibility and its alternatives and our comparison dedicated to GraphQL layers on Postgres. Here the angle changes: a decision grid between three ways to build an API layer, with Hasura treated for its permissions and business extension points rather than its GraphQL syntax, and a hand-written API as an option in its own right, not a simple "else" line at the bottom of the table.
필수사항
- PostgREST는 Postgres 스키마에서 REST API를 자동 생성합니다. 임의의 비즈니스 로직은 불가능하며 RLS는 유일한 보안 경계로 남아 있습니다.
- Hasura는 역할 및 테이블별 자체 권한 시스템, 비즈니스 웹훅을 연결하는 작업, 이벤트 트리거 및 GraphQL 엔진 위에 RESTified 엔드포인트를 추가합니다.
- 사용자 정의 API(Node.js, Express, Fastify...)를 사용하면 모든 것을 직접 작성하고 테스트하고 유지 관리하는 대신 비즈니스 논리, 유효성 검사 및 인증을 완벽하게 제어할 수 있습니다.
- Aurabase에서 PostgREST 레이어는 실제 인스턴스입니다. CRUD 이상의 비즈니스 로직은 호스트에 대한 별도의 노드 서버를 통하지 않고 RPC에 노출된 SQL 함수 또는 Edge Functions를 통해 진행됩니다.
- 세 가지 접근 방식이 반드시 상호 배타적인 것은 아닙니다. CRUD용 PostgREST과 민감한 작업을 위한 사용자 지정 API를 결합하는 것은 프로덕션에서 일반적인 패턴입니다.
진정한 선택: 비즈니스 로직을 작성하는 사람과 위치
"PostgREST 또는 Hasura 또는 사용자 정의 API"라는 질문에는 더 유용한 질문이 숨겨져 있습니다. 누가 비즈니스 로직을 작성하고, 어떤 도구를 사용하며, 프로덕션에서 이 코드를 사용하는 사람은 누구입니까? 세 가지 아키텍처는 서로 다르게 반응하며, 이러한 차이로 인해 보안, 구현 속도, 장기적 기술 부채 등 모든 것이 구조화됩니다.
| API의 유래 | SQL 스키마에서 생성됨 | GraphQL Hasura 엔진을 통해 스키마에서 생성됨 | 경로별로, 손으로 쓴 경로 |
|---|---|---|---|
| 사용자 정의 비즈니스 로직 | SQL 함수(RPC)만 해당 | 작업(웹훅) + 이벤트 트리거 | 도구 제약 없이 모든 코드 |
| 보안 모델 | RLS Postgres, JWT에 의해 주도되는 역할 | RLS에 대한 위임이 아닌 역할/테이블에 특정한 권한 | 코딩하는 내용(미들웨어, ORM, 선택 사항 RLS) |
| 추가적으로 수용하기 위해 | 아무것도 — 가벼운 바이너리 | 자체 메타데이터 기반을 갖춘 Hasura 엔진 | 완전한 애플리케이션 서버 |
| 학습 곡선 | 팀이 이미 SQL 작성 방법을 알고 있는 경우 낮음 | 중간 — 새로운 권한 및 구성 시스템 | 도구에는 아무것도 없지만 디자인할 다른 모든 것 |
| 포스트그레스트 | 하스라 | 커스텀 API |
세 개의 열 중 어느 것도 더 나은 것은 없습니다. 각 열은 작업을 다른 곳으로 이동시킵니다. PostgREST는 SQL로, Hasura는 구성 및 웹훅으로, 맞춤형 API는 클래식 애플리케이션 코드로 이동합니다.
PostgREST: 스키마를 직접 반영하는 API
PostgREST는 작성할 백엔드 없이 Postgres 스키마를 REST API(필터, 관계 삽입, RPC, JWT에 의해 구동되는 RLS)로 변환합니다. 실제 호환성과 대안에 대한 기사에서 이 범위를 자세히 자세히 설명합니다. 이 비교에서 중요한 것은 PostgREST가 중지되는 위치입니다.
PostgREST에는 임의의 비즈니스 로직에 대한 개념이 없습니다. 각 규칙은 SQL(RPC 함수, 트리거, 제약 조건, RLS 정책)로 표현되어야 합니다. 이는 실수가 아니라 허용되는 제약입니다. 다이어그램은 유일한 정보 소스로 남아 있어 애플리케이션 계층과 해당 계층이 제공하는 기반 사이의 드리프트를 제거합니다.
구체적으로, 직접적인 PostgREST 요청으로 제3자 결제 서비스에 전화하거나, 확인 이메일을 보내거나, JavaScript로 점수를 계산하는 것은 불가능합니다. 이 논리는 SQL(pl/pgsql 함수)에 있거나 외부에서 트리거되어야 합니다. 즉, 더 이상 PostgREST이 아닌 외부 서비스에서 수신되는 NOTIFY이벤트를 게시하는 트리거입니다.
Hasura: 권한 선언, 웹훅에 접목된 비즈니스 로직
Our article on GraphQL layers on Postgres details where the Hasura engine runs and how its permissions differ from the Postgres RLS. Here, the angle is that of business logic: how to plug custom code into a database managed by Hasura, and where.
작업 Hasura는 선택한 언어로 작성하는 HTTP 웹후크를 통해 지원되는 사용자 지정 GraphQL 변형 또는 쿼리를 노출합니다. Hasura는 선언된 스키마에 따라 입력의 유효성을 검사하고 웹후크를 호출한 다음 해당 응답을 클라이언트에 반환합니다. 이는 CRUD를 넘어서는 모든 논리(결제 공급자 호출, 복잡한 계산, 다단계 조정)에 대한 관문입니다.
이벤트 트리거는 반대 방향을 따릅니다. 즉, 테이블에 대한 삽입, 업데이트 또는 삭제가 웹후크를 비동기식으로 트리거하고 실패 시 자동으로 다시 시작됩니다. 이는 대부분의 Hasura 통합이 이 코드를 초기 고객 요청에 연결하지 않고 타사 서비스(청구, 거래 이메일, 검색 엔진)를 동기화하는 데 사용하는 메커니즘입니다.
Hasura는 또한 이미 작성된 GraphQL 쿼리를 일반적인 REST 경로로 노출할 수 있으며, 해당 경로와 매개변수는 자체 문서의 용어로 RESTified엔드포인트입니다. 프런트엔드 팀이 기본 GraphQL 권한 엔진을 포기하지 않고 REST를 사용하는 것을 선호하는 경우 유용합니다.
Hasura 권한은 Postgres RLS에 대한 위임이 아니라 역할별, 테이블별 Hasura특정 시스템입니다. 액세스 규칙을 감사할 수 있는 장소는 한 곳이 아닌 두 곳입니다. 액션 및 이벤트 트리거를 통해 얻은 유연성을 비교하면 실제 비용이 많이 듭니다.
전용 기사에서 개발된 상황 알림: Hasura은 2025년 6월부터 AI 에이전트용으로 설계된 계층인 PromptQL에 대한 통신에 다시 초점을 맞췄습니다. GraphQL 엔진을 제거하지 않고 여전히 공식 웹사이트에 "전투 테스트를 거쳤습니다"라고 표시되어 있습니다.
사용자 정의 API(Node.js, Express, Fastify): 모든 것을 코딩하고 모든 것을 제어
손으로 작성한 API에는 정의상 제한이 없습니다. 모든 비즈니스 로직, 모든 언어, 종속성이 있습니다. 이는 또한 아무것도 생성되지 않는 세 가지 옵션 중 유일한 것입니다. 모든 경로, 모든 검증, 데이터베이스에 대한 모든 연결은 귀하가 소유하고 유지 관리해야 하는 코드입니다.
// 필터, 정렬, 관계 임베딩은 모두 직접 작성하고,
// 이 경로에 대해서만 — 각 API 리소스에 대해 반복합니다.
router.get('/orders', async (req, res) => {
const { status } = req.query
const result = await db.query(
`SELECT o.id, o.total, c.email AS customer_email
FROM orders o JOIN customers c ON c.id = o.customer_id
WHERE o.status = $1 ORDER BY o.created_at DESC`,
[status]
);
res.json(result.rows)
});
수동 작업 대신 이 모델이 제공하는 것: 오류 및 반환된 HTTP 코드에 대한 완전한 제어, 고전적인 테스트 가능성(선언적 구성이 아닌 핸들러), 이미 언어를 마스터한 팀이 배울 수 있는 새로운 DSL이 없습니다.
그에 따른 비용: 각 리소스에 대해 직접 작성하고 유지 관리하는 CRUD, 페이지 매김 및 필터; 자동으로 상속되지 않고 스스로 구현하고 감사하기 위한 인증 및 권한 부여 RLS; 각 중첩 관계가 규율 없이 자체 Postgres 쿼리를 트리거하는 경우 N+1 쿼리의 위험; API 문서는 수동으로 유지 관리하거나 타사 생성기를 통해 통합할 수 있습니다.
원시 성능에 대해 "Node.js가 Rust보다 느린가요? "라는 질문은 그 자체로 주제입니다. Rust 대 Node.js 대기 시간에 대한 기사에서 벤치마크 방법론 페이지에 업스트림으로 선언된 방법론과 함께 이를 자세히 다루고 있습니다. 사용자 정의 API는 이미 사용하고 있는 HTTP 서비스와 동일한 성능 프로필을 가지며 구성에 따라 더 좋거나 나쁘지 않습니다. PostgREST가 포화되는 위치와 사용자 정의 레이어가 필요한 지점을 정확히 알고 싶다면 프로덕션에서 PostgREST의 실제 한계에 대한 기사를 참조하세요.
비교표: 세 가지 옵션을 나란히 나열
아키텍처 외에도 구현 속도, 실제 비즈니스 유연성, 장기 기술 부채, 각 옵션이 가장 적합한 일반적인 사용 사례 등 선택할 때 가장 자주 나타나는 네 가지 기준이 있습니다.
| 초기 설정 | 분 — 스키마가 이미 존재합니다. | 시간 - 베이스 연결, 권한 구성 | 며칠에서 몇 주까지 - 각 경로 작성 |
|---|---|---|---|
| 비즈니스 유연성 | SQL(RPC, 트리거)로 제한됨 | 작업/이벤트 트리거를 통해 적합하지만 외부 웹훅을 통과합니다. | 총체적, 간단함 |
| 기간 기술 부채 | 약함 - 다이어그램이 유일한 정보 소스로 남아 있습니다. | 중간 — 스키마 외에 유지 관리할 Hasura 메타데이터 | 팀이 규율(테스트, 문서, 검토) 없이 성장하는 경우 높음 |
| 일반적인 사용 사례 | 안정적인 스키마의 직접 CRUD, SQL에 익숙한 팀 | 여러 데이터 소스 또는 AI 에이전트 중심 로직을 통합합니다. | 복잡한 비즈니스 로직, 수많은 타사 통합 |
| 포스트그레스트 | 하스라 | 커스텀 API |
Aurabase 프로젝트에서 비즈니스 로직은 어디로 가는가
Aurabase Postgres 엔진 프로젝트에서 CRUD 레이어는 대략적인 재구현이 아닌 실제 PostgREST 인스턴스로 이미 덮여 있습니다. 이 비교를 위해 아직 열려 있는 질문은 CRUD를 넘어서는 내용을 어디에 작성해야 하는가입니다.
두 가지 경로가 존재하며 서로 배타적이지 않습니다. 첫 번째: SQL로 표현하기에 합당한 모든 논리에 대해 RPC에 노출된 SQL 함수 — 전체 계산, 여러 테이블 간의 교차 유효성 검사, 단일 트랜잭션의 계단식 업데이트.
curl -X POST "https://<gateway>/v1/db/<project_id>/rpc/apply_discount" \
-H "apikey: <votre-cle-api>" \
-H "Content-Type: application/json" \
-d '{"order_id": 42, "code": "WELCOME10"}'
두 번째 방법: Edge Functions, SQL 도메인을 넘어서는 모든 것(결제 API 호출, 이메일 보내기, 임베딩 계산). Aurabase에는 두 가지 경로가 있습니다. 하나는 Supabase에서와 똑같이 Deno(TypeScript) 코드를 실행하는 Studio 편집기이고 다른 하나는 Rust에서 작성되고 WASM에서 컴파일된 함수에 대한 별도의 경로를 목표로 하는 aura functions deployCLI입니다. 자세한 내용은 통합 Rust 아키텍처에 나와 있습니다.. 해당 서버가 전적으로 귀하의 책임인 이 문서의 순수 "사용자 정의 API" 옵션과 달리 두 경로 모두 별도의 노드 서버를 호스팅할 필요가 없습니다.
이 배포는 여기에서 비교된 세 가지 모델 간의 불안정한 절충안이 아닙니다. 문자 그대로 CRUD의 경우 PostgREST, RPC 및 트리거를 통한 이벤트 로직의 경우 Hasura 작업에 가까운 브릭, 그리고 "all PostgREST"와 "all custom" 사이에서 바이너리 선택을 강요하지 않고 완전한 애플리케이션 서버의 작동을 피하는 Edge Functions입니다.
상황에 따라 선택하는 방법
네 가지 상황이 가장 자주 발생합니다. 올바른 선택은 주로 도구의 인기가 아니라 비즈니스 논리에 필요한 것이 무엇인지에 달려 있습니다.
- 스키마가 안정적이고 비즈니스 논리가 SQL에 있습니다. 자체 호스팅 PostgREST또는 기본적으로 통합된(Aurabase, Supabase)이면 충분합니다. 더 이상 호스팅할 것이 없으며 스키마는 유일한 정보 소스로 남아 있습니다.
- 여러 데이터 소스를 통합하려고 하거나 로드맵이 데이터를 소비하는 AI 에이전트에 맞춰져 있습니다. Hasura는 PromptQL 레이어를 사용하여 이 지형에 더 잘 맞습니다.
- 귀하의 제품에는 풍부한 비즈니스 논리, 수많은 타사 통합 및 이미 애플리케이션 언어를 갖춘 팀이 있습니다. 사용자 정의 API는 작성하고 시간이 지남에 따라 유지 관리하는 비용이 들지만 여전히 가장 직접적인 선택입니다.
- 비즈니스 로직(RPC, Edge Functions)을 위한 실제 공간을 포기하지 않고, 활용할 애플리케이션 서비스를 하나 더 쌓지 않고 자체 생성 CRUD를 원합니다. 이는 이전 섹션의 Aurabase에 적용된 이 비교에서 문서화된 각도입니다.