Porozmawiajmy o Twojej firmie

EventSourcingDB 1.3.0: nowe API v2, szybsze zapisy i twarde limity — co to oznacza dla firm na event sourcingu

EventSourcingDB 1.3.0: nowe API v2, szybsze zapisy i twarde limity — co to oznacza dla firm na event sourcingu

EventSourcingDB 1.3.0 jest dostępny i według producenta szybszy oraz stabilniejszy niż wcześniejsze wydania. Wersja przynosi nowe API v2 działające równolegle z v1 na tych samych danych, szybsze zapisy i zapytania EventQL, twarde limity czasu dla żądań i połączeń, domyślnie włączony rate limiting oraz health endpoint mówiący w OpenMetrics. Zmiany dotyczą przede wszystkim zespołów, które utrzymują EventSourcingDB w produkcji albo planują wdrożenie event sourcingu i oceniają koszt utrzymania infrastruktury.

Waga tego wydania nie leży w samych deklaracjach wydajnościowych, których nie da się zweryfikować bez własnych testów, ale w twardych terminach i nieodwracalnych zmianach formatu danych. API v1 jest wspierane do 31 stycznia 2027 roku, a późniejsze wydanie je usuwa. Katalog danych otwarty przez wersję 1.3 nie da się już otworzyć starszą wersją, więc backup przed aktualizacją jest jedyną drogą powrotu. Do tego dochodzi nowa wersja hasha zdarzenia, która sprawia, że starsze SDK raportują zdarzenia zapisane po aktualizacji jako naruszone. To nie jest zwykła aktualizacja do przełknięcia w piątek po południu.

Co dokładnie się zmieniło

Materiał źródłowy to wpis na blogu producenta, opublikowany 11 listopada 2026 roku, autorstwa Golo Rodena, CTO i założyciela the native web. Poniżej rozdzielam deklaracje producenta od tego, co z nich wynika operacyjnie. Nie mam dostępu do niezależnych testów porównawczych, więc wszelkie liczby dotyczące przyspieszenia pozostają deklaracjami dostawcy.

Deklaracje producenta

  • Zapisy są znacznie szybsze, zarówno dla jednego klienta, jak i dla wielu jednocześnie, i nie zwalniają wraz ze wzrostem magazynu.
  • Zapytania EventQL są znacznie szybsze, zwłaszcza te czytające wiele zdarzeń, grupujące, sortujące i łączące kilka źródeł.
  • Odczyt zdarzeń jest szybszy, a indeksy zajmują znacznie mniej plików.
  • W wydaniu znalazło się ponad sześćdziesiąt poprawek.
  • Odtwarzanie backupu jest szybsze, bo zdarzenia zapisywane są w partiach.
  • Weryfikacja integralności raportuje wszystkie niespójności, do stu, a nie tylko pierwszą.

Zmiany, które trzeba zaplanować

  • API v2 działa obok v1 na tych samych danych, ale v1 zniknie po 31 stycznia 2027 roku.
  • Proxy przed bazą musi przepuszczać metodę HTTP QUERY, której v2 używa do odczytu.
  • Token API musi mieć co najmniej 32 znaki i być drukowalnym ASCII bez białych znaków na początku i końcu, inaczej serwer odmówi startu.
  • Obraz Dockera działa jako inny użytkownik, UID 65532 zamiast 100, więc katalog danych zapisany przez starszy obraz trzeba jednorazowo przekazać nowemu użytkownikowi.
  • Flagi --ai-model i --ai-option zostały usunięte; serwer uruchomiony z nimi nie wystartuje.
  • Pierwsze uruchomienie przebudowuje indeksy: serwer od razu obsługuje odczyt i zapis, ale odmawia zapytań EventQL i części innych żądań do zakończenia przebudowy, co może potrwać kilka minut.
  • Zmienia się sposób porównywania wartości różnych typów, ID zdarzenia jest traktowane jako string, a daty i czasy są przyjmowane w UTC, co może zmienić wyniki zapytań i warunków wstępnych.

