YENİPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Değişiklik günlüğüne bakın →

Mühendislik · 9 dk. okuma

PostgREST uyumluluğu: neleri kapsar ve alternatifler

Affane Daylami · Fondateur · 3 Ağustos 2026

Bloga geri dön

PostgREST, PostgreSQL şemasını yazılacak arka uç olmadan bir REST API'ye dönüştürür. Bu, tam bir arka uç değil, belirli bir ihtiyaca verilen net bir yanıttır. İkisi arasındaki kafa karışıklığı, çevrimiçi geri bildirimlerde okuduğumuz hayal kırıklıklarının çoğunu açıklıyor.

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Bu makale, PostgREST'nin gerçekte neleri kapsadığını, size neleri bıraktığını ayrıntılarıyla anlatır ve ciddi alternatifleri, Aurabase'nin aslında dahili olarak kapsadığı, varsayılmak yerine koduyla doğrulanan şeylere kadar karşılaştırır.

Temeller

  • PostgREST, Postgres şemasından bir REST API oluşturur: filtreler, ilişki yerleştirme, RPC çağrıları, JWT-güdümlü RLS, OpenAPI spesifikasyonu — bir arka uç kodu satırı olmadan.
  • Yerel olarak yapmadığı şey: JWT'ler yayınlamak, dosyaları depolamak, gerçek zamanlı gönderim yapmak veya entegre rol değiştirme özelliğine sahip bir bağlantı havuzlayıcı sağlamak.
  • Aurabase adresinde, bir Postgres motor projesi, yeniden uygulama değil, gerçek bir adanmış PostgREST 16.5 örneğinde çalışır. Bir MongoDB motoru projesi, aynı sözleşmelerden esinlenerek ancak farklı sınırlarla Aurabase'ye özgü bir REST katmanından geçer.
  • Alternatifler, PostgREST veya PostGraphile gibi GraphQL API'leri aracılığıyla, kendi kendine barındırılan PostgREST (etrafında toplanacak her şey) ile tam bir arka uç (Supabase, Aurabase) arasında değişir.
#
Tanım

PostgREST tam olarak nedir?

PostgREST, mevcut bir PostgreSQL veritabanını doğrudan şemasından bir REST API'sine dönüştüren özerk bir web sunucusudur. Yazılacak uygulama katmanı yok: tablolar, görünümler ve işlevler rota haline gelir ve SQL izinleri (roller, RLS politikaları) yetkilendirme katmanı haline gelir.

Somut olarak PostgREST neredeyse tüm değerlendirmelerde ortaya çıkan beş özelliği kapsar:

  • Yatay filtreleme — yaklaşık otuz operatör (eq, gt, like, ilike, in, is, cs, ov, fts...) doğrudan sorgu dizesinde.
  • Dikey filtreleme ve yerleştirme — ?select= yabancı anahtar yoluyla sütunları yansıtır ve ilişkileri katıştırır, örneğin customer:customers(email).
  • RPC — bir POST /rpc/{fonction} doğrudan uç nokta haline gelen bir SQL işlevini çağırır.
  • RLS, JWT tarafından yönlendirilir — PostgREST, alınan belirtece (SET LOCAL ROLE) göre etkin Postgres rolünü değiştirir, böylece ilkeleriniz, uygulama tarafında yinelenen yetkilendirme mantığı olmadan olduğu gibi uygulanır.
  • Kendi kendine oluşturulan OpenAPI — spesifikasyon, elle bakımı yapılacak bir dosya olmadan, açığa çıkan şemadan çıkarılır.
Tipik PostgREST sorgusubash
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>"

Tek bir HTTP isteği, ödenen siparişleri filtreler, müşterinin e-postasını yabancı anahtar aracılığıyla yerleştirir ve tek bir rotanın elle yazılmasına gerek kalmadan tarihe göre sıralar.

RPC de aynı mantığı izler: Zaten veritabanınızda yazılmış bir SQL işlevi, bağımsız değişkenleri JSON'da iletilen bir POST uç noktası haline gelir.

RPC çağrısı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}'

Bu prensip - Postgres şeması, API'nin tek gerçek kaynağıdır - PostgREST'yi öngörülebilir kılan şeydir: her davranış değişikliği bir SQL geçişinden geçer, asla gerçek şemadan türetilebilecek ayrı bir uygulama katmanından geçmez. Proje açık kaynak olup, herhangi bir BaaS sağlayıcısından bağımsız olarak GitHub üzerinde geliştirilmiştir.

#
Sınırlar

PostgREST ne yapmaz

