İçeriğe geç
Aurabase Logosu
aura tabanı

Veritabanı

PostgreSQL 18, kuruluşunuzun kümesinde proje başına ayrılmış bir veritabanı, yalıtılmış şemalar, otomatik olarak oluşturulan TypeScript türleri, yerel RLS. Çatal yok, yeniden yazma proxy'si yok; uzantılarınız, tetikleyicileriniz ve PL/pgSQL olduğu gibi çalışır.

Açıklama8 dk. okuSeviye orta düzey15 Nis 2026 tarihinde revize edildi

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

Postgres 18, soyutlama olmadan#

aura-db hizmeti, PostgreSQL 18'in üzerinde genel bir CRUD sunar: her projenin, kuruluşunuzun PostgreSQL kümesinde (tamamen kurumsal teklifteki tek bir projeye ayrılmış bir küme) barındırılan kendi veritabanı vardır. Her SDK çağrısı, oturuma enjekte edilen RLS policies'ye saygı duyan ince bir katman aracılığıyla yerel SQL'e çevrilir.

Ayrıca SDK'yı atlayabilir ve veritabanınızda psql, Prisma, Drizzle, Kysely, Metabase veya pg_dump işaretleyebilirsiniz: standart PostgreSQL kablolu protokol, TLS, yalnızca projenizin veritabanına erişebilen bir rol. Aşağıdaki Doğrudan bağlanma konusuna bakın. (PostgreSQL bağlantı noktasını yayınlamayan bir dağıtım, Studio › Ayarlar › Bağlantı: SDK'yı, REST API'yi, SQL düzenleyiciyi veya CLI'yi (aura db raw) kullanın.)

İpucu

Bir pg_dump size veritabanınızın tamamını (şema, veriler, uzantılar, politikalar) verir. Kilitlenme yok, önemsiz giden geçiş.

SDK, PostgREST öğesini çağırır ve bu da Postgres öğesini çağırır.#

Temel olarak SDK, .from().select()… çağrılarınızı bir PostgREST sepete yetki veren aura-db'ye bir HTTP isteği halinde serileştirir. PostgREST SQL'e çevirir ve enjekte edilen projenin search_path ile PgBouncer aracılığıyla havuzlanmış bir bağlantıyı açar.

iç akıştext
SDK        → HTTPS    GET /v1/db/sensors?select=id,name
Gateway    → aura-db  Session verification & routing
aura-db    → PgBouncer → PostgreSQL 18

# Search_path projesiyle bağlantı
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;
Bilgi

RLS ilkelerinin auth.uid(), auth.role(), auth.tenant() öğelerine erişimi vardır. Bu yardımcılar, ağ geçidi tarafından enjekte edilen request.jwt.claims'yi okur; istemci tarafında kurcalanması imkansızdır.

Altı yerel yetenek#

  • Proje başına şema. PostgreSQL tarafından uygulanan bölümleme: tenant_id sütunu yok, proje başına bir bağlantı rolü, haklar hiçbir zaman KAMU'ya açılmadı.
  • Sürümlendirilmiş geçişler. Sürümlendirilmiş SQL, atomik geri alma, sıfır kesinti süresi. TypeScript türleri her geçişte yeniden oluşturulur.
  • Kodlayıcı TypeScript & Rust. Canlı şemanızdan tablolar, görünümler, numaralandırmalar ve RPC işlevleri için türlerin otomatik olarak oluşturulması.
  • Yerel RLS. Test edilebilir bildirim politikaları. SDK, talep kiracısını her bağlantıya ekler.
  • İzin verilenler listesindeki uzantılar. Bir proje oluşturulduğunda platform tarafından yüklenen 14 uzantı: pgvector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql, pg_stat_statements, citext, hstore, ltree, unaccent, btree_gin, btree_gist, fuzzystrmatch, intarray.
  • Veritabanı dalları. aura branch create bir projeyi (şema, ilkeler, işlevler, tetikleyiciler, görünümler ve satırlar) kendi URL'si ve anahtarları olan yeni bir projeye kopyalar ve yaşam süresi dolduktan sonra otomatik olarak silinir. Canlı bir kopya değil, oluşturma sırasında oluşturulan bir kopya.

CRUD tamamlandı, yazıldı#

Dört temel işlem aynı .from(table)yüzeyini paylaşır. Döndürülen türler şemanızdan çıkarılır; IDE'nizi açın, otomatik tamamlama sütunlar, birleştirmeler ve dönüşler üzerinde çalışır.

queries.tstypescript
// Son 50 aktif sensörü listeleyin
const { data, error } = await aura
  .from('sensors')
  .select('id, name, temperature, location!inner(city)')
  .eq('active', true)
  .order('captured_at', { ascending: false })
  .limit(50)
İpucu

Daha karmaşık SQL'e mi ihtiyacınız var? Bir Postgres işlevi oluşturun ve onu aura.rpc('function_name', args) aracılığıyla çağırın. İşlevler tablolarla aynı RLS politikalarından yararlanır.

İzin verilenler listesindeki 14 uzantı hazır#

Her yeni projede hazır, izin verilenler listesindeki 14 uzantı