Tło techniczne bez żargonu

Event sourcing to sposób przechowywania danych, w którym zamiast trzymać aktualny stan obiektu, zapisujemy kolejne zdarzenia, które do tego stanu doprowadziły. Baza zdarzeń pełni rolę dziennika, z którego można odtworzyć stan w dowolnym momencie. EventSourcingDB jest bazą zaprojektowaną właśnie pod taki model, a EventQL to jej język zapytań po zdarzeniach.

API to sposób, w jaki aplikacja rozmawia z bazą. Wersja 1 odpowiadała głównie kodami statusu HTTP, które klient musiał interpretować. Wersja 2 zmienia filozofię: żądanie uznaje się za zaakceptowane, gdy jest uwierzytelnione, ma oczekiwany kształt treści i mieści się w limitach. Wynik zaakceptowanego żądania jest w treści odpowiedzi, a każdy błąd ma własny kod będący linkiem do strony z wyjaśnieniem. Dla zespołu oznacza to mniej zgadywania przy debugowaniu i więcej czytelnych komunikatów, ale też konieczność przepisania obsługi błędów tam, gdzie aplikacja wywołuje HTTP API bezpośrednio.

Metoda HTTP QUERY jest tu istotna, bo v2 używa jej do odczytu. Wiele proxy, load balancerów i reguł WAF domyślnie przepuszcza tylko znane metody, a QUERY do nich nie należy. Jeśli baza stoi za takim urządzeniem, odczyt przez v2 może po prostu nie działać, mimo poprawnie skonfigurowanego klienta.

Odpowiedzi strumieniowe w v2 kończą się jawnym elementem końcowym, więc klient odróżni kompletną odpowiedź od przerwanej. W czasie oczekiwania serwer wysyła heartbeaty, które powstrzymują proxy przed zamknięciem bezczynnego połączenia. To detal, który w praktyce decyduje o stabilności długich odczytów przez infrastrukturę pośredniczącą.

Realne konsekwencje operacyjne

Najważniejsza konsekwencja jest organizacyjna, nie techniczna: macie datę graniczną. 31 stycznia 2027 to termin, po którym v1 znika w kolejnym wydaniu. Nie znaczy to, że baza przestanie działać tego dnia, ale znaczy, że okno migracji jest ograniczone i trzeba je wpisać w plan prac, a nie odkładać na „kiedyś”.

Druga konsekwencja dotyczy nieodwracalności. Katalog danych otwarty przez 1.3 nie wróci do starszej wersji. Backup przed aktualizacją nie jest dobrą praktyką, jest warunkiem koniecznym. Bez niego nie ma drogi wycofania.

Trzecia konsekwencja dotyczy kolejności wdrożenia. Wersje do 1.2 nie blokują katalogu danych, więc wdrożenie, które najpierw uruchamia nowy serwer, na przykład Kubernetes Deployment z RollingUpdate, uruchomi dwa serwery na tych samych danych i może je uszkodzić. Stary serwer trzeba zatrzymać przed startem 1.3.

Czwarta dotyczy hashy. Wersja 1.3 zapisuje nową wersję hasha zdarzenia. Jeśli aplikacje weryfikują hashe, starsze SDK po aktualizacji zgłoszą każde nowo zapisane zdarzenie jako naruszone. To nie awaria bazy, to niezaktualizowany klient. SDK trzeba podnieść przed aktualizacją serwera albo w tym samym oknie wdrożeniowym.

Piąta dotyczy zachowania przy awarii zapisu. Jeśli zapis się nie powiedzie, na przykład z powodu pełnego dysku, serwer przechodzi w tryb read-only do restartu, dalej obsługuje odczyty, raportuje to przez health endpoint i podaje przyczynę w logu. To dobre zachowanie, ale wymaga alertu. Bez monitoringu health endpointu dowiecie się o trybie read-only od użytkowników.

Scenariusze ryzyka