PostgREST CRUD katmanını çözer. Bir uygulamanın arka ucunun geri kalanını çözmez. Bunu tek başına benimseyen ekipler arasında sistematik olarak dört eksiklik ortaya çıkıyor.

  • Kimlik Doğrulaması — JWT verilmesi veya entegre kullanıcı yönetimi yok. Bunu SQL'de oluşturmanız veya harici bir hizmete devretmeniz gerekir.
  • Dosya depolama — yok. Ayrı olarak bağlanmak için bir S3 paketi veya eşdeğeri kalır.
  • Gerçek zamanlı — PostgREST tek seferlik HTTP isteklerine yanıt verir, herhangi bir olayı iletmez.
  • Bağlantı Havuzlayıcısı — PostgREST kendisi Postgres öğesine bağlanır, ancak herhangi bir gelişmiş havuz oluşturucuyu entegre etmez. Büyük ölçekte, bunu yönetmek başlı başına bir işletim kararı haline gelir: klasik işlem modundaki bir havuz oluşturucu, PostgREST şema yeniden yükleme mekanizmasıyla çelişir (aşağıya bakın, Aurabase bu uzlaşmayı nasıl çözer).
Bilgi

Bu eksikliklerin hiçbiri bir tasarım hatası değildir: PostgREST belirli bir işi (şema → REST API) gönüllü olarak yapar. Davranışını öngörülebilir kılan da bu dar çevredir.

Pratik bir sonucun açıkça belirtilmesi gerekir: Kimlik doğrulama olmadan, RLS politikalarınız, anonim bir müşteri ile verileriniz arasındaki tek güvenlik sınırı haline gelir. anon rolüne ilişkin kötü yazılmış bir politika, ek bir uygulama katmanı tarafından üstlenilmez; yoktur.

#
Giriş kodu

PostgREST, Aurabase: gerçekte ne kapsanıyor

Bir Aurabase Postgres motor projesinde (varsayılan motor) ağ geçidi, her CRUD isteğini doğrudan bu projeye ayrılmış bir PostgREST 16.5 örneğine, kiracının Postgres kümesiyle aynı konumda bulunan iki kopyaya yönlendirir. Bu yaklaşık bir uyumluluk değildir: PostgREST yukarı akış ikilisinin kendisidir, aynı operatörlere, aynı yerleştirmeye, aynı RPC'ye, aynı RLS tarafından çalıştırılır JWT.

MongoDB motoru projesinde hikaye farklıdır. MongoDB'nin PostgREST eşdeğeri yoktur: bu istekler, aynı kuralların bir alt kümesini yeniden uygulayan dahili bir Aurabase hizmetine yönlendirilir - aynı operatör adları, gömme ile ?select= sözdizimi, Prefer ve Content-Range başlıkları - ancak ilişkisel değil bir belge motorunda. Bu katmanın kendi sınırlamaları vardır: bir mutasyon tarafından döndürülen gösterimde talep edilen bir yerleştirme sessizce göz ardı edilmek yerine açıkça reddedilir ve SQL işlevlerine eşdeğer bir RPC yolu yoktur.

Seçim yaparken fark önemlidir

Tam PostgREST uyumluluğu (RPC ve RLS dahil) Postgres motorunun bir gerçeğidir, motorlar arası bir garanti değildir. Projeniz RPC'de sunulan SQL işlevlerine bağlıysa, bugün itibariyle tek seçenek Postgres motorudur.

Teknik bir ayrıntı sezgiyle çelişiyor: her ayrılmış PostgREST örneği, bu kiracı için dağıtılan PgBouncer havuzlayıcıdan geçmeden doğrudan birincil Postgres ile bağlantılı kalır. Varsayılan neden: işlem havuzu modu, her işlem için bağlantıyı geri dönüştüren bir havuzla uyumlu olmayan kalıcı bir bağlantı olan LISTEN/NOTIFY'ye dayanan PostgREST şemasının yeniden yüklenmesini bozacaktır.

Üretimdeki bir başka yararlı ayrıntı: Etkin olmayan bir proje, kaynaklardan tasarruf etmek için duraklatılabilir. Uyuyan bir projedeki ilk istek, projenin uyanmasını tetikler ve yeniden deneme gecikmesiyle bir 503 alır; bu, tahsis edilmiş PostgREST örneğinin geri gelme süresidir; gizli bir olay değil, maliyet ile soğuk gecikme arasında varsayılan bir uzlaşmadır.

#
Karşılaştırma

PostgREST'e hangi alternatifler mevcut?

PostgREST'nin açık bir kullanımı vardır: Postgres şeması gerçeğin kaynağıdır ve ekip, CRUD katmanını elle yazmaktan kaçınmak ister. Bu özel durumun dışında, ne eklemek istediğinize bağlı olarak, hiçbir şeyden (kendi kendine barındırılan) tamamen kullanıma hazır bir arka uca kadar çeşitli alternatif ailesi mevcuttur.

Aşağıdaki tablo, her bir proje tarafından seçilen mimariye ilişkin değer yargısı olmaksızın, her seçeneğin doğal olarak neyi kapsadığını ve açıkça size neyi bıraktığını karşılaştırmaktadır.

