Что такое partial и expression index
На этой странице
Частичный индекс (partial index) содержит только строки, удовлетворяющие условию WHERE в определении индекса: CREATE INDEX … WHERE status = 'pending'. Он меньше, быстрее обновляется и идеален для перекошенных данных (активные задачи, неудалённые записи) и условной уникальности. Планировщик использует его, только если условие запроса логически влечёт условие индекса. Индекс по выражению (expression index) хранит результат функции или выражения: lower(email), (attrs->>'brand'), date(created_at AT TIME ZONE 'UTC'); он используется, когда запрос содержит то же выражение. Выражение должно быть IMMUTABLE — поэтому, например, date(timestamptz) без явного часового пояса проиндексировать нельзя.
Вопрос
Что такое partial и expression index и когда их использовать?
Частичный индекс
-- 99% заказов завершены, интересны только активные
CREATE INDEX orders_active_idx ON orders (created_at)
WHERE status IN ('new', 'processing');
SELECT * FROM orders WHERE status = 'new' ORDER BY created_at LIMIT 50; -- ✓ использует
SELECT * FROM orders WHERE status = 'done' ORDER BY created_at LIMIT 50; -- ✗ не подходитУсловная уникальность
-- уникальный slug среди неудалённых
CREATE UNIQUE INDEX articles_slug_uniq ON articles (slug) WHERE deleted_at IS NULL;
-- только одна активная подписка на пользователя
CREATE UNIQUE INDEX subscriptions_one_active ON subscriptions (user_id) WHERE status = 'active';Параметры и частичные индексы
-- условие индекса: WHERE deleted_at IS NULL
SELECT * FROM articles WHERE deleted_at IS NULL AND author_id = $1; -- ✓
SELECT * FROM articles WHERE status = $1; -- если индекс WHERE status = 'pending', а status передан параметром,
-- generic plan может его не использоватьУсловие частичного индекса должно быть в запросе в явном виде (литералом), а не через параметр.
Индекс по выражению
CREATE INDEX users_email_lower_idx ON users (lower(email));
SELECT * FROM users WHERE lower(email) = lower($1); -- ✓ то же выражение
CREATE INDEX products_brand_idx ON products ((attrs->>'brand')); -- двойные скобки для выражений
SELECT * FROM products WHERE attrs->>'brand' = 'Lenovo'; -- ✓IMMUTABLE и даты
-- ✗ ERROR: functions in index expression must be marked IMMUTABLE
CREATE INDEX ON orders (date(created_at)); -- created_at timestamptz: зависит от TimeZone сессии
-- ✓ явный часовой пояс делает выражение неизменным
CREATE INDEX orders_day_msk_idx ON orders (((created_at AT TIME ZONE 'Europe/Moscow')::date));
SELECT * FROM orders WHERE (created_at AT TIME ZONE 'Europe/Moscow')::date = '2026-10-24';Часто проще вообще не использовать выражение, а фильтровать полуоткрытым диапазоном по обычному индексу created_at.
Комбинация
CREATE INDEX users_active_email_idx ON users (lower(email)) WHERE deleted_at IS NULL;Альтернатива — генерируемый столбец
ALTER TABLE products ADD COLUMN brand text GENERATED ALWAYS AS (attrs->>'brand') STORED;
CREATE INDEX ON products (brand);Запросы проще (WHERE brand = ...), и столбец виден в ORM.
Частые ошибки
- Запрос использует выражение, отличающееся от индекса (
LOWER(email)vslower(trim(email))). - Частичный индекс с условием, которое запрос не повторяет.
- Индекс по
date(timestamptz)— ошибкаIMMUTABLE. - Слишком много частичных индексов под каждую комбинацию фильтров.
Что важно помнить
- Partial — индекс по части строк; запрос должен включать его условие.
- Expression — индекс по результату выражения; запрос должен содержать то же выражение.
- Функции в индексе — только
IMMUTABLE.
Мини-шпаргалка
CREATE INDEX ... ON t (col) WHERE cond.CREATE UNIQUE INDEX ... WHERE deleted_at IS NULL.CREATE INDEX ... ON t (lower(col)).((expr))— выражение в двойных скобках.
Документация
PostgreSQL: Partial Indexes, PostgreSQL: Indexes on Expressions.