ЛИНТЕР

Модификация подстроки BLOB-данных (SET/INSERT)

Функция

Модификация заданной подстроки BLOB-данных с помощью SQL-запросов UPDATE и UPDATE CURRENT.

Спецификация

<модификация порции BLOB-данных>::=

SET столбец=спецификация модифицируемой порции

<спецификация модифицируемой порции>::=

INSERT (столбец, позиция, длина, подстрока)

<столбец>::=

идентификатор

<подстрока>::=

символьное выражение|байтовое выражение

Синтаксические правила

<Символьное выражение> в аргументе может иметь следующий тип данных: CHAR, VARCHAR, NCHAR, NCHAR VARYING, BYTE, VARBYTE.
Длина <подстроки> не должна быть более 4000.
<Позиция> задает позицию в байтах заменяемой подстроки в <столбце>. Отсчет начинается с 1. Если BLOB-столбец имеет кодовую страницу UNICODE, то <позиция> не может быть чётной, в противном случае выдаётся код завершения 1036 («Значение аргумента в недопустимом диапазоне»).
<Длина> задает длину заменяемой подстроки в <столбце> в байтах. Если BLOB-столбец имеет кодовую страницу UNICODE, то <позиция> не может быть нечётной, в противном случае выдаётся код завершения 1036 («Значение аргумента в недопустимом диапазоне»).
<Подстрока> задает значение, вставляемое вместо удаленной подстроки.
Если <подстрока> имеет символьный тип данных (CHAR, VARCHAR, NCHAR, NCHAR VARYING), она автоматически перекодируется в кодовую страницу, заданную для BLOB-столбца. Если <подстрока> имеет байтовый тип данных, она будет использоваться «как есть».

Аргументы <позиция>, <длина> и <подстрока> могут быть заданы <SQL-параметром>, который должен содержать спецификацию типа данных параметра.

create or replace table test(bl blob character set "UCS2");
insert into test(bl) values('0123456789 aaa 0123456789');

select lenblob(bl), getblobstr(bl, 1, 60) from test;
|         50|0123456789 aaa 0123456789|

update test set bl=insert(bl, ? (int), ? (int), ? (char(2)));
3
2
aa

select lenblob(bl), getblobstr(bl, 1, 60) from test;
|         50|01aa456789 aaa 0123456789|

Общие правила

Начиная с <позиции>, в BLOB-столбце удаляется <длина> байт, и на их место вставляются символы или байты <подстроки>.
Если будет предпринята попытка заменить часть BLOB-данных на порцию, <длина> которой в байтах отличается от заменяемой части, то будет выдан код завершения 1721 («Неверное смещение в странице BLOB»).

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

Отсутствует. Если значения аргументов функции правильные, выполняется корректировка BLOB-данных, в противном случае BLOB-данные не изменяются.

Пример

create or replace table test(bl blob character set "UCS2");
insert into test(bl) values('0123456789 aaa 0123456789');
select lenblob(bl), getblobstr(bl, 1, 60) from test;
|         50|0123456789 aaa 0123456789|

update test set bl=insert(bl, 3, 2, 'aa');
select lenblob(bl), getblobstr(bl, 1, 60) from test;
|         50|01aa456789 aaa 0123456789|

update test set bl=insert(bl, 5, 3, HEX('310031003100'));
select lenblob(bl), getblobstr(bl, 1, 60) from test;
|         50|01aa111789 aaa 0123456789|

Примечание

В конструкции «bl=insert(bl, 3, 10, 'aa')» часть «bl=» является вспомогательной, то есть реального присвоения не происходит, а собственно модификация BLOB-данных осуществляется внутри функции INSERT.