Установка pgvector в PostgreSQL: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка pgvector в PostgreSQL». Страница справочника целиком: Установка pgvector.

Коротко о теме

Установка pgvector на свой сервер: сборка из исходников или образ Docker, команда CREATE EXTENSION, выбор индекса HNSW или IVFFlat и место.

Подробности по разделам

pgvector: векторный поиск прямо в PostgreSQL

Хранить можно векторы до 16 000 измерений, но индекс по типу vector строится только до 2 000. Отдельная база вроде Qdrant нужна, когда векторов миллионы и поиск становится отдельной нагрузкой.

pgvector в Docker и docker compose

Включать его нужно один раз в каждой базе, где будут векторы. Порт 5432 здесь привязан к 127.0.0.1: программы на этом сервере подключаются через localhost, контейнеры того же compose по имени сервиса db. Если база нужна с другого сервера, откройте порт только для его адреса и включите SSL в настройках PostgreSQL.

Индексы pgvector: HNSW или IVFFlat

Индекс быстрее строить после загрузки данных, а не до.

Сколько места и памяти займёт pgvector

Число векторов, размерность и соседство с основной базой: калькулятор подберёт конфигурацию

Ключевые цифры

pgvector/pgvector с тегом под версию PostgreSQL, например pgvector/pgvector:pg18-trixie.
Индексы по типу vector ограничены 2 000 измерений.
Храните эмбеддинги как halfvec (до 4 000 для индекса) или уменьшите размерность в настройках модели эмбеддингов.

Термины на странице

PostgreSQL: PostgreSQL это база данных для приложений с большими объёмами и сложными запросами.
SSL-сертификат: SSL-сертификат подтверждает, что сайт принадлежит владельцу домена, и позволяет шифровать соединение.
Docker: Docker запускает программы в контейнерах: всё нужное для работы упаковано в образ.
Резервная копия: Резервная копия это сохранённое состояние сайта или сервера, из которого его можно восстановить.
Root-доступ: Root-доступ это права администратора на сервере: можно ставить любые программы и менять любые настройки.
VDS: VDS это то же самое, что VPS: виртуальный выделенный сервер. Разницу в названии провайдеры трактуют по-разному.

Что проверить

Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.
Храните данные контейнеров в томах.
Закрепляйте версии образов, а не latest.
Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.