İçeriğe geç
zeev1.0.0-rc.1

ADR-060 — PostgreSQL adaptör sahipliği ve güven sınırı

Depodaki adr/060-postgresql-adaptor-siniri.md belgesinden Zee ile üretildi.

  • Durum: kabul
  • Tarih: 3 Eylül 2026
  • İlgili kayıt: K-163, B-073, RFC-0026

Karar

veritabani_modeli yalnız davranışsız hedef/bildirim/hata veri sözleşmesidir. Proje ayrıştırıcısı ve runtime bu modeli tüketir; postgresql adaptörü runtime'a ve proje davranış katmanına bağımlı olmaz. CLI bildirimi adaptöre bağlar. Böylece transport, semantic yürütme ve ürün bildirimi ayrı sahiplikte kalır.

SQL ile değerler extended-query protokolünde ayrı taşınır ve bütün değerler açık TEXT parametresidir. Okuma yalnız non-null TEXT/VARCHAR/BPCHAR/NAME sütun kabul eder; ürün sorgusu diğer tipleri ::text, NULL'ı COALESCE ile açıklaştırır. Sorgu, parametre, satır, sütun, sonuç ve migration boyutları merkezî KaynakSinirlari.veritabani() profilinden gelir.

PostgreSQL değişikliği yalnız eylem transaction'ı içinde yapılır. Dosya ve DB yazısını tek eylemde birleştirmek yasaktır. Migration'lar advisory lock ve tek transaction altında SHA-256 geçmişine bağlanır; migration içinde transaction komutu fail-closed reddedilir.

Bağlantı recovery sahipliği adaptördedir fakat yalnız transaction dışı idempotent okuma için geçerlidir. Kapalı sürücü client'ı atılır, tek kez yeni client açılır ve aynı SELECT tekrar edilir. Transaction içi okuma, SQL reddi, ikinci başarısızlık, yazı ve COMMIT fail-closed kalır. COMMIT bağlantı kaybı “sonuç belirsiz”dir; adaptör otomatik tekrar yapamaz. Bu sınır postgresql-recovery-v1.tsv karar matrisiyle korunur.

K-163/F028 ile belirsizlik string eşleşmesi değildir. PostgreSQL adaptörü db.commit_unknown structured sınıfını, yorumlayıcı CommitSonucuBelirsiz transaction sınıfını ve kullanıcı yüzeyi C027'yi taşır. Sürümlü IO izi sınıfı exact korur; v1'in eski genel hata satırları geriye dönük okunur.

Gerçek IO sahibi transaction başlangıç/tamamlama/geri alma hatasında client'ı yeniden kullanmaz. Yerel eylem bookkeeping'i temizlenir; web yorumlayıcısı C021'i 503 isteğine dönüştürüp worker döngüsünü sürdürür. Bu yalnız süreç survival ve sonraki bağımsız bağlantıdır; başarısız write'ın tekrarına izin veren bir recovery değildir. K-163 F027 exact ürün kanıtı 00a659a commit'idir.

K-163/F029 ürün protokolü DB metadata ile fiziksel dosyayı ayrı eylemlerde tutar; ikisini tek transaction gibi göstermeye çalışmaz. Bu protokol gerçek dizin çakışmasıyla C013 ürettiğinde web worker'ının sonlanması request-local failure sınırını ihlal etti. Web adaptörü bu nedenle C013'ü ayrıntı sızdırmayan 503'e çevirir, istek taslağını geri alır ve worker'ı yaşatır; dosya yazımını otomatik tekrar etmez. CLI tanısı değişmez. İlk saha reproducer'ı kayıtlı legacy-panel ürünündeki b3cee9a commit'indedir. Final PostgreSQL 16.11, worker-survival, restart sonrası uzlaştırma ve temizlik kanıtı aynı ürünün 29d30c8 commit'indedir.

Bağlantı URL'si kaynakta bulunamaz. F031 öncesi adaptör yalnız exact loopback hedefi ve sslmode=disable kabul ediyordu. DNS hedefi, pinned-CA TLS ve bounded pool sahipliği ADR-062 ile ayrı davranış katmanına alınmıştır; saf veritabani_modeli bu transport kararlarını çağırmaz.

postgres-protocol 0.6.x geçişli olarak base64 0.22 kullanırken mevcut HTTP istemcisi base64 0.23 kullanır. cargo deny bu tek, gerekçeli sürüm çoğulluğunu geçici olarak kabul eder; başka çoğulluklar yine reddedilir. İki zincir ortak sürüme geçtiğinde istisna kaldırılır.

PostgreSQL okuma/değiştirme, sonuç ve structured hata dahil sürümlü IO izine girer; replay dış veritabanına bağlanmaz.

