Šest pravil za sinhronizacijo, ki teče, ko je nihče ne gleda

Lance Martin in CJ Avilla sta 8. oktobra 2026 objavila opis agenta, ki vsako jutro prebere Slack in GitHub ter v Slack objavi povzetek. Nihče ga ne gleda, ko teče. Njun najbolj uporaben odstavek govori o napaki, ki je videti kot uspeh. Ko strežnik vira ne deluje ali mu je žeton potekel, „agent iz tega vira ne vidi ničesar in sporoči ‚nič novega‘“.

Sinhronizacija stikov iz Shopifyja v Brevo ima isto napako. Prav tako vsaka načrtovana sinhronizacija med dvema orodjema SaaS. Branje, ki tiho odpove, je videti povsem enako kot trgovina, v kateri se danes nihče ni registriral.

Njun članek se konča s šestimi pravili za agenta, ki teče brez nadzora. Preberi jih kot nekdo, ki upravlja sinhronizacije, in vsako postane pravilo za reverse ETL. Delovni proces je padel. Sinhronizacija ni. spremlja en stik skozi zrušitev. Ta stran je kontrolni seznam nad tem: šest pravil za samodejno sinhronizacijo podatkov, kaj Tajov izvajalec danes naredi pri vsakem in kje ne zadosti. Stran izvajalca je opisana v Obnovitev zastale ali neuspele sinhronizacije.

1. Beri od zaznamka in ga premakni šele, ko je paket prispel

Njuno prvo pravilo: „Vsak vir beri od zaznamka, ne iz fiksnega časovnega okna.“ Okno „zadnjih 24 ur“ pusti vrzel, ko se zagon začne pozno, in ponovi zapise, ko se začne zgodaj.

Tajova sinhronizacija bere svoj vir v paketih od shranjenega kazalca. Kazalec se premakne na koncu paketa in samo takrat, ko je prispel vsak zapis v tem paketu. Zagon, ki odpove, obdrži zadnji čisti položaj, zato naslednji zagon znova prebere prekinjeni paket, namesto da bi ga preskočil.

Naročila imajo svoj zaznamek. Načrtovana sinhronizacija naročil iz Shopifyja se začne ob svojem prvem načrtovanem zagonu in pošlje, kar se je spremenilo od prejšnjega. Pretekla naročila gredo samo, ko sinhronizacijo zažene oseba. Načrtovani zagoni in zagoni, ki jih zažene oseba, hranijo ločene kazalce, zato nalaganje zgodovine ali testni paket ne moreta previti načrtovanega nazaj.

Cena je, da se prekinjeni paket prebere dvakrat. Pravilo 2 poskrbi, da je to varno.

2. Vsakemu vpisu daj ključ, ki preživi zrušitev

Njuno četrto pravilo šteje objavo kot poslano „šele, ko jo Slack potrdi“, in šele takrat posodobi zaznamek in evidenco. Priporočeno pismo deluje tako. Dostavljeno je, ko se vrne podpisana povratnica, ne ko zapusti okence.

Preden Tajo vpiše zapis, zapis dobi ključ dostave. Ključ je zgoščena vrednost sinhronizacije, vira, kazalca strani, položaja na strani in samega zapisa, zato ne vsebuje osebnih podatkov. Zasede se, preden se pokliče cilj, in se označi kot dokončan, ko vpis uspe. Dokončani ključi se hranijo sedem dni. Ponovitev ali poznejši načrtovani zagon za isti zapis izpelje isti ključ, ga najde dokončanega in cilja ne pokliče znova.

Zraven sodita dve ceni. Po sedmih dneh evidenca pozabi, zato lahko ponovitev od starejšega kazalca vpiše znova. In vpis, ki mu poteče čas, pusti pošten dvom: drugi sistem ga je morda shranil, ne da bi odgovoril. Tajo tak vpis poskusi znova pri poznejšem poskusu, namesto da bi ga sedem dni vodil kot neuspelega. Povezovalnik, ki cilju preda lasten ključ idempotentnosti, ta dvom odpravi. Tisti, ki tega ne zmore, ostane z možnostjo enega dvojnika.

3. En zagon ima sinhronizacijo v lasti in to dokaže pred vsakim vpisom

