Доступные версии документации

Добавить порцию BLOB-данных

Назначение
 

Команда ABLB предназначена для добавления заданной порции BLOB-данных.

Параметры вызова

inter(CBL, NULL, NULL, [CondBuf], RowBuf);

Входные данные

Входными данными являются:

  • контрольный блок CBL;

  • буфер записи RowBuf.

В контрольном блоке должны быть заполнены поля:

Имя поля Значение
NumChan Номер канала
Command "ABLB"
RowId Тип добавляемых данных
LnBufRow Длина буфера записи (размер добавляемой порции данных в байтах)
Node Имя ЛИНТЕР-сервера
RowCount Порядковый номер BLOB-столбца

Буфер записи RowBuf должен содержать добавляемую порцию BLOB-данных.

Выходные данные

Выходными данными является контрольный блок CBL.

В нем будут возвращены:

Имя поля Значение
CodErr Код завершения запроса к СУБД ЛИНТЕР
LnBufRow Фактическая длина буфера выборки данных
SysErr Код состояния ОС
Описание

Максимальный размер порции BLOB-значения – 16*4048 байт.

Максимальный размер BLOB-значения – 2 Гбайт.

Добавляемые данные помещаются в конец BLOB-значений.

При добавлении BLOB-данных СУБД ЛИНТЕР не контролирует тип добавляемых данных, поэтому, если добавляемые порции содержали разные типы BLOB-значения, то они все равно будут добавлены к BLOB-значению; окончательный тип BLOB-значения устанавливается по последней добавленной порции.

Команда ABLB добавляет порцию BLOB-данных к текущему BLOB-значению (BLOB-значению текущей записи выборки данных) в указанном BLOB-столбце записи.

Если номер BLOB-столбца не задан, то поведение команды не определено.

 

Примечание

Команда AOBJ, используемая для добавления порции BLOB-данных в запись с одним BLOB-столбцом (т.е. без указания номера BLOB-столбца), устарела и не рекомендуется для применения.

Текущей записью в канале является последняя выбранная, добавленная или измененная запись. Таким образом, команда ABLB имеет смысл только после выполнения следующих запросов:

  • SELECT;

  • INSERT;

  • UPDATE.

Запросы INSERT и UPDATE должны быть обновляемыми.

Команда ABLB не изменяет текущее положение записи в канале.

Коды завершения
Код Описание
NORMAL Нормальное завершение
ERRPARTBL Размер добавляемой порции больше 16*4048 байтов
EORR Превышен допустимый размер данных BLOB-столбца
ERRSEQCOM Неправильная последовательность команд (команда ABLB подана вне контекста текущего запроса канала)
COLNOTBLOB Заданный столбец не является BLOB-столбцом
ERRVALRANGE Неправильный номер столбца
Пример формирования команды
#include <string.h>
#include <stdlib.h>
#include "inter.h"

L_LONG LinterABLB(TCBL *pCBL, void *Out, L_WORD OutLen, L_WORD numCol)
   {
   memcpy(pCBL->Command, "ABLB", 4);
   pCBL->LnBufRow=OutLen;
   pCBL->RowCount = numCol;
   pCBL->RowId = 1;
   pCBL->PrzExe &= ~Q_ASYNC;
   inter(pCBL, NULL, NULL, NULL, Out);
   return pCBL->CodErr;
   }
Пример использования команды
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter