{"id":10426,"date":"2026-09-17T18:10:00","date_gmt":"2026-09-17T16:10:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=10426"},"modified":"2026-09-09T17:09:09","modified_gmt":"2026-09-09T15:09:09","slug":"porownywanie-dwoch-eksportow-kontenera-gtm-normalizacja-przed-diffem","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/tworzenie-stron-internetowych\/porownywanie-dwoch-eksportow-kontenera-gtm-normalizacja-przed-diffem\/","title":{"rendered":"Por\u00f3wnywanie dw\u00f3ch eksport\u00f3w kontenera GTM: normalizacja przed diffem i czego nie pokazuje por\u00f3wnanie wierszami"},"content":{"rendered":"

Por\u00f3wnanie dw\u00f3ch eksport\u00f3w tej samej konfiguracji to najszybsza droga do ustalenia, co kto\u015b zmieni\u0142, a pierwsza pr\u00f3ba niemal zawsze daje wynik bezu\u017cyteczny. To kilkaset r\u00f3\u017cni\u0105cych si\u0119 wierszy, z kt\u00f3rych liczy si\u0119 jeden, a reszta to format pliku rozmawiaj\u0105cy sam ze sob\u0105.<\/p>\n

Wszystko, co nast\u0119puje, dotyczy odst\u0119pu mi\u0119dzy tymi dwiema liczbami – czym jest wype\u0142niony, jak znika i co pozostaje niewidoczne r\u00f3wnie\u017c potem.<\/p>\n

\n\"Ta
Trzy poziomy dla jednej zmiany i czwarta para, kt\u00f3r\u0105 por\u00f3wnanie wierszami nazywa r\u00f3\u017cn\u0105, a parser identyczn\u0105.<\/figcaption><\/figure>\n

Czym wype\u0142niony jest ten odst\u0119p<\/h2>\n

Eksporty s\u0105 generowane, a generatory do niczego nie s\u0105 zobowi\u0105zane. Ta sama konfiguracja wyeksportowana dwukrotnie mo\u017ce r\u00f3\u017cni\u0107 si\u0119 kolejno\u015bci\u0105 kluczy obiekt\u00f3w, identyfikatorami nadawanymi przy eksporcie, odciskiem b\u0119d\u0105cym znacznikiem czasu i tym, czy plik ko\u0144czy si\u0119 z\u0142amaniem wiersza. Nic z tego nie jest zmian\u0105; wszystko z tego jest r\u00f3\u017cnic\u0105.<\/p>\n\n\n\n\n\n\n\n\n\n\n
\u0179r\u00f3d\u0142o szumu<\/th>\nJak wygl\u0105da<\/th>\nJak znika<\/th>\n<\/tr>\n<\/thead>\n
Kolejno\u015b\u0107 kluczy<\/td>\nca\u0142e bloki uchodz\u0105 za zmienione<\/td>\njq -S .<\/code> sortuje klucze rekurencyjnie<\/td>\n<\/tr>\n
Odciski, znaczniki czasu<\/td>\njeden zmieniony wiersz na obiekt<\/td>\nusun\u0105\u0107 te pola przed por\u00f3wnaniem<\/td>\n<\/tr>\n
Identyfikatory nadane przy eksporcie<\/td>\nka\u017cde odwo\u0142anie si\u0119 r\u00f3\u017cni<\/td>\ntak samo – albo por\u00f3wnywa\u0107 po nazwach<\/td>\n<\/tr>\n
Wci\u0119cia<\/td>\nr\u00f3\u017cni si\u0119 wszystko<\/td>\njq<\/code> formatuje obie strony jednakowo<\/td>\n<\/tr>\n
Zako\u0144czenia wierszy<\/td>\nr\u00f3\u017cni si\u0119 ka\u017cdy wiersz i wygl\u0105da tak samo<\/td>\ndos2unix<\/code> albo opcja narz\u0119dzia por\u00f3wnuj\u0105cego<\/td>\n<\/tr>\n
Minifikacja<\/td>\nr\u00f3\u017cni si\u0119 jeden wiersz i nic nie m\u00f3wi<\/td>\nsformatowa\u0107 od nowa, potem por\u00f3wna\u0107<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Wiersz o zako\u0144czeniach wierszy kosztuje godzin\u0119, bo oba wiersze wygl\u0105daj\u0105 na ekranie dok\u0142adnie tak samo. Plik, kt\u00f3ry przeszed\u0142 przez edytor na Windowsie, r\u00f3\u017cni si\u0119 od \u017ar\u00f3d\u0142a w ka\u017cdym pojedynczym wierszu, a ka\u017cda z tych r\u00f3\u017cnic jest niewidoczna.<\/p>\n

Najpierw normalizacja, potem por\u00f3wnanie<\/h2>\n

Zaradzeniem jest potok przetwarzania, a nie lepsze narz\u0119dzie por\u00f3wnuj\u0105ce. Oba pliki przechodz\u0105 przez t\u0119 sam\u0105 normalizacj\u0119, pola ulotne zostaj\u0105 usuni\u0119te i dopiero potem por\u00f3wnuje si\u0119 wyniki – wtedy por\u00f3wnanie zawiera to, co si\u0119 zmieni\u0142o, i nic poza tym.<\/p>\n

norm() {\n  jq -S 'walk(if type == \"object\"\n              then del(.fingerprint, .accountId, .containerVersionId)\n              else . end)' \"$1\"\n}\n\ndiff <(norm stary.json) <(norm nowy.json)<\/code><\/pre>\n
walk<\/code> schodzi do ka\u017cdego obiektu, pola znikaj\u0105 wi\u0119c wsz\u0119dzie, gdzie wyst\u0119puj\u0105, a nie tylko na najwy\u017cszym poziomie. -S<\/code> sortuje klucze ka\u017cdego obiektu i ju\u017c samo to usuwa najwi\u0119ksze \u017ar\u00f3d\u0142o szumu. Co przetrwa oba, jest zmian\u0105, kt\u00f3r\u0105 kto\u015b wprowadzi\u0142.<\/p>\n
Trzy poziomy, trzy r\u00f3\u017cne odpowiedzi<\/h2>\n
Wiersz, s\u0142owo i znak to nie klasy jako\u015bci, tylko r\u00f3\u017cne pytania. Por\u00f3wnanie wierszami odpowiada, kt\u00f3re wiersze nie s\u0105 identyczne, a to pytanie w\u0142a\u015bciwe dla kodu \u017ar\u00f3d\u0142owego, gdzie wiersz to mniej wi\u0119cej jedna instrukcja. Jest pytaniem niew\u0142a\u015bciwym dla pliku JSON z jednym obiektem na wiersz i ca\u0142kiem bezu\u017cytecznym dla zminifikowanego, w kt\u00f3rym ca\u0142y dokument jest jednym wierszem.<\/p>\n
Poziom s\u0142owa por\u00f3wnuje cz\u0142ony i czyni zmian\u0119 jednej warto\u015bci czyteln\u0105. Poziom znaku jest drobniejszy, ni\u017c do czytania potrzeba, i jest dok\u0142adnie tym, czego trzeba, gdy wiersz jest d\u0142ugi: w zminifikowanym eksporcie kontenera tylko por\u00f3wnanie znakami wska\u017ce ten jeden przewr\u00f3cony znacznik logiczny.<\/p>\n
Czego nie poka\u017ce \u017caden poziom<\/h2>\n
Por\u00f3wnanie tekstu widzi tekst. Trzy rodzaje zmian pozostaj\u0105 przez to niewidoczne, bez wzgl\u0119du na drobiazgowo\u015b\u0107 rozdzielczo\u015bci. Przeniesiony blok pojawia si\u0119 jako usuni\u0119cie w jednym miejscu i dodanie w drugim, bez niczego, co by je \u0142\u0105czy\u0142o. Przemianowana zmienna wyst\u0119puj\u0105ca w dwunastu miejscach pojawia si\u0119 jako dwana\u015bcie osobnych zmian zamiast jednego zamiaru. A warto\u015b\u0107, kt\u00f3ra zmieni\u0142a typ, nie zmieniaj\u0105c wygl\u0105du – z \"1\"<\/code> na 1<\/code> – jest r\u00f3\u017cnic\u0105 dw\u00f3ch znak\u00f3w o skutkach, kt\u00f3rych \u017cadne wyr\u00f3\u017cnienie nie przeka\u017ce.<\/p>\n
Przypadek odwrotny stoi w czwartym wierszu diagramu: dwa pliki r\u00f3\u017cni\u0105ce si\u0119 w ka\u017cdym wierszu i opisuj\u0105ce ten sam obiekt. Por\u00f3wnanie tekstu potrafi odpowiada\u0107 wy\u0142\u0105cznie na pytania o tekst – a pytanie faktycznie zadawane, czy konfiguracja si\u0119 zmieni\u0142a, jest pytaniem o struktur\u0119.<\/p>\n
Co por\u00f3wnywa\u0107 zamiast tego, gdy zale\u017cy na odpowiedzi<\/h2>\n
Przy wszystkim, co ma schemat, uczciwym por\u00f3wnaniem jest to mi\u0119dzy roz\u0142o\u017conymi obiektami, a nie mi\u0119dzy plikami. jq<\/code> potrafi to wprost: dwa dokumenty s\u0105 r\u00f3wne albo nie s\u0105, a odpowiedzi\u0105 jest pojedyncza warto\u015b\u0107 logiczna, kt\u00f3rej nie dotyka formatowanie, kolejno\u015b\u0107 ani bia\u0142y znak.<\/p>\n
# czy to w ogóle ten sam obiekt?\njq -e --slurpfile b nowy.json '. == $b[0]' stary.json >\/dev\/null && echo \"identyczne\"\n\n# które klucze najwyższego poziomu się różnią?\njq -n --slurpfile a stary.json --slurpfile b nowy.json \\\n  '($a[0] | keys) as $ka | ($b[0] | keys) as $kb\n   | { tylko_stary: ($ka - $kb), tylko_nowy: ($kb - $ka) }'<\/code><\/pre>\n
Por\u00f3wnaniu wierszami zostaje przez to zadanie, w kt\u00f3rym jest dobre: pokaza\u0107 cz\u0142owiekowi, co zrobi\u0142 kto\u015b inny, w postaci czytaj\u0105cej si\u0119 jak plik, kt\u00f3ry b\u0119dzie edytowa\u0142. Bardzo dobrze odpowiada, na co spojrze\u0107, i wcale nie odpowiada, czy co\u015b jest tym samym – a wi\u0119kszo\u015b\u0107 irytacji nim bierze si\u0119 z zadawania mu tego drugiego pytania.<\/p>\n
\n
\u0179r\u00f3d\u0142a<\/h2>\n