Njuno tretje pravilo: „Vsak element znova preveri tik pred objavo.“ Pri sinhronizaciji se med branjem in vpisom najverjetneje spremeni to, kdo sme vpisovati.

Vsaka Tajova sinhronizacija ima en zakup, z lastnim žetonom in 15-minutno življenjsko dobo, ki se podaljša vsakih pet minut. Zagon preveri, ali še drži zakup, preden pokliče cilj, in znova, preden premakne kazalec. Zagon, ki ga je izgubil, se ustavi, in njegova stran pove „Izvajanje je med potekom izgubilo svoje mesto in se ustavilo, da ne bi vpisalo dvakrat.“ Drugi zagon, ki trči v aktivnega, se konča, namesto da bi se postavil v vrsto za njim.

Preverjajo se tudi zapisi. Med branjem in vpisom gredo zapisi skozi filter soglasja. Stik, ki bi bil vpisan v tržno občinstvo brez dokazljive privolitve, je zavrnjen, namesto da bi se ugibalo. Po besedah strani s pomočjo je način odpovedi „preveč previdno“, nikoli „poslano preveč“.

4. Ponovi, kar gre skozi, ustavi, kar ne gre

Njunih šest pravil ne pove ničesar o tem, kako pogosto poskusiti znova. Sinhronizacija to pravilo potrebuje, ker sta njeni najpogostejši napaki omejitev hitrosti in slaba minuta pri ponudniku.

Tajov zagon iz čakalne vrste, ki odpove, dobi pet poskusov. Čakanja med njimi so 60, 120, 240 in 480 sekund, skupaj približno petnajst minut. Nekatere napake se nikoli ne ponovijo, ker jih nov poskus ne more popraviti. Zagon, ki je trčil v zagon, ki že teče, se ne ponovi, prav tako ne zagon, katerega objavljena različica ali povezave niso več veljavne.

Niz je nekaj drugega kot enkraten spodrsljaj. Če je vseh pet zadnjih končanih zagonov od zadnje spremembe sinhronizacije odpovedalo, Tajo sinhronizacijo zaustavi in na njeni strani prikaže zadnjo napako. En uspeh ponastavi števec. Nič zaustavljene sinhronizacije ne zažene samo od sebe; oseba odpravi vzrok in jo znova objavi. Članek o padlem delovnem procesu pripoveduje o incidentu, iz katerega je nastalo to pravilo.

5. Tišino obravnavaj kot ugotovitev

„Neuspelo branje sporoči kot neberljivo, nikoli kot miren dan.“ To je najtežje od šestih pravil in edino, ki mu zadostimo le delno.

Kjer velja: branje z napako povzroči neuspeh zagona. Zavrnjen žeton ali strežnik, ki ne odgovori, cilju ne pošlje ničesar, pusti kazalec, kjer je bil, in šteje k zaustavitvi po petih neuspelih zagonih. In vsako uro, 13 minut čez polno uro, Tajo preveri vsak delovni prostor z aktivno sinhronizacijo. Lastno ekipo opozori, ko v zadnjih 24 urah ni bilo nobenega uspešnega zagona, tudi v delovnem prostoru, kjer ni bil zabeležen noben zagon. To je urno preverjanje.

Kjer ne velja: tiho branje, ki ga opisujeta avtorja, je branje, ki odgovori „OK“ brez zapisov. Naš izvajalec to šteje kot uspeh. Za vire, kot so kupci v Shopifyju, ločeno preverjanje opozori Tajovo ekipo po desetih zaporednih uspešnih zagonih z nič zapisi, če je sinhronizacija prej dajala zapise. Naročila v Shopifyju se berejo po času posodobitve, zato je prazen zagon tam običajen in to preverjanje se ne izvaja. Vir, ki vrne nekaj zapisov, a manj, kot bi jih moral, sploh ni zaznan.