Platform bunları proje oluşturulduğunda yükler (bir proje rolü CREATE EXTENSION'yi kendi başına çalıştıramaz, dolayısıyla unutulacak bir etkinleştirme adımı yoktur). aura db extensions list veya Studio › Veritabanı › Uzantılar ile yüklü olanların listesi; aura db extensions enable <name> ve POST /v1/db/{project_id}/schema/extensions izin verilen birini yeniden uygular.

Bilgi

postgis, pg_cron, timescaledb, pgmq ve pg_partman standart yönetilen görüntüde paketlenmez. Zamanlanmış iş yükleri için, Cron içindeki bir cron zamanlamasında bir Edge İşlevini tetikleyin. Bu değişiklikten önce oluşturulan bir proje, platform bir sonraki şema güncellemesini çalıştırana kadar yalnızca beş geçmiş uzantıya (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) sahiptir; diğerlerini kendiniz ekleyemezsiniz çünkü bunları yalnızca veritabanı operatörü kurabilir.

Doğrudan bağlanın: psql, Prisma, Drizzle, pg_dump#

Her projenin kendi PostgreSQL oturum açma rolü (proj_xxxxxxxx) ve 5432 numaralı bağlantı noktasında <project-slug>.db.<your-domain> biçiminde bir ana bilgisayarı vardır. Parola talep üzerine verilir ve bir kez gösterilir: platform bunu açık tutmaz, dolayısıyla kaybolan parola değiştirilir, asla kurtarılmaz.

connect.shbash
# Bağlantılı projenin ana bilgisayarı, bağlantı noktası, veritabanı ve rolü (şifre yok)
aura db connection

# Bir parola verin ve tüm bağlantı dizesini yazdırın (önceki parolayı iptal eder)
aura db connection --new-password

# Üzerinde psql'yi açın (psql şifreyi sorar)
aura connect

aura db connection --new-password herhangi bir yere yapıştırabileceğiniz bir dize yazdırır:

bağlantı dizesitext
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require

Aynı kart Studio › Ayarlar › Bağlantı › Veritabanı (Şifre oluştur / Şifreyi sıfırla) içinde mevcuttur.

  • TLS gerekli. Uç nokta düz metin bağlantılarını reddeder (sslmode=require). Yerel bir k3d yığınında sertifika kendinden imzalıdır (*.db.localhost), dolayısıyla sslmode=verify-full tasarım gereği burada başarısız olur; üretim *.db.<your-domain> için verilen bir sertifikayı kullanıyor.
  • Projenizle sınırlıdır. Yönlendirici, veritabanınızı rol adından seçer ve onu zorlar: başka bir veritabanı adı istemek hâlâ sizin adınıza kalır ve rolünüzü başka bir projenin ana bilgisayarında sunmak reddedilir. Rolünüz bir süper kullanıcı değil ve RLS'yi atlamaz; Taşıma işlemini tablo sahibi olarak çalıştırmak için BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT; kullanın.
  • Burada oluşturduğunuz tablolar platforma özeldir. Satır Düzeyinde Güvenlik, bu bağlantı üzerinden oluşturulan bir tablo için otomatik olarak açılamaz (bu, yönetilen bir projenin hiçbir zaman göstermediği bir PostgreSQL süper kullanıcı gerektirir), dolayısıyla genel anahtarlar bu tablo üzerinde hiçbir ayrıcalığa sahip olmaz: REST API, permission denied'yi anon anahtarına ve oturum açmış kullanıcılara yanıtlarken, service_role anahtarı, Studio ve kendi rolünüz bunu okuyup yazar. SDK'ya sunmak için RLS etkinleştirin, verin ve ardından bir politika ekleyin (bkz. Satır Düzeyinde Güvenlik): ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST, NOTIFY pgrst, 'reload schema' komutunu çalıştırdığınızda yeni tabloyu öğrenir. Bu kural mevcut olmadan önce bu bağlantı üzerinden oluşturulan tablolar, zaten etkinleştirilmiş RLS olmadığı sürece, bir sonraki parola (aura db connection --new-password) verdiğinizde kapatılır.
  • İşlem havuzlayıcısı. Bağlantılar işlem modunda PgBouncer üzerinden gider. Oturum durumu bir işlemden diğerine geçmez: bir işlem içinde SET LOCAL kullanın ve adlandırılmış hazırlanmış ifadelerin, LISTEN ve oturum düzeyindeki danışma kilitlerinin güvenilir olmamasını bekleyin (Prisma: URL'ye pgbouncer=true ekleyin).
  • İstemci sürümü. pg_dump kendisinden daha yeni bir sunucuyu reddeder: PostgreSQL 18 istemcisi (pg_dump --version) kullanın.
Bilgi

Doğrudan erişim, PostgreSQL bağlantı noktasını yayınlayan dağıtıma bağlıdır. Yerel k3d yığını ve Helm değerlerinin etkinleştirdiği dağıtımlar için açıktır (ingress.tcp.enabled ingress-nginx'in arkasında veya pgproxy.nodePort); Studio ve aura db connection bunun ne zaman olmadığını size söyler.

Daha ileri gitmek için#