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.
Temeller
- PostgREST, Postgres şemasından otomatik olarak bir REST API oluşturur; rastgele bir iş mantığı mümkün değildir; RLS tek güvenlik sınırı olarak kalır.
- Hasura, GraphQL motorunun üzerine rol ve tabloya göre kendi izin sistemini, bir iş web kancasına bağlanmaya yönelik Eylemleri, Etkinlik Tetikleyicilerini ve RESTified uç noktalarını ekler.
- Özel bir API (Node.js, Express, Fastify...), her şeyi kendiniz yazma, test etme ve bakımını yapma pahasına iş mantığı, doğrulama ve kimlik doğrulama üzerinde tam kontrol sağlar.
- Aurabase üzerinde PostgREST katmanı gerçek bir örnektir; CRUD'un ötesindeki iş mantığı, barındırılacak ayrı bir Node sunucusu aracılığıyla değil, RPC'de veya Edge Functions aracılığıyla kullanıma sunulan SQL işlevlerinden geçer.
- Üç yaklaşımın mutlaka birbirini dışlaması gerekmez: CRUD için PostgREST ile hassas işlemler için özel bir API'nin birleştirilmesi, üretimde yaygın bir modeldir.
Gerçek seçim: iş mantığını kim, nerede yazıyor?
“PostgREST veya Hasura veya özel API” sorusu daha yararlı bir soruyu gizlemektedir: iş mantığınızı kim, hangi araçla yazıyor ve bu kodu üretimde kim kullanıyor? Üç mimari farklı tepki veriyor ve bu fark diğer her şeyi (güvenlik, uygulama hızı, uzun vadede teknik borç) yapılandırıyor.
| API'nin Kökeni | SQL şemasından oluşturuldu | GraphQL Hasura motoru aracılığıyla şemadan oluşturulmuştur | Elle rota rota yazılı |
|---|---|---|---|
| Özel iş mantığı | Yalnızca SQL işlevleri (RPC) | Eylemler (webhook) + Etkinlik Tetikleyicileri | Araç kısıtlamaları olmadan herhangi bir kod |
| Güvenlik Modeli | RLS Postgres, JWT tarafından yönlendirilen rol | RLS yetkisine değil, role/tabloya özel izinler | Kodladığınız kod (ara katman yazılımı, ORM, isteğe bağlı RLS) |
| Ek olarak konaklamak için | Hiçbir şey — hafif bir ikili dosya | Kendi meta veri tabanına sahip Hasura motoru | Eksiksiz uygulama sunucusu |
| Öğrenme eğrisi | Ekip zaten SQL yazmayı biliyorsa düşük | Medium — yeni bir izinler ve yapılandırma sistemi | Araçta hiçbir şey yok, ancak tasarlanacak her şey var |
| POSGREST SONRASI | HAŞURA | ÖZEL API |
Üç sütundan hiçbiri kesinlikle daha iyi değil: her biri işi başka bir yere kaydırıyor. PostgREST bunu SQL'e, Hasura ise klasik uygulama koduna özel bir API olan yapılandırmaya ve web kancalarına taşır.
PostgREST: şemanın doğrudan yansıması olarak API
PostgREST, Postgres şemanızı, yazılacak arka uç olmadan filtreler, ilişki yerleştirme, RPC, JWT tarafından yönetilen RLS içeren bir REST API'ye dönüştürür. Bu kapsamı, gerçek uyumluluğu ve alternatifleri hakkındaki makalemizde derinlemesine detaylandırıyoruz; bu karşılaştırma için önemli olan PostgREST'nin nerede durduğudur.
PostgREST'nin keyfi iş mantığı kavramı yoktur. Her kuralın SQL'de ifade edilmesi gerekir: bir RPC işlevi, bir tetikleyici, bir kısıtlama, bir RLS politikası. Bu, bir gözden kaçırma değil, kabul edilmiş bir kısıtlamadır; diyagram, bir uygulama katmanı ile hizmet ettiği taban arasındaki herhangi bir sapmayı ortadan kaldıran tek gerçek kaynak olmaya devam etmektedir.
Somut olarak, doğrudan bir PostgREST isteğinden üçüncü taraf bir ödeme hizmetini aramak, onay e-postası göndermek veya JavaScript'te bir puan hesaplamak imkansızdır. Bu mantık ya SQL'de yaşamalı (pl/pgsql işlevi) ya da dışarıda tetiklenmelidir - artık PostgREST olmayan bir harici hizmet tarafından dinlenen bir NOTIFYolayı yayınlayan bir tetikleyici.
Hasura: izinler bildirildi, iş mantığı webhook tarafından aşılandı
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.
Bir Eylemi Hasura, seçtiğiniz dilde yazdığınız bir HTTP web kancası tarafından desteklenen özel bir GraphQL mutasyonunu veya sorgusunu ortaya çıkarır. Hasura girişleri bildirilen şemaya göre doğrular, web kancanızı çağırır ve ardından yanıtını istemciye döndürür. CRUD'un ötesine geçen her türlü mantığa açılan kapıdır: ödeme sağlayıcısına çağrı, karmaşık hesaplama, çok adımlı orkestrasyon.
Olay Tetikleyicileri ters yönü takip eder: tablodaki bir ekleme, güncelleme veya silme işlemi, eşzamansız olarak ve başarısızlık durumunda otomatik yeniden başlatmayla bir web kancasını tetikler. Bu, çoğu Hasura entegrasyonunun, bu kodu ilk müşteri isteğine bağlamadan bir üçüncü taraf hizmetini (faturalandırma, işlemsel e-posta, arama motoru) senkronize etmek için kullandığı mekanizmadır.
Hasura ayrıca önceden yazılmış bir GraphQL sorgusunu, adlandırılmış bir yol ve parametrelerle (kendi belgelerinin terminolojisinde RESTifieduç noktaları) tipik bir REST yolu olarak ortaya çıkarabilir. Ön uç ekibiniz temel GraphQL izin motorundan vazgeçmeden REST kullanmayı tercih ediyorsa kullanışlıdır.
Hasura izinleri, rol ve tablo başına Hasura'ye özgü bir sistemdir; Postgres RLS için bir temsilci değildir. Erişim kurallarını denetlemek için tek bir yer yerine iki yer; Eylemler ve Olay Tetikleyicilerinden elde edilen esneklikle karşılaştırıldığında gerçek bir maliyet.
Özel makalemizde geliştirilen bağlam hatırlatıcısı: Hasura, Haziran 2025'ten bu yana, resmi web sitesinde hala "savaşta test edilmiş" olarak sunulan GraphQL motorunu kaldırmadan, AI aracıları için tasarlanmış bir katman olan PromptQL üzerindeki iletişimine yeniden odaklandı.
Özel API (Node.js, Express, Fastify): her şeyi kodlayın, her şeyi kontrol edin
Elle yazılan bir API'nin tanımı gereği hiçbir sınırı yoktur: herhangi bir dilde, herhangi bir bağımlılıkla herhangi bir iş mantığı. Aynı zamanda sizin için hiçbir şeyin üretilmediği üç seçenekten sadece biridir; her rota, her doğrulama, veritabanına olan her bağlantı, sahip olduğunuz ve sürdürmeniz gereken koddur.
// Filtreleme, sıralama ve ilişki yerleştirme elle yazılır,
// yalnızca bu rota için — her API kaynağı için tekrarlayın
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)
});
Bu model, manuel çalışma karşılığında şunları sunar: hatalar ve döndürülen HTTP kodları üzerinde tam kontrol, klasik test edilebilirlik (bildirimsel yapılandırma değil işleyiciler) ve kendi diline zaten hakim olan bir ekip için öğrenilecek yeni DSL yok.
Karşılığında maliyeti nedir: Her kaynak için elle yazmak ve sürdürmek için CRUD, sayfalandırma ve filtreler; otomatik olarak devralınmadan, kendinizi uygulamak ve denetlemek için kimlik doğrulama ve yetkilendirme RLS; her iç içe ilişkinin disiplin olmadan kendi Postgres sorgusunu tetiklemesi durumunda N+1 sorgu riski; ve API belgelerinin manuel olarak veya entegre edilecek bir üçüncü taraf oluşturucu aracılığıyla tutulması.
Ham performansla ilgili olarak, "Node.js Rust'den daha yavaş mı?" sorusu başlı başına bir konudur - Rust ile Node.js gecikmesi arasındaki makalemiz, karşılaştırma metodolojisi sayfamızda yukarı akışta açıklanan metodoloji ile bu konuyu ayrıntılı olarak ele almaktadır. . Özel bir API, halihazırda kullanmakta olduğunuz herhangi bir HTTP hizmetiyle aynı performans profiline sahiptir; yapısı gereği ne daha iyi ne de daha kötüdür. PostgREST'nin tam olarak nerede doyduğunu ve hangi noktada özel bir katmanın gerekli hale geldiğini bilmek için, üretiminde PostgREST'nin gerçek sınırları hakkındaki makalemize bakın.
Karşılaştırma tablosu: üç seçenek yan yana
Mimarinin ötesinde, seçim yaparken sıklıkla dört kriter ortaya çıkıyor: uygulama hızı, gerçek iş esnekliği, uzun vadeli teknik borç ve her seçeneğin en rahat olduğu tipik kullanım durumu.
| İlk kurulum | Dakikalar — şema zaten mevcut | Saatler — üssü bağlayın, izinleri yapılandırın | Günlerden haftalara — her rotayı yazın |
|---|---|---|---|
| İş esnekliği | SQL ile sınırlıdır (RPC, tetikleyiciler) | Eylemler/Olay Tetikleyicileri aracılığıyla iyi, ancak harici bir web kancasından geçiyor | Toplam, basit |
| Dönem teknik borcu | Zayıf - diyagram gerçeğin tek kaynağı olmaya devam ediyor | Orta — şemaya ek olarak bakımı yapılacak Hasura meta veriler | Ekip disiplin olmadan büyüyorsa yüksek (testler, dokümantasyon, inceleme) |
| Tipik kullanım durumu | CRUD'u kararlı bir şema üzerinde yönlendirin, ekip SQL'de rahat olsun | Birkaç veri kaynağını veya yapay zeka aracı odaklı mantığı birleştirin | Karmaşık iş mantığı, çok sayıda üçüncü taraf entegrasyonu |
| POSGREST SONRASI | HAŞURA | ÖZEL API |
Aurabase projesinde iş mantığı nereye gidiyor?
Bir Aurabase Postgres motor projesinde CRUD katmanı, yaklaşık bir yeniden uygulama değil, gerçek bir PostgREST örneği tarafından zaten kapsanmaktadır. Bu karşılaştırma için açık kalan soru şu: CRUD'un ötesine geçenler nereye yazılmalı?
İki yol vardır ve bunlar birbirini dışlamaz. Birincisi: SQL'de ifade edilmesi makul olan herhangi bir mantık için RPC'de kullanıma sunulan bir SQL işlevi - toplamın hesaplanması, birkaç tablo arasında çapraz doğrulama, tek bir işlemde güncellemelerin basamaklandırılması.
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"}'
İkinci yol: Edge Functions, SQL alanının ötesine geçen her şey için - ödeme API'sini çağırmak, e-posta göndermek, yerleştirme hesaplamak. Oraya Aurabase adresinde iki yol çıkar: Deno (TypeScript) kodunu tam olarak Supabase üzerinde çalıştıran Studio editörü ve Rust ile yazılan ve WASM ile derlenen işlevler için ayrı bir yol hedefleyen aura functions deployCLI — birleşik belgemizde ayrıntılı olarak açıklanmıştır Rust mimari. Bu makaledeki sunucunun tamamen sizin sorumluluğunuzda olduğu saf "özel API" seçeneğinin aksine, her iki yol da ayrı bir Node sunucusunun barındırılmasını gerektirmez.
Bu dağıtım, burada karşılaştırılan üç model arasında zayıf bir uzlaşma değildir: Kelimenin tam anlamıyla CRUD için PostgREST, RPC ve tetikleyiciler aracılığıyla olay mantığı için Hasura Eylemlerine yakın bir tuğla ve tam bir uygulama sunucusunun çalışmasını önleyen Edge Functions - "tümü PostgREST" ve "tümü özel" arasında ikili bir seçim yapmaya zorlamadan.
Bağlamınıza göre nasıl seçilir
En sık dört durum ortaya çıkar. Doğru seçim çoğunlukla bir aracın popülerliğine değil, iş mantığınızın neye ihtiyaç duyduğuna bağlıdır.
- Şemanız kararlı ve iş mantığınız SQL'de. Kendi kendine barındırılan PostgREST veya yerel olarak entegre edilmiş (Aurabase, Supabase) yeterlidir: barındırılacak başka bir şey yoktur ve şema gerçeğin tek kaynağı olarak kalır.
- Birkaç veri kaynağını bir araya getirmek istiyorsunuz veya yol haritanız, verilerinizi tüketen yapay zeka aracılarına yönelik. Hasura PromptQL katmanıyla bu duruma daha iyi uyuyor.
- Ürününüz zengin iş mantığına, çok sayıda üçüncü taraf entegrasyonuna ve halihazırda bir uygulama diliyle donatılmış bir ekibe sahiptir. Özel bir API, yazılması ve zaman içinde bakımının yapılması pahasına en doğrudan seçenek olmayı sürdürüyor.
- İş mantığı için gerçek alandan (RPC, Edge Functions) vazgeçmeden, istismar edilecek bir uygulama hizmeti daha istiflemeden, kendi kendine oluşturulan CRUD istiyorsunuz. Bu, önceki bölümdeki Aurabase'ye uygulanan bu karşılaştırmada belgelenen açıdır.