42P14 1С:Предприятие и СУБД

Ошибка PostgreSQL 42P14: invalid_prepared_statement_definition — Prepared Statements

Обновлено: 26.08.2026 · Официальная документация ↗

Ошибка ERROR: invalid prepared statement definition: ... (SQLSTATE 42P14).
Попытка подготовки запроса, содержащего несовместимые команды управления транзакциями (PREPARE stmt AS BEGIN ...).
Сбои в работе ORM или пулеров соединений при повторной подготовке подготовленных выражений с измененными типами аргументов.

1. Анализ недопустимых выражений внутри PREPARE

Команда PREPARE может использоваться только для запросов SELECT, INSERT, UPDATE, DELETE, MERGE и VALUES. Вызовы DDL или транзакционных команд запрещены:

-- Неверно:
PREPARE p_trans AS COMMIT; -- Ошибка 42P14

-- Корректно:
PREPARE p_get_user(bigint) AS 
SELECT id, login, is_active FROM users WHERE id = $1;

-- Выполнение:
EXECUTE p_get_user(1001);

2. Проверка типов параметров в подготовленном выражении

PREPARE search_docs(text, timestamp with time zone) AS
SELECT * FROM documents 
WHERE doc_number = $1 AND created_at >= $2;

3. Освобождение подготовленных выражений при переподключении

-- Удаление конкретного стейтмента:
DEALLOCATE search_docs;

-- Очистка всех выражений текущей сессии:
DEALLOCATE ALL;

💡 Практика специалистов: Если сервер приложений 1С или внешний коннектор падает с ошибками подготовленных выражений при изменении схемы БД, выполните команду DISCARD ALL или перезапустите рабочий процесс rphost.

Частые вопросы (FAQ)

Как работают Generic Plan и Custom Plan в Prepared Statements?

Первые 5 запусков планировщик строит индивидуальные планы (Custom Plan) под конкретные параметры. Начиная с 6-го запуска, ядро оценивает универсальный план (Generic Plan) и переключается на него, если он не уступает по стоимости.

Почему нельзя использовать PREPARE в PgBouncer с Transaction Pooling?

В режиме Transaction Pooling разные запросы одного клиента выполняются в разных сессиях бэкенда PostgreSQL, где подготовленное выражение не существует (ошибка 26000/42P14).

В чем преимущество подготовленных выражений?

Они устраняют накладные расходы на парсинг и синтаксический анализ SQL-запроса при его многократном выполнении и гарантируют 100% защиту от SQL-инъекций.

Где посмотреть список активных подготовленных выражений сессии?

Сделайте запрос к системному представлению pg_prepared_statements: SELECT * FROM pg_prepared_statements;