Функция sqlFetchInto

Назначение

Считать подготовленный запрос в таблицу (например, в таблицу в памяти).

Загрузка полученной выборки в таблицу управляется логической таблицей интерфейса. Поэтому количество полей таблицы, выбранных в логической таблице (т.е. перечисленных в конструкции select ЛТ), и их порядок в ЛТ должны совпадать с количеством полей, выбранных в конструкции select запроса прямого SQL, и их порядком.

Начиная с Атлантис 5.4.22 выполняется контроль количества полей, перечисленных в ЛТ для загружаемой таблицы и в выборке DSQL. При их несовпадении функция возвращает ошибку tsDirectSQLIfcError.

Корректность порядка и типов выбираемых полей не производится. Т.о. если будет непреодолимая некорректность, то не сработает встроенный в клиенты СУБД конвертор типов данных, и выдастся ошибка, которая и вернётся в качестве результата выполнения функции.

Описание

function sqlFetchInto(stmt : longint; iTable : integer) : integer;

Параметры

stmt - хендл запроса (см. sqlAllocStmt).

iTable - код таблицы.

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

Функция возвращает код ошибки. В т.ч. при несовпадении количества полей в ЛТ и в выборке функция возвращает ошибку tsDirectSQLIfcError.

Версия

Контроль количества полей, перечисленных в ЛТ для загружаемой таблицы и в выборке DSQL, выполняется начиная с Атлантис 5.4.22.

Начиная с Атлантис 5.2.07.