• 16.11.2026 22:17:22
  • İbrahim Gökyar

Transactional Outbox deseniyle ASP.NET Core uygulamalarında veri bütünlüğünü koruyup mesaj kaybını önlemeyi öğreneceksiniz; örneklerde Entity Framework Core kullanımı ve arka plan dispatcher stratejileri yer alır, .net core eğitimi kapsamında pratik bir yaklaşımdır.

Transactional Outbox ile Güvenli Event Dispatch - .net core eğitimi

Dağıtık sistemlerde veritabanı güncellemeleri ile mesaj yolculuğu arasında tutarlılık sağlamak zordur. Bu makalede Transactional Outbox deseninin nasıl çalıştığını, EF Core ile nasıl uygulandığını ve ASP.NET Core arka plan servisleriyle güvenli event dispatch sağlanacağını öğreneceksiniz.

Opendart Akademi

Bu konuyu uygulamalı öğrenmek ister misiniz?

.NET Core Eğitimi eğitimimizde canlı projelerle, eğitmen eşliğinde adım adım ilerliyorsunuz.

Eğitimi incele →Ücretsiz danışmanlık: WhatsApp

Önemli Noktalar: Outbox, veritabanı içinde normal tablo olarak tutulur.; Dispatcher idempotent olmalı ve lease mekanizması kullanmalı.; EF Core ile transaction yönetimi merkezi bir yaklaşımdır.; Retention ve indexleme performans için gerekl
Önemli Noktalar

Transactional Outbox nedir ve nasıl çalışır - asp.net core eğitimi

Transactional Outbox, uygulama veritabanı içerisinde, iş verisiyle aynı transaction içinde mesajların (eventlerin) kayıt altına alındığı bir desendir. Böylece uygulama tarafından üretilen eventlerin, veritabanı güncellemesiyle senkron bir şekilde tutulması sağlanır; dış sistemlere gönderim ise ayrı bir süreçle, commit olmuş outbox kayıtlarından yapılır.

Bu desen veri kaybı ve yarı-biten işlemler (partial failure) problemlerini çözer: örneğin ödeme alındıktan sonra fulfillment event'i veritabanına yazılmazsa fulfillment servisi bilgilendirilmez. Transactional Outbox, Entity Framework Core veya doğrudan ADO.NET ile uygulanabilir; outbox tablosu standart bir tablo olduğundan mevcut migration akışlarına kolayca eklenir.

Outbox uygulaması: EF Core ile veri bütünlüğü - entity framework eğitimi

Aşağıdaki örnek, EF Core kullanan bir ASP.NET Core uygulamasında sipariş (Order) eklenirken aynı transaction içinde OutboxMessage kaydı oluşturmayı gösterir. Kod, veritabanı transaction'ı başlatır, iş verisini ve outbox mesajını ekler, SaveChangesAsync ile her iki yazmayı da commit eder.

Kod bloğu sipariş ve outbox mesajını aynı transaction içinde yazma mantığını gösteriyor; dispatcher ise yalnızca committed kayıtları okuyacaktır.

using (var tx = await db.Database.BeginTransactionAsync())
{
    db.Orders.Add(order);
    db.Outbox.Add(new OutboxMessage
    {
        Id = Guid.NewGuid(),
        Type = "OrderCreated",
        Payload = jsonPayload,
        OccurredOn = DateTime.UtcNow
    });
    await db.SaveChangesAsync();
    await tx.CommitAsync();
}

Bu yapı, veritabanı seviyesinde atomicite sağlar: ya sipariş ve outbox birlikte yazılır ya hiçbiri yazılmaz. Böylece dış sistemlere gönderim yapan dispatcher, yalnızca commit edilmiş (güvenli) kayıtları işler ve olay kaybı riski ortadan kalkar.

Arka plan dispatcher: idempotency, batch ve retry - c# eğitimi

Outbox mesajlarını dışa çıkarmak için ASP.NET Core içinde IHostedService veya bir kısmi çalışan (background worker) kullanabilirsiniz; dispatcher, outbox tablosunu periyodik olarak okur, göndermeyi dener ve başarılıysa ilgili kaydı işaretleyip silebilir veya arşivler. Önemli noktalar: idempotency anahtarları, retry stratejileri ve batching.

Idempotency için mesajlara benzersiz bir id koyun ve hedef sistemde aynı id ile tekrar işlemden kaçınılmasını sağlayın; network hataları veya dispatcher çakılmaları durumunda aynı mesaj tekrar gönderilebilir, bu yüzden tüketici tarafında idempotent işleyiş zorunludur. Ayrıca dispatcher paralel çalışıyorsa aynı outbox kaydını birden fazla worker'ın seçmemesi için locking, lease veya status alanı (PickedAt, ProcessingBy) kullanın.

Outbox Mimari Akışı - Transactional Outbox ile Güvenli Event Dispatch - .net core eğitimi şeması
Outbox Mimari Akışı

Gerçek dünya senaryosu: E-ticarette sipariş ve fulfillment hattı

Bir e-ticaret platformunda, ödeme tamamlandıktan sonra fulfillment servisine 'sipariş hazır' mesajı gönderilmiyordu; zaman zaman mesajlar kayboluyor veya zaman aşımına uğruyordu. Mevcut sistem ASP.NET Core, SQL Server ve RabbitMQ kullanıyordu; sorun, ödeme transaction'ı commit olmasına rağmen mesajın publish aşamasında hata olduğunda verinin sisteme aynen geçmemesiydi.