Scenariusz Przyczyna Skutek Jak ograniczyć
Odczyt przez v2 nie działa Proxy nie przepuszcza metody QUERY Aplikacja nie czyta zdarzeń mimo poprawnej konfiguracji Sprawdzić reguły proxy i WAF przed wdrożeniem
Dwa serwery na jednym katalogu RollingUpdate startuje nowy przed zatrzymaniem starego Uszkodzenie danych Zatrzymać stary serwer przed startem 1.3
Fałszywe alarmy o naruszeniu Stare SDK nie znają nowej wersji hasha Zespół traci czas na śledzenie nieistniejącego problemu Zaktualizować SDK przed serwerem
Brak drogi powrotu Brak backupu przed aktualizacją Nie można wrócić do starszej wersji Backup i test odtworzenia przed aktualizacją
Zapisy odrzucane po cichu Tryb read-only po nieudanym zapisie Dane przestają się zapisywać, użytkownicy widzą błędy Alert na health endpoint i log przyczyny
Kontener nie startuje Katalog danych należy do UID 100, obraz działa jako 65532 Brak dostępu do danych Jednorazowo przekazać katalog nowemu użytkownikowi
Serwer nie startuje Token krótszy niż 32 znaki lub z białymi znakami Przestój przy wdrożeniu Sprawdzić token przed aktualizacją
Zapytania EventQL zwracają inne wyniki Zmiany porównywania typów, ID jako string, daty w UTC Błędne raporty lub nieoczekiwane warunki wstępne Przejrzeć zapytania i warunki wstępne, przetestować na kopii

Jak sprawdzić, czy problem dotyczy waszej instalacji

  1. Ustalcie, czy w ogóle używacie EventSourcingDB i w jakiej wersji. Sprawdźcie obraz Dockera lub binarkę oraz changelog wdrożeń.
  2. Sprawdźcie, czy aplikacje łączą się przez SDK, czy bezpośrednio przez HTTP API. Przy SDK wystarczy aktualizacja, przy bezpośrednim wywołaniu trzeba przejść przez przewodnik migracji do v2 trasę po trasie.
  3. Wypiszcie wszystkie elementy infrastruktury między aplikacją a bazą: proxy, load balancery, WAF, service mesh. Dla każdego ustalcie, czy przepuszcza metodę QUERY.
  4. Sprawdźcie długość i format tokenu API. Minimum 32 znaki, drukowalny ASCII, bez białych znaków na krańcach.
  5. Ustalcie, czy któraś aplikacja weryfikuje hashe zdarzeń. Jeśli tak, wypiszcie wersje SDK i zaplanujcie ich podniesienie.
  6. Sprawdźcie, czy w konfiguracji startowej są flagi --ai-model lub --ai-option. Jeśli tak, serwer po aktualizacji nie wystartuje.
  7. Przejrzyjcie zapytania EventQL i warunki wstępne pod kątem porównań różnych typów, użycia ID zdarzenia i obsługi dat. To miejsca, w których wyniki mogą się zmienić.
  8. Sprawdźcie, czy macie monitoring health endpointu i czy zbieracie metryki w formacie OpenMetrics.
  9. Ustalcie, kto i kiedy wykonuje backup oraz czy kiedykolwiek testowaliście odtworzenie z pełnego backupu i przyrostów.
  10. Sprawdźcie, czy katalog danych jest zapisywalny dla UID 65532 w środowisku kontenerowym.

Plan reakcji krok po kroku

Przed aktualizacją

  1. Zatrzymajcie stary serwer. Nie uruchamiajcie 1.3, dopóki stary proces nie zakończy pracy.
  2. Wykonajcie pełny backup i zapiszcie go poza maszyną, na której stoi baza. Sprawdźcie, że backup się otwiera.
  3. Podnieście wersje wszystkich SDK, które weryfikują hashe zdarzeń.
  4. Poprawcie token API, jeśli nie spełnia wymagań.
  5. Usuńcie z konfiguracji flagi --ai-model i --ai-option.
  6. Przekażcie katalog danych użytkownikowi UID 65532, jeśli używacie obrazu Dockera.
  7. Dopasujcie reguły proxy i WAF, aby przepuszczały metodę QUERY.
  8. Przetestujcie aktualizację na kopii danych w środowisku zbliżonym do produkcyjnego, z tym samym proxy i tym samym ruchem.

