ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

5.10.1.14. SPI_execute_plan

Содержание

5.10.1.14. SPI_execute_plan

SPI_execute_plan — выполнить оператор, подготовленный функцией SPI_prepare

Синтаксис

int SPI_execute_plan(SPIPlanPtr plan, Datum * values, const char * nulls,
                     bool read_only, long count)

Описание

SPI_execute_plan выполняет оператор, подготовленный функцией SPI_prepare или одной из родственных ей функций. read_only и count имеют ту же интерпретацию, что и в SPI_execute.

Аргументы

SPIPlanPtr plan

подготовленное выражение (возвращаемое SPI_prepare)

Datum * values

Массив фактических значений параметров. Должен иметь ту же длину, что и количество аргументов оператора.

const char * nulls

Массив, определяющий, какие параметры имеют значение null. Должен иметь ту же длину, что и количество аргументов оператора.

Если nulls имеет значение NULL то SPI_execute_plan предполагает, что ни один из параметров не равен null. В противном случае каждый элемент массива nulls должен иметь значение ' ' , если соответствующее значение параметра не равно null, или 'n' , если соответствующее значение параметра равно null. (В последнем случае фактическое значение в соответствующем элементе values не имеет значения.) Обратите внимание, что nulls не является текстовой строкой, а представляет собой просто массив: ему не требуется '\0' символ завершения.

bool read_only

true для выполнения в режиме «только чтение»

long count

максимальное количество строк для возврата или 0 для отсутствия ограничений

Возвращаемое значение

Возвращаемое значение такое же, как и для SPI_execute, со следующими дополнительными возможными отрицательными результатами (кодами ошибок):

SPI_ERROR_ARGUMENT: если plan имеет значение NULL или недействителен, или count меньше 0
SPI_ERROR_PARAM: если values имеет значение NULL и plan был подготовлен с определёнными параметрами

SPI_processed и SPI_tuptable устанавливаются так же, как в SPI_execute в случае успеха.

Наверх