{"id":170,"date":"2026-11-06T17:53:00","date_gmt":"2026-11-06T17:53:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=170"},"modified":"2026-11-06T17:53:00","modified_gmt":"2026-11-06T17:53:00","slug":"event-schema-evolution-compatibility","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/11\/06\/event-schema-evolution-compatibility\/","title":{"rendered":"Event \u015eemas\u0131 De\u011fi\u015fince Consumer&#8217;lar Neden K\u0131r\u0131l\u0131yor?"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Sipari\u015f servisi <code>OrderPlaced<\/code> event&#8217;i yay\u0131nl\u0131yor. Fatura, stok ve bildirim servisleri bu event&#8217;i dinliyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sipari\u015f ekibi bir refactoring yap\u0131yor. <code>amount<\/code> alan\u0131n\u0131n ad\u0131n\u0131 <code>totalAmount<\/code> olarak de\u011fi\u015ftiriyor. Daha a\u00e7\u0131klay\u0131c\u0131.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Deploy ediyorlar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Fatura servisi her event&#8217;te <code>null<\/code> tutar ile fatura olu\u015fturmaya ba\u015fl\u0131yor. Bildirim servisi exception f\u0131rlat\u0131p mesajlar\u0131 tekrar denemeye ba\u015fl\u0131yor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sipari\u015f ekibinin kendi testleri ise ye\u015fil.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Event&#8217;ler bir API s\u00f6zle\u015fmesidir<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">REST API&#8217;lerde breaking change kavram\u0131 art\u0131k olduk\u00e7a iyi anla\u015f\u0131l\u0131yor. Ama event&#8217;ler genellikle ayn\u0131 \u00f6zenle ele al\u0131nm\u0131yor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Oysa yay\u0131nlanan bir event de bir s\u00f6zle\u015fme. \u00dcstelik REST&#8217;ten daha zor y\u00f6netilen bir s\u00f6zle\u015fme. \u00c7\u00fcnk\u00fc yay\u0131nc\u0131, event&#8217;i kimlerin dinledi\u011fini her zaman bilmez.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir de zaman boyutu var. Kafka gibi sistemlerde event&#8217;ler g\u00fcnlerce, bazen y\u0131llarca saklan\u0131r. Yeni bir consumer, aylar \u00f6nce yaz\u0131lm\u0131\u015f event&#8217;leri de okuyabilir. Event \u015femas\u0131 de\u011fi\u015fti\u011finde, eski ve yeni formattaki event&#8217;ler ayn\u0131 topic&#8217;te yan yana durur.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Uyumluluk y\u00f6nleri<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Geriye uyumluluk (backward):<\/strong> Yeni \u015femay\u0131 kullanan consumer, eski \u015femayla yaz\u0131lm\u0131\u015f event&#8217;leri okuyabilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u0130leriye uyumluluk (forward):<\/strong> Eski \u015femay\u0131 kullanan consumer, yeni \u015femayla yaz\u0131lm\u0131\u015f event&#8217;leri okuyabilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tam uyumluluk (full):<\/strong> \u0130kisi birden.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Producer ve consumer&#8217;lar farkl\u0131 zamanlarda deploy edildi\u011fi i\u00e7in, genellikle her iki y\u00f6nde de uyumluluk gerekir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">G\u00fcvenli de\u011fi\u015fiklikler<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Pratikte uyumlulu\u011fu koruyan de\u011fi\u015fiklikler s\u0131n\u0131rl\u0131:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Varsay\u0131lan de\u011feri olan yeni bir opsiyonel alan eklemek<\/li>\n\n\n<li>Opsiyonel bir alan\u0131 kald\u0131rmak, consumer&#8217;lar ona ba\u011f\u0131ml\u0131 de\u011filse<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Uyumlulu\u011fu bozan de\u011fi\u015fiklikler:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Bir alan\u0131 yeniden adland\u0131rmak<\/li>\n\n\n<li>Bir alan\u0131n tipini de\u011fi\u015ftirmek<\/li>\n\n\n<li>Zorunlu yeni bir alan eklemek<\/li>\n\n\n<li>Bir alan\u0131n anlam\u0131n\u0131 de\u011fi\u015ftirmek<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Son madde \u00f6zellikle sinsi. <code>amount<\/code> alan\u0131 \u00f6nceden KDV hari\u00e7 tutar\u0131 tutuyordu, art\u0131k KDV dahil tutar\u0131 tutuyor. \u015eema ayn\u0131, tip ayn\u0131, hi\u00e7bir kontrol hatay\u0131 yakalamaz. Ama b\u00fct\u00fcn consumer&#8217;lar\u0131n hesaplar\u0131 yanl\u0131\u015f.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Schema registry<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Confluent Schema Registry veya Apicurio gibi ara\u00e7lar, event \u015femalar\u0131n\u0131 merkezi bir yerde tutar ve yeni bir \u015fema versiyonu kaydedilirken uyumluluk kurallar\u0131n\u0131 kontrol eder.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Avro, Protobuf veya JSON Schema ile tan\u0131mlanan bir \u015fema, uyumlulu\u011fu bozan bir de\u011fi\u015fiklik i\u00e7eriyorsa kay\u0131t reddedilir. Producer, uyumsuz bir event&#8217;i yay\u0131nlamaya ba\u015flamadan \u00f6nce hata al\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Avro ve Protobuf&#8217;un ikili formatlar\u0131 ayr\u0131ca alan adlar\u0131n\u0131 her mesajda ta\u015f\u0131mad\u0131\u011f\u0131 i\u00e7in daha k\u00fc\u00e7\u00fck mesajlar \u00fcretir. Ama JSON kadar okunabilir de\u011fildir ve ara\u00e7 deste\u011fi gerektirir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">K\u0131r\u0131c\u0131 de\u011fi\u015fiklik gerekti\u011finde<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bazen bir event&#8217;in yap\u0131s\u0131 ger\u00e7ekten de\u011fi\u015fmelidir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bu durumda mevcut event&#8217;i de\u011fi\u015ftirmek yerine yeni bir event tipi veya yeni bir topic olu\u015fturmak daha g\u00fcvenli:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>orders.order-placed.v1\norders.order-placed.v2<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Producer bir s\u00fcre her iki versiyonu da yay\u0131nlar. Consumer&#8217;lar kendi h\u0131zlar\u0131nda yeni versiyona ge\u00e7er. Eski versiyonu dinleyen kalmad\u0131\u011f\u0131nda, yay\u0131nlanmas\u0131 durdurulur.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">API versiyonlamadaki expand and contract yakla\u015f\u0131m\u0131n\u0131n event d\u00fcnyas\u0131ndaki kar\u015f\u0131l\u0131\u011f\u0131.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tolerant reader<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Consumer taraf\u0131nda da sorumluluk var. Bilmedi\u011fi alanlar\u0131 g\u00f6rmezden gelmek, opsiyonel alanlar\u0131n yoklu\u011funu tolere etmek ve enum&#8217;larda bilinmeyen de\u011ferlerle ba\u015fa \u00e7\u0131kabilmek, \u015fema evrimini \u00e7ok daha kolay hale getirir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Event&#8217;ler servisler aras\u0131ndaki ba\u011f\u0131ml\u0131l\u0131\u011f\u0131 azaltmak i\u00e7in kullan\u0131l\u0131yor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ama \u015femalar\u0131 dikkatsizce de\u011fi\u015ftirildi\u011finde, servisleri senkron API \u00e7a\u011fr\u0131lar\u0131ndan bile daha s\u0131k\u0131 ve daha g\u00f6r\u00fcnmez \u015fekilde birbirine ba\u011fl\u0131yor.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Producer bir alan\u0131 yeniden adland\u0131rd\u0131 ve \u00fc\u00e7 ekibin consumer&#8217;\u0131 ayn\u0131 anda hata vermeye ba\u015flad\u0131. Event \u015femalar\u0131nda geriye ve ileriye uyumluluk, schema registry ve versiyonlama.<\/p>\n","protected":false},"author":1,"featured_media":169,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[],"class_list":["post-170","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dagitik-sistemler"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/170","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/comments?post=170"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/170\/revisions"}],"predecessor-version":[{"id":227,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/170\/revisions\/227"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/169"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=170"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=170"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=170"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}