W trakcie aktualizacji

  1. Uruchomcie 1.3 i obserwujcie logi pierwszego startu. Przebudowa indeksów może potrwać kilka minut, w tym czasie EventQL i część żądań będą odrzucane.
  2. Nie ogłaszajcie zakończenia wdrożenia, dopóki przebudowa się nie skończy i nie potwierdzicie odczytu oraz zapisu.
  3. Sprawdźcie health endpoint i potwierdźcie, że serwer nie jest w trybie read-only.

Po aktualizacji

  1. Uruchomcie testy integracyjne obejmujące zapis, odczyt, zapytania EventQL i warunki wstępne.
  2. Porównajcie wyniki kluczowych zapytań z wynikami sprzed aktualizacji.
  3. Sprawdźcie, czy rate limiting nie odrzuca legalnego ruchu. Jest włączony domyślnie i skaluje się z rozmiarem maszyny.
  4. Ustawcie alerty na tryb read-only, pamięć, deskryptory plików i dostępność health endpointu.
  5. Zaplanujcie migrację z v1 na v2 z datą wcześniejszą niż 31 stycznia 2027, z zapasem na nieprzewidziane problemy.

Typowe błędy

  • Aktualizacja bez backupu. Katalogu otwartego przez 1.3 nie otworzy starsza wersja. Bez backupu nie ma odwrotu.
  • RollingUpdate bez zatrzymania starego serwera. Dwa procesy na jednym katalogu mogą go uszkodzić.
  • Podniesienie serwera przed SDK. Aplikacje zgłoszą nowe zdarzenia jako naruszone i zacznie się fałszywy alarm.
  • Pominięcie proxy. Metoda QUERY bywa nieobsługiwana domyślnie i odczyt przez v2 cicho nie działa.
  • Brak alertu na tryb read-only. Zapis przestaje działać, a zespół dowiaduje się o tym od użytkowników.
  • Traktowanie rate limitingu jako włączonego „na później”. Jest domyślnie aktywny i może odrzucać ruch, jeśli limit nie jest dopasowany do profilu obciążenia.
  • Zignorowanie zmian semantyki EventQL. Porównania typów, ID jako string i daty w UTC mogą zmienić wyniki zapytań.
  • Brak testu odtworzenia backupu. Backup, którego nie odtworzyliście, jest tylko nadzieją.

Działania krótkoterminowe i długoterminowe

Krótkoterminowe, w ciągu najbliższych tygodni

  • Wykonajcie backup i test odtworzenia.
  • Zaktualizujcie SDK i sprawdźcie, czy aplikacje weryfikujące hashe działają poprawnie.
  • Poprawcie token API i usuńcie wycofane flagi.
  • Dopasujcie proxy do metody QUERY.
  • Ustawcie monitoring health endpointu w OpenMetrics i alert na tryb read-only.

Długoterminowe, przed 31 stycznia 2027

  • Przenieście wszystkie bezpośrednie wywołania HTTP API z v1 na v2, trasa po trasie, zgodnie z przewodnikiem migracji.
  • Wprowadźcie do pipeline’u testy kontraktowe obejmujące nowe kody błędów i jawne elementy końcowe strumieni.
  • Przejrzyjcie strategię backupów pod kątem backupów przyrostowych i szybszego odtwarzania.
  • Rozważcie flagę --require-event-schemas, jeśli chcecie odrzucać zapisy zdarzeń bez zarejestrowanego schematu. Jest domyślnie wyłączona.
  • Uporządkujcie procedurę eksportu i importu, jeśli planujecie usuwanie danych osobowych z historii przed przeniesieniem danych.