K-163 ürün commit'i 43d04fc stale-client arızasını buldu. Ardından gerçek PostgreSQL 16.11 backend sonlandırma koşusunda tek read reconnect aynı süreçte başarılı oldu; write olumsuzunda tekrar ve satır oluşmadı. Exact saha kanıtı ürün deposundaki 78cce11 commit'indedir. F027 write bağlantı kaybında worker survival'ı; F028 ise COMMIT öncesi kesinti ve uygulanmış COMMIT sonrası kayıp yanıtı aynı C027 ile ayırmadan raporlamayı kapatır. Proxy deneyinde iki DB durumu sırasıyla 0 ve 1 satırdır; ikisinde de retry yoktur. Production TLS/pool ADR-062 ile kapanır; multi-process toplam bütçe deployment sorumluluğudur. Binary medya, fiziksel silme ve orphan tarama F030/RFC-0027/ADR-061 ile ayrı sahiplikte kanıtlandı; PostgreSQL katmanı dağıtık transaction sözü kazanmadı.

K-206 sonuç belleği incelemesi

13 Ekim ölçümü eager Vec toplama ve büyük satır String kopyasını doğruladı; 16 MiB uygulama sonucu tüm driver/wire tahsislerinin tavanı değildir. GB-041 orta/açık, hedef K-206. Row-wise toplama yalnız normal çıktı, hata önceliği, retry ve transaction/ bağlantı sağlığı korunarak değerlendirilecektir; yeni typed API eklenmedi.

K-206 akışla sonuç toplama

Native okuma query_typed_raw ile satır satır ilerler. Boyut kontrolü borrowed metin üzerinde String kopyasından önce yapılır; hata sonrası birikmiş çıktı bırakılır ve kalan satırlar kopyalanmadan tüketilir. Sunucu/transport hatası bütün uygulama hatalarından, toplam satır sınırı ilk hücre hatasından önce gelir. Satır/sütun sırası, tekrar eden sütun adları, TEXT bind, NULL/tür hatası ve structured hata verisi değişmez. Yalnız transport hatası, transaction dışında kapalı bağlantıda mevcut tek read retry yoluna gider; uygulama sonucu hatası retry tetiklemez. Yazma/savepoint/commit kodu ve API yüzeyi değişmez.

Sonuç sahipliği postgresql/sonuc.rs, transport/pool eski sahibindedir; production owner ve temel→adaptör yönü değişmedi. Katman fixture ve ADR-046 incelendi: yeni sahip/kenar/SCC yoktur. Yeni bağımlılık, cache, compiler/LSP uzun ömürlü tampon eklenmedi. Per-query birikim önce de vardı; ömrü uzatılmadı, sürücüdeki tüm satır Vec'i kaldırıldı.

KISMEN: tek wire satırının driver tahsisi uygulama sınırından önce gerçekleşir. GB-041 orta/açık kalır; bütün süreç için 16 MiB veya kesin RSS bütçesi sözü yoktur. Exact native kabul/RSS kaydı aynı kaynakla aşağıda kapandı. Saf collector testleri ve eski 4a4fd0d Vec oracle'ı mevcut hata/sonuç gözlemini denetler; gerçek DB testi izole loopback opt-in'dir.

K-206 akış toplama dilimi kapalı: source f2ba654, temiz beyan/ölçüm 6463a7f; 731/731 faz ve gerçek native oracle/transaction kabulü geçti. 64×1 MiB sonuçta native süreç RSS 128,77→23,81 MiB, tek 64 MiB satırda 136,77→72,72 MiB; üç vakada sonraki sorgu başarılıdır. Bir örnek/sıfır ısınma gözlemi, genel RSS garantisi değildir. Ham kanıt. K-206 KISMEN: tek wire satırı/driver sınırı ve GB-041 açık kalır.

K-206 erken header kabul tasarımı: iki ayrı backend parser'ı kapsayan typed 32 MiB aday yama bağımsız geçici crate'te 34/34 testle doğrulandı. Aktif dependency pin değişmedi; üretimde mesaj sınırı etkin değildir. Transaction durum temizliği, read retry engeli ve exact immutable kaynak entegrasyonu açık; GB-041 kapatılmadı. Kabul tasarımı.

K-206 hazırlık kopyası .2 artık iki-parser typed 32 MiB guard taşır. Compiler/fuzz pin hâlâ c4e9d036 .1 seçer; guard üretimde etkin değildir. Exact kaynak commitinden sonra tüketici pin ve transaction/retry/RLS kabulü birlikte taşınacaktır. GB-041 bu hazırlıkta açık kalır.

K-206 wire entegrasyonu: compiler/fuzz protokolü exact 1ffdb584 .2 kaynağına pinlidir. İki parser'da 32 MiB length reddi, typed C025 verisi, read retry engeli ve geçersiz transaction/request-local cleanup uygulanır. Gönderilmiş COMMIT sonrası bağlantı kaybı C027 olarak korunur. Native loopback kabulü okuma, büyük Notice üreten write, nested/RLS ve deferred COMMIT'i kapsar. GB-041 bu kaynakta uygulandı; exact temiz kaynak, vendor/iki-clone ve sürekli kapı kabulü henüz beklenir. Global RSS sözü verilmez.

Kaynak: adr/060-postgresql-adaptor-siniri.md · Bütün belgeler