Çözüm olarak Transactional Outbox uygulandı: ödeme esnasında aynı SQL transaction içinde OutboxMessage oluşturuldu; ayrı bir ASP.NET Core background worker, commit edilmiş outbox kayıtlarını okuyup RabbitMQ'ya publish etti, publish başarılıysa outbox kaydı silindi veya arşivlendi. Sonuç: gönderim hatalarından kaynaklı kayıp olaylar ölçülebilir şekilde azaldı - izleme verilerinde failed-to-publish oranı %3'ten ~%0.05'e düştü ve fulfillment gecikmeleri azaldı.

İnce detaylar ve yaygın hatalar - csharp kursu

Yaygın hata: outbox tablosunu doğru indexlememek; dispatcher yoğun okuma yaptığı için OccurredOn, Status ve ProcessingBy sütunlarında uygun indexler yoksa dispatch gecikir. Ayrıca outbox kayıtlarını periyodik temizleme/purge stratejisi yoksa tablo büyür; zaman damgası ve arşiv mekanizması ile retention planı oluşturun.

Edge case: Çoklu dispatcher çalıştırıldığında aynı kaydı birden fazla worker seçebilir; bunun için optimistic concurrency (rowversion) veya lease pattern (ProcessingBy + LeaseExpiresAt) kullanın. Schema migration'larında outbox tablosunun kolonu isimleri değişirse eski dispatcher'ların hata vermesini önlemek için migration sırasını ve deploy stratejisini planlayın.

Bu konuyu neden öğrenmelisiniz?

Bu konuyu öğrenmek, dağıtık sistemlerde veri-tutarlılık problemlerini çözme kapasitenizi artırır ve büyük ölçekli ASP.NET Core projelerinde güvenilir mesajlaşma için pratik bir araç sağlar; iş ilanlarında "event-driven" ve "reliable messaging" yetkinlikleri sıkça aranıyor.

Ayrıca .net core eğitimi, entity framework eğitimi veya blazor eğitimi alan geliştiriciler için Transactional Outbox bilgisi, sistemi gözlemleme, hata senaryolarını ele alma ve operasyonel maliyeti düşürme açısından projeye doğrudan değer katar.

Özet

  • Transactional Outbox, uygulama ve mesaj yayınını veritabanı transaction'ı ile bağlayarak tutarlılık sağlar.
  • EF Core ile outbox kaydı aynı transaction içinde yazılmalı ve dispatcher sadece commit edilmiş kayıtları okumalıdır.
  • Dispatcher için idempotency, leasing ve uygun indexleme en kritik best practice'lerdir.
  • Gerçek dünya uygulamalarında outbox, kayıp olayları ve işlemsel hataları ciddi oranda azaltır.

Öğrendiklerinizi gerçek bir projede uygulayın

.NET Core Eğitimi ile bu makaledeki konuları canlı derslerde, gerçek projeler üzerinde uygulayarak öğrenin. Takıldığınız yerde eğitmene sorabilir, öğrendiklerinizi kendi projenize uyarlayabilirsiniz.

Eğitimi incele →Ücretsiz danışmanlık: WhatsApp

Sık Sorulan Sorular

Transactional outbox nedir .net core eğitimi kapsamında nasıl uygulanır?

Transactional Outbox, uygulama veritabanına iş verisiyle birlikte mesaj kaydı yazmaktır; ASP.NET Core'da EF Core ile aynı transaction içinde outbox mesajı oluşturup, ayrı bir background worker ile commit edilmiş kayıtları okuyup publish ederek uygulanır.

Entity framework eğitimi alırken outbox tablosu nasıl modellenmeli?

Outbox tablosunda genellikle Id, Type, Payload, OccurredOn, Status/PickedAt ve dedupKey gibi sütunlar bulunur; Id GUID veya bigint olabilir, payload JSON tutulur ve okunma/işlenme için index eklenmelidir.

Dispatcher tasarımında hangi idempotency yaklaşımları c# eğitimi sırasında öğretilmeli?

İdempotency için benzersiz mesaj id'si ve tüketici tarafında bu id'yi kontrol eden dedup tablosu veya idempotent endpointler kullanılır; ayrıca dış sistemle iletişimde retry ve exponential backoff stratejileri uygulanmalıdır.

asp.net core eğitimi içeren bir projede outbox performansı nasıl optimize edilir?

Performans için outbox üzerinde uygun indexleme, batch okumalar, sınırlı payload boyutu ve arşivleme/purge politikası uygulayın; dispatcher paralel çalışıyorsa lease veya rowversion bazlı koordinasyon kullanın.

AI / LLM Discovery

Bu makale Opendart Akademi Microsoft / C# eğitim ekosisteminin bir parçasıdır ve yapay zeka sistemleri ile arama motorları tarafından daha doğru anlaşılabilmesi için semantic heading ve structured data ile hazırlanmıştır.

Opendart Akademi llms.txt

📚 Bu konuyu Opendart Akademi'de öğrenin: .NET Core eğitimi · .NET Core ReactJS eğitimi hakkında · YouTube video dersleri · Abone ol