Checklista przed wdrożeniem 1.3.0

  • ☐ Pełny backup wykonany i przetestowany
  • ☐ Stary serwer zatrzymany przed startem 1.3
  • ☐ SDK zaktualizowane, w tym te weryfikujące hashe
  • ☐ Token API ma co najmniej 32 znaki i poprawny format
  • ☐ Flagi --ai-model i --ai-option usunięte z konfiguracji
  • ☐ Katalog danych przekazany użytkownikowi UID 65532
  • ☐ Proxy i WAF przepuszczają metodę QUERY
  • ☐ Zapytania EventQL i warunki wstępne przejrzane pod kątem zmian semantyki
  • ☐ Health endpoint monitorowany, alert na tryb read-only ustawiony
  • ☐ Plan migracji z v1 na v2 z datą przed 31 stycznia 2027
  • ☐ Test aktualizacji na kopii danych w środowisku zbliżonym do produkcji

Co powinien zrobić właściciel firmy / administrator

Jeśli jesteście na etapie wyboru bazy pod event sourcing, 1.3.0 jest momentem, w którym warto przetestować EventSourcingDB na własnym scenariuszu, a nie tylko na benchmarku dostawcy. Deklaracje przyspieszenia zapisów i EventQL są obiecujące, ale decyzję powinny poprzeć wasze testy na waszych danych i waszym profilu obciążenia.

Jeśli już utrzymujecie tę bazę, priorytetem jest data 31 stycznia 2027 i nieodwracalność formatu danych. Właściciel firmy powinien dopilnować trzech rzeczy: że backup istnieje i został odtworzony, że migracja z v1 na v2 ma właściciela i termin, oraz że monitoring obejmuje tryb read-only i metryki procesu. Administrator powinien przejść checklistę powyżej, ze szczególnym naciskiem na kolejność wdrożenia, metodę QUERY w proxy i wersje SDK.

Osobno warto przejrzeć politykę danych osobowych. Import sam oblicza hashe, co według producenta pozwala wyeksportować historię, usunąć z niej dane osobowe i zaimportować wynik bez ręcznego liczenia hashy. To wygodne, ale wymaga świadomej decyzji, co i na jakiej podstawie usuwacie, oraz sprawdzenia, czy po imporcie integralność historii nadal jest weryfikowalna w sposób, którego oczekujecie.

Na koniec: nie traktujcie tego wydania jako okazji do zmiany wielu rzeczy naraz. Najpierw aktualizacja z backupem i zatrzymaniem starego serwera, potem migracja API, na końcu porządki w backupach i schematach zdarzeń. Każdy z tych kroków da się przetestować osobno, a harmonogram do 31 stycznia 2027 daje na to wystarczająco dużo czasu, pod warunkiem że zaczniecie go odmierzać teraz, a nie w grudniu 2026.

Weryfikacja praktyczna po wdrożeniu 1.3.0

Testy funkcjonalne na realnym ruchu

Po zakończeniu przebudowy indeksów i potwierdzeniu, że serwer nie jest w trybie read-only, uruchomcie testy na ruchu możliwie zbliżonym do produkcyjnego. Nie poprzestawajcie na testach jednostkowych SDK — sprawdźcie pełne ścieżki: zapis zdarzenia, odczyt strumienia, zapytanie EventQL z grupowaniem i sortowaniem oraz warunki wstępne.

  • Wykonajcie zapis serii zdarzeń dla jednego klienta i dla wielu klientów jednocześnie. Producent deklaruje, że zapis nie zwalnia wraz ze wzrostem store — zweryfikujcie to na własnym profilu obciążenia.
  • Uruchomcie zapytania EventQL, które czytają wiele zdarzeń, grupują, sortują lub łączą kilka źródeł. To właśnie te przypadki mają być znacznie szybsze, więc zmierzcie czasy przed i po.
  • Sprawdźcie odczyt zdarzeń podmiotu w dużej bazie — indeksy zajmują teraz znacznie mniej plików, co ma przyspieszać ten scenariusz.
  • Przetestujcie warunki wstępne, w tym rekurencyjne isSubjectPristine, isSubjectPopulated i isSubjectOnEventId zastosowane do podmiotu wraz z całym poddrzewem. Sprawdźcie, czy decyzje oparte na całej gałęzi drzewa działają zgodnie z oczekiwaniami.
  • Zweryfikujcie, że strumieniowane odpowiedzi kończą się jawnym elementem końcowym, a nie urwanym strumieniem. To pozwala klientowi odróżnić kompletną odpowiedź od przerwanej.

