Supabase и n8n: база данных, аутентификация и Vector Store в одном

Supabase можно использовать в n8n тремя способами: как классическую базу данных Postgres через node Supabase, как Vector Store для приложений на основе ИИ, таких как RAG-чат-боты, и косвенно как бэкенд аутентификации, если собственные приложения обращаются к тому же экземпляру Supabase. Для компании это означает одну базу данных для основных данных и для эмбеддингов вместо поддержки двух отдельных сервисов. По состоянию на: август 2026 года.

Как подключить Supabase как обычную базу данных в n8n?

Обычный node Supabase покрывает базовые операции над таблицей: создание строки, удаление, чтение, получение нескольких строк и обновление. По умолчанию он работает в схеме `public`, но может быть переключён на другие схемы. Если функциональности недостаточно для конкретного случая использования, те же учётные данные можно повторно использовать в node HTTP Request для прямых вызовов API.

Как правильно настроить учётные данные?

Для учётных данных Supabase в n8n требуются два параметра: хост в виде URL проекта в формате `https://ваш_проект.supabase.co` без пути `/rest/v1`, и secret key из настроек проекта. Важно для существующих workflow: согласно документации, классический ключ `service_role` пока продолжает работать, но Supabase постепенно переходит на новые secret key и планирует отключить старые ключи `service_role` к концу 2026 года. Тем, кто настраивает проект заново, стоит сразу использовать новый secret key.

Как работает Supabase Vector Store для RAG-приложений?

Node Supabase Vector Store поддерживает пять режимов: получение нескольких документов через поиск по сходству, вставку документов, предоставление в качестве Vector Store для chain или инструмента для ИИ-агента, и обновление существующих записей. При подключении в качестве инструмента агент может самостоятельно обращаться к Vector Store, если имя и описание хранилища соответствуют запросу. Для этого node нужна функция сопоставления в базе данных, которая, согласно документации, при следовании quickstart Supabase по умолчанию называется `match_documents`.

Что необходимо настроить на стороне Supabase для Vector Store?

На стороне Supabase сначала нужно включить расширение pgvector — либо через dashboard, либо с помощью SQL-команды (`create extension vector with schema extensions`). После этого нужна таблица со столбцом vector, размерность которого должна соответствовать используемой модели эмбеддингов. Для запросов Supabase рекомендует инкапсулировать поиск по сходству в функции Postgres, поскольку PostgREST не поддерживает операторы pgvector напрямую; обычно при этом используется оператор косинусного расстояния. Supabase также отмечает, что эмбеддинги с меньшей размерностью, как правило, работают быстрее, и что для сопоставимости всегда следует использовать эмбеддинги из одной и той же модели.

Какие ошибки чаще всего встречаются на практике?

Наиболее часто документируемая в сообществе n8n ошибка — это нарушение ограничения not-null при вставке: один пользователь сообщил в теме Error in Supabase Vector Store when trying to add documents о сообщении, что столбец с именем "brand" не принимает значение null, поскольку схема его таблицы отличалась от стандартного шаблона Supabase. Предложенное на форуме решение заключалось в том, чтобы удалить ограничение not-null для этого столбца прямо в редакторе таблиц, поскольку node Vector Store заполняет только известные ему поля. Тем, кто отклоняется от Supabase quickstart, согласно документации, следует точно понимать, какие параметры они меняют, поскольку отклонения от стандартного шаблона — самый частый источник ошибок для этого node.

Кому подходит Supabase как комбинированное решение?

Для компаний, которым в любом случае нужна база данных Postgres для основных данных и которые дополнительно планируют внедрить ассистента знаний или чат-бота, Supabase избавляет от необходимости поддерживать отдельный векторный сервис. Тем, кому нужен только простой поиск по сходству без реляционных данных, может оказаться быстрее использовать выделенный Vector Store. NordFlux в клиентских проектах с ассистентами знаний часто делает ставку именно на эту комбинацию Postgres и pgvector, подробнее об этом на /leistungen/ki-agenten.

Часто задаваемые вопросы о Supabase и n8n

Могу ли я использовать один и тот же node Supabase для обычных данных и для векторов?

Нет, в n8n это два отдельных node: обычный node Supabase для операций со строками и node Supabase Vector Store для поиска по сходству и приложений на основе ИИ. Однако оба обращаются к одной и той же базе данных Supabase и могут подключаться с одними и теми же учётными данными.

Нужно ли включать расширение pgvector вручную?

Да, pgvector — это расширение Postgres, которое нужно включить либо через dashboard Supabase, либо с помощью SQL-команды, прежде чем таблица сможет содержать столбец vector. Без этого шага создание таблицы завершится ошибкой.

Что означает отключение старых ключей service_role для существующих workflow в n8n?

По данным Supabase, существующие workflow с ключом service_role пока продолжат работать, но их следует перевести на новый secret key до конца 2026 года. Те, кто своевременно обновит учётные данные в n8n, избегут незапланированного сбоя соединения.

Почему при вставке документов появляется сообщение об ошибке not-null?

Обычно это происходит, когда собственная таблица отличается от схемы quickstart Supabase и содержит обязательный столбец, который node Vector Store не заполняет. Распространённое решение — либо удалить ограничение, либо задать для этого столбца значение по умолчанию в таблице.