ЛИНТЕР

Командный режим

Формат

 BLOB {INSERT | CLEAR | APPEND | GET}
{ROWID=< rowid записи > [< имя пользователя >.]< имя таблицы >.< имя столбца >
|COLUMN=< номер столбца >}
[TYPE=< тип BLOB-данных >]{FILE=< имя файла > | < BLOB-значение >}
< BLOB-значение >:=непрерывная последовательность шестнадцатеричных цифр
< тип BLOB-данных >::=целочисленное значение

Назначение

Выполнение основных операций с BLOB-данными в командном режиме.

Описание

Команда CLEAR очищает BLOB-значение.

Команда APPEND добавляет порцию BLOB-данных в конец BLOB-значения.

Команда INSERT эквивалентна последовательности команд CLEAR и APPEND.

Команда GET извлекает BLOB-значение. В этой команде имя пользователя можно не указывать (выполняется обращение к таблице текущего пользователя).

Опция TYPE задает тип добавляемых BLOB-данных. Учитывается только при выполнении команды BLOB INSERT.

Если задана опция COLUMN, все операции с BLOB-данными применяются к указанному столбцу текущей записи последней DML-операции. Отсчет столбцов начинается с 1.

Если задана опция ROWID, все операции с BLOB-данными применяются к столбцу < имя столбца > в указанной в < rowid записи > записи последнего выполненного SQL-запроса (выборки). В этом случае, при необходимости, будет выполнен отдельный select-запрос для получения записи с указанным < rowid записи >.

В командах INSERT и APPEND параметр < имя файла > задает спецификацию файла содержащего добавляемые (в бинарном виде) BLOB-данные.

В команде GET параметр < имя файла > задает спецификацию файла, в который должны быть записаны (в бинарном виде) извлекаемые BLOB-данные. Если спецификация файла не задана, BLOB-данные будут извлекаться СУБД ЛИНТЕР в текстовом виде в стандартный выходной поток с помощью функции printf.

Имена пользователей, таблиц и столбцов в команде могут задаваться в двойных кавычках.

Если спецификация файла (путь и/или имя) содержат пробелы и/или символы кириллицы, то её необходимо обрамлять двойными кавычками, а двойные кавычки в именах – экранировать, например,

SQL > blob insert column=2 file="с:\Program files\Film.avi";
SQL >blob insert column=2 file="с:\Коллекция музыки\Группировка\"Ленинград\".mp3";

Для инициализации добавления BLOB-порций необходимо использовать NULL-значение, а не пустую строку.

Например,

1) в этом случае  будет добавлена порция BLOB-данных c предшествующим пробелом,
 т.е.  NBL1.SQL = < пробел > + NBL.SQL
username SYSTEM/MANAGER8
  create or replace table tbl(i int, b blob);
  insert into tbl values(1, '');
  blob append column=2 file=NBL.SQL;
  blob get rowid=1 system.TBL.B file=NBL1.SQL;

2) в этом случае добавленная и считанная порции BLOB-данных будут идентичными:
NBL1.SQL =  NBL1.SQL
username SYSTEM/MANAGER8
  create or replace table tbl(i int, b blob);
  insert into tbl values(1, NULL);
  blob append column=2 file=NBL.SQL;
  blob get rowid=1 system.TBL.B file=NBL1.SQL;

Данные в BLOB-файл добавляются порциями, максимальный размер – 16*4048 байт. Если добавляемое BLOB-значение превышает максимальный размер порции, то оно будет добавляться несколькими порциями. При работе в режиме autocommit после вставки каждой порции будет подана команда COMMIT.

Примеры

username SYSTEM/MANAGER8
create or replace table test(i int, bl1 blob, bl2 blob);
insert into test(i,bl1,bl2) values(1,NULL,NULL);
blob insert column=2 333333ABCD;
blob append column=3 444444ABCD;
select rowid, i, lenblob(bl1), getblob(bl1,1,5), lenblob(bl2), getblob(bl2,1,5)
 from TEST;
blob clear rowid=1 system.TEST.BL1;
blob append rowid=1 SYSTEM."TEST".bl2 ffffff;
!blob 1:
blob get rowid=1 system.TEST.BL1;
!blob 2:
blob get rowid=1 system.TEST.BL2;
!blob to file "blob.txt" (8 bytes):
blob get rowid=1 system.TEST.BL2 file=blob.txt;
insert into test(i,bl1) values(2,NULL);
!read blob from file:
blob append column=2 file=blob.txt;
!check blob value:
blob get rowid=2 system.TEST.BL1;

Результат работы примера:

ROWID       I
 -----       -
|          1|          1|          5| 33 33 33 AB CD|          5| 44 44 44 AB CD|
blob 1:
blob 2:
444444ABCDFFFFFF

create or replace table test_findrtf(b_rtf blob,b_pdf blob,b_doc
blob,b_xls blob,b_ppt blob,b_ps blob);
insert into test_findrtf values(NULL,NULL,NULL,NULL,NULL,NULL);

blob insert column=1 file=1.rtf
blob insert column=2 file=1.pdf
blob insert column=3 file=1.doc
blob insert column=4 file=1.xls
blob insert column=5 file=1.ppt
blob insert column=6 file=1.ps
select * from test_findrtf;

username SYSTEM/MANAGER8
create or replace table test(i int, bl1 blob, bl2 blob);
insert into test(i,bl1,bl2) values(1,NULL,NULL);
!insert (1,1):
blob insert column=2
1
11
111
abcd;
!append (1,2):
blob append column=3 222222ABCD;
select rowid, i, lenblob(bl1), getblob(bl1,1,5), lenblob(bl2), getblob(bl2,1,5)
 from TEST;
insert into test(i,bl1,bl2) values(2,NULL,NULL);
!insert (2,1):
blob insert column=2 333333ABCD;
!append (2,2):
blob append column=3 444444ABCD;
select rowid, i, lenblob(bl1), getblob(bl1,1,5), lenblob(bl2), getblob(bl2,1,5)
 from TEST;
!get blobs, row 1:
select i, bl1, bl2 from TEST where rowid=1;
blob get column=2;
blob get column=3;
!get blobs, row 2:
select i, bl1, bl2 from TEST where rowid=2;
blob get column=2;
blob get column=3;
!clear (1,1):
blob clear rowid=1 system.TEST.BL1;
!clear (2,2):
blob clear rowid=2 system.TEST.BL2;
select rowid, i, lenblob(bl1), getblob(bl1,1,5), lenblob(bl2), getblob(bl2,1,5)
 from TEST;
!append (1,2):
blob append rowid=1 SYSTEM."TEST".bl2
000
0001234;
!insert (2,1):
blob insert rowid=2 SYSTEM."TEST".bl1
000012
3456;
select rowid, i, lenblob(bl1), getblob(bl1,1,5), lenblob(bl2), getblob(bl2,1,10)
 from TEST;
!get blob (1,2):
blob get rowid=1 SYSTEM."TEST".bl2;
!get blob (2,1):
blob get rowid=2 SYSTEM."TEST".bl1;

create or replace table test(i int, bl1 blob, bl2 blob);
insert into test(i,bl1,bl2) values(1,NULL,NULL);
blob insert column=2 type=101 111111abcd;
blob insert column=3 type=111 111111abcdef;
insert into test(i,bl1,bl2) values(2,NULL,NULL);
blob insert rowid=2 SYSTEM."TEST".bl1 type=201 111111abcd;
blob insert rowid=2 SYSTEM."TEST".bl2 type=211 111111abcdef;