Weryfikacja nowego API v2

Nowe API v2 działa obok v1 na tych samych danych. Sprawdźcie, czy każda zaakceptowana odpowiedź zawiera wynik w treści, a nie wyłącznie w kodzie statusu. Zaakceptowane żądanie to takie, które jest uwierzytelnione, ma treść zgodną z oczekiwanym kształtem trasy i mieści się w limitach.

  1. Wywołajcie celowo błędne żądanie — nieznany typ zdarzenia, niespełniony warunek wstępny, baza w trybie read-only — i potwierdźcie, że odpowiedź jest czytelna dla klienta.
  2. Sprawdźcie, czy każdy błąd niesie kod będący linkiem do własnej strony z wyjaśnieniem przyczyny i sposobu naprawy. Przejrzyjcie je pod adresem Errors.
  3. Potwierdźcie, że serwer wysyła heartbeaty przez oczekujący strumień, co ma zapobiegać zamykaniu go przez proxy.
  4. Upewnijcie się, że wszystkie osiem oficjalnych SDK obsługuje oba API i używa v2 tam, gdzie serwer je oferuje. Jeśli nie zmienialiście kodu poza aktualizacją SDK, aplikacje powinny działać bez modyfikacji — pod warunkiem, że proxy przepuszcza metodę QUERY.

Monitoring po wdrożeniu

Health endpoint i metryki OpenMetrics

Health endpoint v2 mówi w formacie OpenMetrics, co pozwala scrapować go bezpośrednio przez Prometheus i podobne narzędzia. Raportuje więcej informacji o procesie, m.in. pamięć i deskryptory plików.

  • Skonfigurujcie scraping health endpointu i zapisujcie metryki w czasie, aby mieć punkt odniesienia dla przyszłych wdrożeń.
  • Ustawcie alert na tryb read-only. Serwer przechodzi w ten tryb, gdy nie uda się zapisać danych — np. przy pełnym dysku — i pozostaje w nim do restartu, nadal obsługując odczyty. Bez alertu zapis przestaje działać, a zespół dowiaduje się o tym od użytkowników.
  • Monitorujcie pamięć i deskryptory plików — to wielkości raportowane przez endpoint, a ich wyczerpanie może zaburzyć pracę serwera.
  • Sprawdźcie, czy log serwera nazywa przyczynę przejścia w tryb read-only. To skraca diagnostykę.

Limity, rate limiting i stabilność pod obciążeniem

Rate limiting jest włączony domyślnie i skaluje się z rozmiarem maszyny. Jeden klient wysyłający zbyt wiele żądań nie powinien przeciążyć bazy — ale legalny ruch też może zostać odrzucony, jeśli limit nie pasuje do profilu obciążenia.

  • Obserwujcie, czy rate limiting nie odrzuca poprawnych żądań w godzinach szczytu.
  • Pamiętajcie, że każde żądanie, każda odpowiedź i każde bezczynne połączenie są ograniczone w czasie — wolny lub zawieszony klient nie powinien trzymać zasobów bez końca.
  • Zapytania EventQL mają limity głębokości zagnieżdżenia i zużycia pamięci. Sprawdźcie, czy wasze najbardziej złożone zapytania mieszczą się w tych granicach.
  • Przejrzyjcie listę limitów w dokumentacji, aby znać wartości progowe przed wystąpieniem incydentu.

Integralność i spójność danych

Weryfikacja integralności store raportuje teraz każdą znalezioną niespójność, do stu, zamiast tylko pierwszej. Wykorzystajcie to w monitoringu okresowym.

  • Zaplanujcie regularne uruchamianie weryfikacji integralności i analizę raportów.
  • Jeśli aplikacje weryfikują hashe zdarzeń, upewnijcie się, że korzystają z aktualnych wersji SDK — inaczej mogą zgłaszać nowe zdarzenia jako naruszone i wywołać fałszywy alarm.

