SQL Academy · Lekcja

Modelowanie: kiedy JSONB wygrywa z normalizacją

Decydować między kolumną JSONB a osobną tabelą — elastycznymi atrybutami i ścisłymi schematami

Modelowanie: kiedy JSONB wygrywa z normalizacją to bezpłatna lekcja SQL Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej SQL Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs SQL Academy zawiera 4 lekcji w sumie.

Wybór

Dla każdej przechowywanej wartości: kolumna czy klucz JSONB? Odpowiedź wpływa na projekt schematu, wydajność zapytań i łatwość utrzymania.

Kiedy lepsze są kolumny

Rzeczywistych kolumn należy używać, gdy dane są:

Znane i stabilne
Często odpytywane za pomocą indeksów
Weryfikowane przez ograniczenia CHECK / FK
Używane w raportach lub złączeniach

Kiedy lepsze jest JSONB

JSONB należy używać, gdy:

Struktura różni się w poszczególnych wierszach (pola definiowane przez dzierżawców, metadane wtyczek)
Schemat szybko ewoluuje (aby uniknąć migracji)
Odczyt i zapis całych dokumentów jest typowym sposobem pracy
Przechowywane są nieprzetworzone dane (treści żądań webhooków)

Wzorzec hybrydowy

Najlepsze cechy obu rozwiązań: uporządkowane kolumny dla stabilnego rdzenia, JSONB dla zmiennej części:

CREATE TABLE events (
  id BIGSERIAL PRIMARY KEY,
  ts TIMESTAMPTZ NOT NULL,
  event_type TEXT NOT NULL,
  user_id BIGINT,
  data JSONB NOT NULL DEFAULT '{}'::JSONB
);

Pułapka EAV

Klasyczny model „entity-attribute-value” — jedna tabela z wierszami (klucz, wartość) — był kiedyś jedynym rozwiązaniem dla rzadkich danych. JSONB zastępuje EAV jedną kolumną dokumentu:

-- Old EAV:
CREATE TABLE user_attrs (
  user_id BIGINT,
  attr TEXT,
  val TEXT
);

-- Modern:
ALTER TABLE users ADD COLUMN attrs JSONB NOT NULL DEFAULT '{}';

-- JSONB queries are faster and easier than the EAV joins.

Strategia migracji

Dodanie kolumny do często używanej tabeli oznacza 5 minut przestoju w przypadku dużej tabeli. W JSONB dodanie pola wymaga jedynie zmiany kodu aplikacji.

Ograniczenia dla JSONB

Aby wymusić minimalną strukturę, należy dodać ograniczenia CHECK:

ALTER TABLE events
  ADD CONSTRAINT data_has_type CHECK (data ? 'type'),
  ADD CONSTRAINT type_is_string CHECK (jsonb_typeof(data->'type') = 'string');

Przenoszenie często używanych pól do kolumn

Jeśli pole JSONB jest często odpytywane, należy przenieść je do rzeczywistej kolumny. Skrypt UPDATE + nowy indeks + nowa kolumna zapewnią wysoką wydajność.

Operacje aktualizacji JSONB

Aktualizowanie pojedynczego pola:

UPDATE users
SET attrs = jsonb_set(attrs, '{plan}', '"pro"')
WHERE id = 1;

Nie należy przechowywać pieniędzy w JSONB

Wartości finansowe wymagają dokładnych typów NUMERIC i ograniczeń. Zawsze należy używać rzeczywistych kolumn.

Kiedy JSONB szkodzi

Jeśli w każdym zapytaniu wyodrębniają Państwo i rzutują ten sam klucz JSONB, jest to znak, że powinien on być kolumną. Łączny koszt (data->>'k')::INT dla milionów wierszy szybko staje się znaczący.

Dokumentowanie schematu

Kolumny JSONB łatwo jest zapisywać, ale trudno dokumentować. Należy utrzymywać zewnętrzny schemat (JSON Schema, kod aplikacji), aby współpracownicy wiedzieli, czego się spodziewać.

Podsumowanie

JSONB to potężne narzędzie — należy używać go dla zmiennych części danych, a rzeczywistych kolumn dla stabilnego rdzenia. Gdy pojawią się powtarzalne wzorce, często używane pola należy przenieść do kolumn.

Szybkie sprawdzenie

Przechowuje Pan/Pani zdarzenia audytowe. Typ zdarzenia jest zawsze obecny, ale niektóre zdarzenia mają tablicę „actors”, której kształt może się różnić. Jak należy to zamodelować?

Często zadawane pytania

Czy lekcja „Modelowanie: kiedy JSONB wygrywa z normalizacją” jest bezpłatna?

Tak — pełny tekst „Modelowanie: kiedy JSONB wygrywa z normalizacją” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu SQL Academy, przejdź na CoddyKit PRO. Kurs SQL Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Modelowanie: kiedy JSONB wygrywa z normalizacją”?

Decydować między kolumną JSONB a osobną tabelą — elastycznymi atrybutami i ścisłymi schematami Ćwiczysz SQL Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć SQL Academy?

Nie wymagamy żadnego doświadczenia. SQL Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Modelowanie: kiedy JSONB wygrywa z normalizacją”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji SQL Academy?

Tak. Każda lekcja SQL Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

JSONB a JSON: kiedy używać którego
Operatory ścieżek: -> ->> @>
Indeksowanie JSONB za pomocą GIN
Modelowanie: kiedy JSONB wygrywa z normalizacją

← Powrót do SQL Academy