Типові помилки при роботі з JSON-даними та способи їх уникнення

Робота з JSON-даними в PostgreSQL — це потужний інструмент, але, як і будь-який інструмент, він вимагає обережності. Навіть дрібні помилки можуть перетворити твій запит на справжній квест. Сьогодні ми знову зосередимось на типових помилках, які виникають при роботі з JSON та JSONB у PostgreSQL, а також на способах їх уникнення.

Проблема 1: використання JSON замість JSONB

Багато новачків помилково використовують тип даних JSON, думаючи, що це найкращий вибір для зберігання даних у форматі JSON. Але JSON у PostgreSQL зберігає дані як текст, що може призвести до просідання продуктивності при пошуку чи фільтрації.

Приклад помилки:

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    details JSON
);

INSERT INTO products (details) VALUES ('{"name": "Laptop", "price": 1000}');

INSERT INTO products (details) VALUES ('{"name": "Laptop", "price": 1000}');

Якщо спробувати фільтрувати по ключу (price), запит буде працювати значно повільніше, ніж з JSONB.

Як виправити: використовуй JSONB, якщо плануєш активно фільтрувати або звертатись до даних.

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    details JSONB
);

Проблема 2: відсутність індексів для JSONB

JSONB — це реально потужна штука, але без індексів його продуктивність при складних запитах може сильно просідати.

Приклад помилки: уявімо, що у нас є таблиця з колонкою details, де ми зберігаємо купу JSON-об'єктів:

SELECT * FROM products WHERE details->>'name' = 'Laptop';

Якщо дані не проіндексовані, сервер буде робити повний перегляд таблиці (full table scan), витрачаючи на це купу часу.

Як виправити: створи індекс GIN для прискорення пошуку по ключах:

CREATE INDEX idx_details_name ON products USING gin (details jsonb_path_ops);

Проблема 3: помилки при витягу вкладених даних

Витягати дані з вкладених об'єктів чи масивів може бути заплутано, особливо якщо ти не знаєш різницю між операторами -> і ->>.

Приклад помилки:

SELECT details->'price' FROM products;

Цей запит поверне значення у форматі JSON, а не рядок ("1000" замість 1000). Якщо треба саме значення, використовуй ->>:

SELECT details->>'price' FROM products;

Проблема 4: Неправильне використання операторів

Ти міг зустрічати оператор @> і подумати: "Звучить круто, давай юзати завжди!" Але якщо не розумієш, як він працює, отримаєш неочікувані результати.

Приклад помилки:

SELECT * FROM products WHERE details @> '{"price": 1000}';

Цей запит працює тільки якщо price — це число в JSON. Якщо значення збережене як рядок "1000", запит нічого не поверне.

Як виправити: будь уважний до типів даних у JSON:

SELECT * FROM products WHERE details->>'price' = '1000';

Проблема 5: Великі JSON-об'єкти

Зберігати великі JSON-об'єкти без оптимізації може серйозно загальмувати запити. Більше того, читання чи зміна навіть маленької частини даних у JSONB вимагає обробки всього об'єкта.

Як виправити: якщо певні ключі часто використовуються, винеси їх в окремі колонки таблиці. Наприклад:

ALTER TABLE products ADD COLUMN price NUMERIC;
UPDATE products SET price = (details->>'price')::NUMERIC;

Тепер ти можеш ефективно фільтрувати і сортувати дані без необхідності парсити JSONB.

Проблема 6: повна перебудова об'єктів при змінах

Коли використовуєш функції типу jsonb_set() чи jsonb_insert(), PostgreSQL створює повністю новий об'єкт JSONB, що може бути дорогим по ресурсах.

Як виправити: мінімізуй кількість оновлень JSONB. Наприклад, замість частого оновлення одного об'єкта, об'єднай всі зміни в один запит:

UPDATE products
SET details = jsonb_set(details, '{price}', '1500'::jsonb);

Проблема 7: нерозуміння структури масиву

У JSONB масиви теж вимагають уважності. Уяви, що у тебе є масив:

{
    "tags": ["electronics", "laptop", "sale"]
}

Ти хочеш перевірити наявність тега "laptop". Якщо ти помилково використаєш оператор @>, можеш не отримати результат, бо він чекає масив, а не рядок.

Приклад помилки:

SELECT * FROM products WHERE details->'tags' @> '"laptop"';

Як виправити: Використовуй правильний формат в операторі @>:

SELECT * FROM products WHERE details->'tags' @> '["laptop"]';

Рекомендації щодо уникнення помилок

Щоб уникнути купи проблем при роботі з JSONB, дотримуйся цих порад:

Обирай правильний тип даних. Якщо працюєш з великими об'ємами даних і часто фільтруєш, завжди використовуй JSONB замість JSON.

Індексуй дані. Якщо запити часто звертаються до певних ключів, створи відповідний індекс (наприклад, GIN).

Перевіряй дані перед вставкою. Використовуй функції валідації для перевірки структури даних:

DO $$
BEGIN
    IF jsonb_typeof('{"price": 1000}'::jsonb->'price') IS DISTINCT FROM 'number' THEN
        RAISE EXCEPTION 'Price must be a number';
    END IF;
END $$;

Оптимізуй структуру даних. Якщо певні ключі використовуються частіше за інші, винеси їх в окремі колонки таблиці.

Вивчи оператори та функції. Уважно читай офіційну документацію PostgreSQL, щоб краще розуміти різницю між ->, ->>, @>, ?| та іншими функціями.

JSON і JSONB можуть стати твоїм союзником у роботі з гнучкими та складними даними. Головне — уважно підходити до вибору інструментів і уникати поширених помилок, щоб твій код був ефективним і простим у підтримці.