Checklisty operacyjne

Checklista weryfikacji po wdrożeniu

  • ☐ Przebudowa indeksów zakończona, odczyt i zapis potwierdzone
  • ☐ Health endpoint odpowiada i nie wskazuje trybu read-only
  • ☐ Testy integracyjne zapisu, odczytu, EventQL i warunków wstępnych zaliczone
  • ☐ Wyniki kluczowych zapytań porównane z wynikami sprzed aktualizacji
  • ☐ Rate limiting nie odrzuca legalnego ruchu
  • ☐ Alerty na tryb read-only, pamięć, deskryptory plików i dostępność health endpointu aktywne
  • ☐ Metryki OpenMetrics scrapowane i widoczne w systemie monitoringu
  • ☐ Strumienie kończą się jawnym elementem końcowym, heartbeaty docierają przez proxy
  • ☐ Błędy v2 zwracają czytelne kody z linkami do stron wyjaśniających

Checklista backupu i odtwarzania

  • ☐ Pełny backup wykonany i zapisany poza maszyną bazy
  • ☐ Backup otwiera się i został pomyślnie odtworzony w teście
  • ☐ Backup przyrostowy obejmuje wyłącznie zdarzenia zapisane od poprzedniego backupu
  • ☐ Procedura odtworzenia zakłada pełny backup, a następnie jego przyrosty
  • ☐ Odtworzenie zapisuje zdarzenia w partiach — potwierdźcie szybszy czas odtwarzania
  • ☐ Eksport i import przetestowane na jednym CloudEvent na linię, z ID i czasem
  • ☐ Jeśli usuwacie dane osobowe z historii przed importem, import sam oblicza hashe — potwierdźcie, że integralność pozostaje weryfikowalna

Checklista migracji z v1 na v2

  1. ☐ Wszystkie bezpośrednie wywołania HTTP API wypisane i przypisane do właścicieli
  2. ☐ Migracja zaplanowana trasę po trasę zgodnie z przewodnikiem Migrating to v2
  3. ☐ Data migracji wcześniejsza niż 31 stycznia 2027, z zapasem na nieprzewidziane problemy
  4. ☐ Testy kontraktowe w pipeline obejmują nowe kody błędów i jawne elementy końcowe strumieni
  5. ☐ Proxy, load balancery, WAF i service mesh przepuszczają metodę QUERY
  6. ☐ SDK zaktualizowane do wersji obsługujących oba API

Checklista konfiguracji i bezpieczeństwa

  • ☐ Token API ma co najmniej 32 znaki, składa się z drukowalnego ASCII i nie ma białych znaków na krańcach — serwer porównuje token w stałym czasie i odmawia startu z tokenem, który można odgadnąć
  • ☐ Flagi --ai-model i --ai-option usunięte z konfiguracji startowej
  • ☐ Katalog danych zapisywalny dla UID 65532 w środowisku kontenerowym
  • ☐ Rozważona flaga --require-event-schemas, jeśli chcecie odrzucać zapisy zdarzeń bez zarejestrowanego schematu — domyślnie wyłączona
  • ☐ Stary serwer zatrzymany przed startem 1.3 — dwa procesy na jednym katalogu mogą go uszkodzić

Źródła i materiały do dalszej weryfikacji

Artykuł jest autorskim opracowaniem przygotowanym na podstawie poniższych materiałów. Linki prowadzą do publikacji źródłowych.

  1. EventSourcingDB 1.3.0 is Available (www.eventfoundation.io)

Zdjęcie wyróżniające: Christina Morillo / Pexels.

Masz pytanie do tego tematu? Napisz do nas — odpowiemy konkretnie.

Porozmawiajmy

Potrzebujesz kogoś, kto ogarnie technologię w Twojej firmie?

Porozmawiajmy o tym, co możemy przejąć, usprawnić albo zbudować. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.