Ugovor se glasi tako: „Deset praznih zagonov je dve uri in pol pri urniku na 15 minut. Zakaj ne opozoriti že ob prvem?“ Sinhronizacije stikov res privzeto tečejo vsakih 15 minut. In trgovina brez novih kupcev v četrt ure je nekaj običajnega. Opozorilo ob prvem praznem zagonu bi se sprožilo vsako noč, opozorila, ki se sproži vedno, pa nihče ne bere. Ta meja zamenja hitrost za verodostojnost. Še vedno je ugibanje o tišini, ne pravilo avtorjev.

6. Enkrat odloči, kaj sme sinhronizacija vpisati, in naj vsak zagon to dokaže

Njuno peto pravilo hrani nastavitve agenta „v shrambi, ki je agent ne more urejati“. Šesto agentu daje dostop samo za branje povsod, kjer le bere, in omeji, koliko lahko porabi vsak zagon. Obe obstajata, ker agent bere besedilo, ki so ga napisali drugi ljudje, in to besedilo mu lahko poskuša ukazovati.

Pri sinhronizaciji je različica datoteke z nastavitvami objavljeno pravilo. Objava Tajove sinhronizacije jo veže na povzetek (digest) natanko tistega pravila, ki je šlo skozi predogled. Urejanje jo vrne v osnutek in pred naslednjim zagonom znova gre skozi predogled. Vsak zagon pred kakršno koli spremembo preveri, da izvaja to objavljeno različico s povezavami, s katerimi je bila objavljena. Zagon, ki tega preverjanja ne prestane, se ne ponovi. Tudi smer je določena: pravilo sinhronizacije vpisuje v eno smer in nikoli nazaj v Shopify.

Omejitev porabe nima ustreznika. Naši zagoni sinhronizacije nimajo omejitve porabe na zagon. Omejitev ponovitev in zaustavitev omejujeta, kako dolgo lahko traja napaka, ne pa, koliko zagon stane.

Kaj je zgrajeno in kaj ni

Zgrajeno v času pisanja:

• Kazalec, ki se premakne šele po paketu, v katerem je prispel vsak zapis, in načrtovani kazalec naročil, ki ga zagoni, ki jih zažene oseba, ne morejo previti nazaj.
• Ključ dostave za vsak zapis, preverjen v evidenci dokončanih vpisov, ki se hrani sedem dni.
• En zakup na sinhronizacijo, preverjen pred vpisom in preden se kazalec premakne.
• Pet poskusov na zagon, s čakanjem 60 sekund, nato 120, 240 in 480, brez ponovitve ob trku ali neveljavni objavi.
• Zaustavitev po petih zaporednih neuspelih zagonih, prikazana na strani sinhronizacije.
• Urno opozorilo, ko v zadnjih 24 urah ni uspel noben zagon.
• Filter soglasja ob izvajanju za stike, vpisane v tržno občinstvo, in preverjanje ob vsakem zagonu, da gre za objavljeno različico.

Ni zgrajeno, in to je vredno vedeti, preden se zaneseš nanj:

• Branje, ki uspe z nič zapisi, ni sporočeno kot neberljivo. Opozorilo po desetih zagonih pokrije del tega. Ne pokrije naročil v Shopifyju ali vira, ki vrne premalo zapisov.
• 24-urno opozorilo prejme Tajo, ne ti, in enako velja za opozorilo po desetih zagonih. Zaustavitev je vidna na strani sinhronizacije.
• Urno preverjanje spremlja delovni prostor, ne vsake sinhronizacije. Ena zdrava sinhronizacija skrije tiho poleg sebe.
• Ni omejitve porabe na zagon.
• Nič ne zažene zaustavljene sinhronizacije znova. To naredi oseba.
• Zaustavitev po petih napakah in 24-urno preverjanje sta nastavljena za celotno namestitev Tajo, ne za vsako sinhronizacijo posebej.

Ko se kaj od tega pokaže pri tvoji sinhronizaciji, Obnovitev zastale ali neuspele sinhronizacije pove, kaj vidiš in kaj narediti.

Avtorja sta napisala šest pravil za povzetek, ki ga oseba prebere vsako jutro. Sinhronizacija sploh nima jutranjega bralca, zato jih potrebuje še bolj. Pravila od ena do štiri in pravilo šest so danes koda v našem izvajalcu. Pravilo pet je napisano na pol: sinhronizacija, ki ne more prebrati svojega vira, bi to morala povedati.