Что такое JSONB в PostgreSQL?

JSONB в PostgreSQL

PostgreSQL поддерживает два типа для хранения JSON-данных: json и jsonb. Оба принимают валидные JSON-значения, но отличаются способом хранения и возможностями.

Отличия JSON vs JSONB

Когда использовать JSONB

JSONB предпочтителен в большинстве случаев, когда:

• нужен поиск по содержимому документа;
• данные читаются чаще, чем пишутся;
• требуется индексирование JSON-полей;
• важна производительность запросов.

Тип json оправдан лишь когда критично сохранить оригинальное форматирование или порядок ключей (например, для аудита).

Операторы JSONB

-- Проверка вхождения: содержит ли документ указанный фрагмент
SELECT * FROM users WHERE profile @> '{"role": "admin"}';

-- Проверка существования ключа
SELECT * FROM users WHERE profile ? 'email';

-- Проверка существования любого из ключей
SELECT * FROM users WHERE profile ?| ARRAY['email', 'phone'];

-- Проверка существования всех ключей
SELECT * FROM users WHERE profile ?& ARRAY['email', 'name'];

Индексирование JSONB

Главное преимущество JSONB — возможность создания GIN-индекса, который покрывает все ключи и значения документа:

-- Создание GIN-индекса по всему JSONB-полю
CREATE INDEX idx_users_profile ON users USING GIN (profile);

-- Индекс по конкретному пути (более компактный)
CREATE INDEX idx_users_role ON users USING BTREE ((profile->>'role'));

-- jsonb_path_ops — более компактный GIN-индекс, только для @>
CREATE INDEX idx_users_profile_path ON users USING GIN (profile jsonb_path_ops);

Работа с вложенными данными

-- Оператор -> возвращает JSONB
-- Оператор ->> возвращает текст
SELECT
  profile -> 'address' AS address_json,
  profile ->> 'name'   AS name_text,
  profile -> 'address' ->> 'city' AS city
FROM users;

-- Обновление отдельного ключа без замены всего документа
UPDATE users
SET profile = jsonb_set(profile, '{address, city}', '"Москва"')
WHERE id = 1;

-- Удаление ключа
UPDATE users
SET profile = profile - 'temp_field'
WHERE id = 1;

JSONPath (PostgreSQL 12+)

-- Поиск с использованием JSONPath
SELECT * FROM orders
WHERE jsonb_path_exists(data, '$.items[*] ? (@.price > 1000)');

Практические советы

• Не злоупотребляйте JSONB для данных с фиксированной структурой — реляционная схема обычно эффективнее.
• GIN-индекс ускоряет операторы @>, ?, ?|, ?&, но не операторы -> и ->>.
• Для частых запросов по конкретному полю лучше создать выражённый B-tree индекс ((data->>'field')).
• Функция jsonb_pretty() удобна для отладки.