Kendi kendine barındırılan PostgRESTKendi kendine oluşturulan REST API (filtreler, yerleştirme, RPC, RLS).Kimlik doğrulama, depolama, gerçek zamanlı, yönetici kullanıcı arayüzü — her şeyin bir araya getirilmesi gerekiyor.
SupabaseEntegre PostgREST + kimlik doğrulama (GoTrue), depolama, gerçek zamanlı, uç işlevler.Heterojen yığın (Elixir/Go/TS/Node) hizmete göre birleştirilmiş hizmet.
Hasura / PostGraphilePostgres adresinden otomatik olarak oluşturulan GraphQL API'si.REST değil GraphQL yaklaşımı - aşağıdaki karşılaştırmaya özel.
DirektörYönetici kullanıcı arayüzü + genel REST/GraphQL API, çoklu DBMS.Tam bir uygulama arka ucu değil, veri yönetimi/CMS için tasarlanmıştır.
El yapımı çerçeve (Express, FastAPI, Rails…)Her yolda tam kontrol.CRUD, doğrulama, kimlik doğrulama, havuzlama — hepsi el yazısıyla yazılmıştır.
AurabasePostgres projesine ayrılmış gerçek PostgREST + kimlik doğrulama, depolama, gerçek zamanlı, uç işlevler ve yapay zeka zaten entegre edilmiştir.MongoDB motorunda, REST katmanı PostgREST tarafından değil, Aurabase tarafından yeniden oluşturuldu.

"Kendi kendine barındırılan" seçilirken sıklıkla göz ardı edilen bir nokta: PostgREST çalıştırması kolay olmaya devam eder, ancak üretim operasyonu (sürüm güncellemesi, yüksek kullanılabilirlik, bir havuz oluşturucuyla ilişkilendirme, izleme) tamamen sizin sorumluluğunuzda kalır - yönetilen platformların benimsediği yazılım değil, bu operasyon işidir.

GraphQL yaklaşımları arasında ayrıntılı bir karşılaştırma için — pg_graphql, Hasura ve PostGraphile — üzerinde GraphQL API'sine adanmış makalemize bakın Postgres.

#
Karar

Nasıl seçilir

En sık dört durum ortaya çıkar. Doğru seçim esas olarak neyi bir araya getirmek ve kendiniz korumak istediğinize bağlıdır.

  • Sadece mevcut bir Postgres şeması üzerinde bir REST API istiyorsunuz, başka bir şey değil. Kendi kendine barındırılan PostgREST yeterlidir: tam olarak yaptığını yapar ve başka hiçbir şeyin kurulmasına gerek yoktur.
  • Ek yetkilendirmeye, depolamaya ve gerçek zamanlıya ihtiyacınız var ve çeşitli hizmetleri birleştirmeye hazırsınız. Supabase veya kendi uygulama yığınınızın eşlik ettiği PostgREST bu ihtiyacı karşılar.
  • GraphQL'i REST'e tercih edersiniz. Hasura veya PostGraphile bu zemini kapsıyor — farklı bir mimari seçim, PostgREST'nin doğrudan yerine geçmez.
  • Birden fazla ayrı hizmeti bir araya getirmeden eksiksiz bir Postgres arka ucu istiyorsunuz. Bu, birleşik Rust mimarimizin belgelediği açıdır: CRUD katmanı için gerçek PostgREST, doğal olarak kimlik doğrulama, depolama, gerçek zamanlı ve uç işlevlerle çevrilidir.
#
Sıkça Sorulan Sorular

SSS

PostgREST nedir?+
PostgREST, mevcut bir PostgreSQL veritabanını doğrudan şemasından bir REST API'sine dönüştüren açık kaynaklı bir web sunucusudur: tablolar, görünümler ve işlevler, yazılacak bir arka uç olmadan rotalara dönüşür.
PostgREST tam bir arka ucun yerini alabilir mi?+
Hayır. PostgREST CRUD katmanını (filtreler, yerleştirme, RPC, RLS) kapsar ancak JWT emisyonunu, dosya depolamayı veya gerçek zamanı kapsamaz. Eksiksiz bir arka uç, bu tuğlaları kendiniz monte etmeyi veya bunları zaten entegre eden bir platformu benimsemeyi gerektirir.
Aurabase %100 PostgREST uyumlu mu?+
Bir Postgres motor projesinde evet: Aurabase, yeniden uygulamaya değil gerçek bir yukarı akış PostgREST örneğine yönlendirir. Bir MongoDB motoru projesinde hayır: REST katmanı, PostgREST tarafından bir belge motorunda farklı sınırlarla (RPC yok, yerleştirme mutasyonlarda reddedildi) yeniden oluşturulan PostgREST kurallarının bir alt kümesidir.
Bir arka uç yazmadan Postgres üzerinde otomatik REST API'si nasıl edinilir?+
İki ana seçenek: PostgREST'yi veritabanınızın önüne kendiniz kurun (diyagramı okur ve rotaları ortaya çıkarır) veya onu zaten entegre eden bir platform kullanın (örneğin, Supabase veya Aurabase), örneğin kullanımına ek olarak kötüye kullanılmasını da önlemek için.

DAĞITILMAYA HAZIR MISINIZ?

Beş dakika içinde arka ucunuz.

Kredi kartı gerekmez · 500 MB ücretsiz · 50.000 MAU