更新时间:2022-05-24 GMT+08:00
分享

DBE_LOB

接口介绍

高级功能包DBE_LOB支持的所有接口参见表1

表1 DBE_LOB

接口名称

描述

DBE_LOB.GET_LENGTH

获取并返回指定的LOB类型对象的长度。

DBE_LOB.OPEN

打开一个LOB返回一个LOB的描述符。

DBE_LOB.READ

根据指定的长度及起始位置偏移读取LOB内容的一部分到BUFFER缓冲区。

DBE_LOB.WRITE

根据指定长度及起始位置偏移将BUFFER中内容写入到LOB中。

DBE_LOB.WRITE_APPEND

根据指定长度将BUFFER中内容写入到LOB的尾部。

DBE_LOB.COPY

根据指定长度及起始位置偏移将BLOB内容写入到另一个BLOB中。

DBE_LOB.ERASE

根据指定长度及起始位置偏移删除BLOB中的内容。

DBE_LOB.CLOSE

关闭已经打开的LOB描述符。

DBE_LOB.MATCH

返回一个字符串在LOB中第N次出现的位置。

DBE_LOB.COMPARE

比较两个LOB或者两个LOB的某一部分。

DBE_LOB.SUBSTR

用于读取一个LOB的子串,返回读取的字节个数或者字符个数。

DBE_LOB.STRIP

用于截断指定长度的LOB,执行完会将LOB的长度设置为参数指定的长度。

DBE_LOB.CREATE_TEMPORARY

创建一个临时的BLOB或者CLOB对象。

DBE_LOB.APPEND

将源LOB的内容拼接到目的LOB中。

  • DBE_LOB.GET_LENGTH

    存储过程GET_LENGTH获取并返回指定的LOB类型对象的长度。

    DBE_LOB.GET_LENGTH函数原型为:

    1
    2
    3
    4
    5
    6
    7
    DBE_LOB.GET_LENGTH (
    lob    IN   BLOB)
    RETURN INTEGER;
    
    DBE_LOB.GET_LENGTH (
    lob    IN   CLOB)
    RETURN INTEGER;
    
    表2 DBE_LOB.GET_LENGTH接口参数说明

    参数

    描述

    lob

    待获取长度的BLOB/CLOB类型对象。

  • DBE_LOB.OPEN

    存储过程打开一个LOB,并返回一个LOB描述符,该过程无实际意义,仅用于兼容。

    DBE_LOB.OPEN函数原型为:

    1
    2
    3
    4
    5
    6
    7
    DBE_LOB.OPEN (
    lob    INOUT   BLOB
    );
    
    DBE_LOB.OPEN (
    lob  INOUT    CLOB
    );
    
    表3 DBE_LOB.OPEN接口参数说明

    参数

    描述

    lob

    被打开的BLOB或者CLOB对象。

  • DBE_LOB.READ

    存储过程READ根据指定长度及起始位置偏移读取LOB内容的一部分到BUFFER缓冲区。

    DBE_LOB.READ函数原型为:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    DBE_LOB.READ (
    lob     IN     BLOB,
    len     IN     INTEGER,
    start   IN     INTEGER,
    buffer  OUT    RAW);
    
    DBE_LOB.READ (
    lob     IN     CLOB,
    len     INOUT  INTEGER,
    start   IN     INTEGER,
    buffer  OUT    VARCHAR2);
    
    表4 DBE_LOB.READ接口参数说明

    参数

    说明

    lob

    待读入的BLOB/CLOB类型对象。

    len

    读入长度。

    说明:

    如果读入长度为负,会收到错误提示“ERROR: argument 2 is null, invalid, or out of range.”

    start

    指定从LOB内容的哪个位置开始读取的偏移(即相对LOB内容起始位置的字节数)。

    buffer

    读取LOB内容后存放的目标缓冲区。

  • DBE_LOB.WRITE

    存储过程WRITE根据指定长度及起始位置将BUFFER中内容写入到LOB变量中。

    DBE_LOB.WRITE函数原型为:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    DBE_LOB.WRITE (
    dest_lob   INOUT    BLOB,
    len        IN       INTEGER,
    start      IN       INTEGER,
    src_lob    IN       RAW);
    
    DBE_LOB.WRITE (
    dest_lob   INOUT   CLOB,
    len        IN       INTEGER,
    start      IN       INTEGER,
    src_lob    IN       VARCHAR2);
    
    表5 DBE_LOB.WRITE接口参数说明

    参数

    说明

    dest_lob

    待写入的BLOB/CLOB类型对象。

    len

    写入长度。

    说明:

    如果写入长度小于1或写入长度大于待写入的内容长度,则报错。

    start

    指定从LOB内容的哪个位置开始写入的偏移(即相对LOB内容起始位置的字节数)。

    说明:

    如果偏移量小于1,则报错;如果偏移量大于LOB类型最大长度时,不会报错。

    src_lob

    待写入的内容。

  • DBE_LOB.WRITE_APPEND

    存储过程WRITE_APPEND根据指定长度将BUFFER中内容写入到LOB的尾部。

    DBE_LOB.WRITE_APPEND函数原型为:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    DBE_LOB.WRITE_APPEND (
    dest_lob    INOUT    BLOB,
    len         IN        INTEGER,
    src_lob     IN        RAW);
    
    DBE_LOB.WRITE_APPEND (
    dest_lob    INOUT     CLOB,
    len         IN        INTEGER,
    src_lob     IN        VARCHAR2);
    
    表6 DBE_LOB.WRITE_APPEND接口参数说明

    参数

    说明

    dest_lob

    待写入的指定BLOB/CLOB类型对象。

    len

    写入长度。

    说明:

    如果写入长度小于1或写入长度大于待写入的内容长度,则报错。

    src_lob

    待写入的内容。

  • DBE_LOB.COPY

    存储过程COPY根据指定长度及起始位置偏移将BLOB内容拷贝到另一个BLOB中。

    DBE_LOB.COPY函数原型为:

    1
    2
    3
    4
    5
    6
    DBE_LOB.COPY (
    dest_lob     INOUT    BLOB,
    src_lob      IN        BLOB,
    len          IN        INTEGER,
    dest_start   IN        INTEGER  DEFAULT 1,
    src_start    IN        INTEGER  DEFAULT 1);
    
    表7 DBE_LOB.COPY接口参数说明

    参数

    说明

    dest_lob

    待拷入的BLOB类型对象。

    src_lob

    待拷出的BLOB类型对象。

    len

    拷贝长度。

    说明:

    如果拷入长度小于1或拷入长度大于BLOB类型最大长度,则报错。

    dest_start

    指定从BLOB内容的哪个位置开始拷入的偏移(即相对BLOB内容起始位置的字节数)。

    说明:

    如果偏移量小于1或偏移量大于BLOB类型最大长度,则报错。

    src_start

    指定从BLOB内容的哪个位置开始拷出的偏移(即相对BLOB内容起始位置的字节数)。

    说明:

    如果偏移量小于1或偏移量大于拷贝来源BLOB的长度,则报错。

  • DBE_LOB.ERASE

    存储过程ERASE根据指定长度及起始位置偏移删除BLOB中的内容。

    DBE_LOB.ERASE函数原型为:

    1
    2
    3
    4
    DBE_LOB.ERASE (
    lob        INOUT   BLOB,
    len        INOUT   INTEGER,
    start      IN       INTEGER DEFAULT 1);
    
    表8 DBE_LOB.ERASE接口参数说明

    参数

    说明

    lob

    待删除内容的BLOB类型对象。

    len

    待删除的长度。

    说明:

    如果删除长度小于1或删除长度大于BLOB类型最大长度,则报错。

    start

    指定从BLOB内容的哪个位置开始删除的偏移(即相对BLOB内容起始位置的字节数)。

    说明:

    如果偏移量小于1或偏移量大于BLOB类型最大长度,则报错。

  • DBE_LOB.CLOSE

    存储过程CLOSE根据指定长度及起始位置偏移关闭已经打开的LOB内容。

    DBE_LOB.CLOSE函数原型为:

    1
    2
    3
    4
    5
    DBE_LOB.CLOSE(
    lob      IN      BLOB);
    
    DBE_LOB.CLOSE (
    lob      IN      CLOB);
    
    表9 DBE_LOB.CLOSE接口参数说明

    参数

    说明

    lob

    待关闭的BLOB/CLOB类型对象。

  • DBE_LOB.MATCH

    该函数返回pattern在LOB中第N次出现的位置,如果输入的是一些无效值会返回NULL值。offset < 1 or offset > LOBMAXSIZE,nth < 1,nth > LOBMAXSIZE。

    DBE_LOB.MATCH函数原型为:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    DBE_LOB.MATCH (
    lob              IN     BLOB,
    pattern          IN     RAW,
    start_index      IN     INTEGER  DEFAULT 1,
    match_index      IN     INTEGER  DEFAULT 1)
    RETURN INTEGER;
    
    DBE_LOB.INSTR (
    lob              IN     CLOB,
    pattern          IN     VARCHAR2 ,
    start_index      IN     INTEGER  DEFAULT 1,
    match_index      IN     INTEGER  DEFAULT 1)
    RETURN INTEGER;
    
    表10 DBE_LOB.match接口参数说明

    参数

    说明

    lob

    要查找的BLOB/CLOB描述符。

    pattern

    要匹配的模式,对于BLOB是由一组RAW类型的数据组成,对于CLOB是由一组text类型的数据组成。

    start_index

    对于BLOB是以字节为单位的绝对偏移量,对于CLOB是以字符为单位的偏移量,模式匹配的起始位置是1。

    match_index

    模式匹配的次数,最小值为1。

  • DBE_LOB.COMPARE

    这个函数比较两个LOB或者两个LOB的一部分。

    • 如果比较的结果相等返回0,否则返回非零的值。
    • 如果第一个LOB比第二个小,返回-1;如果第一个LOB比第二个大,返回1。
    • 如果len,start1,start2这几个参数有无效参数返回NULL,有效的偏移量范围是1~LOBMAXSIZE。

    DBE_LOB.COMPARE函数原型为:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    DBE_LOB.COMPARE (
    lob1     IN     BLOB,
    lob2     IN     BLOB,
    len      IN     INTEGER DEFAULT DBE_LOB.LOBMAXSIZE,
    start1   IN     INTEGER DEFAULT 1,
    start2   IN     INTEGER DEFAULT 1)
    RETURN INTEGER;
    
    DBE_LOB.COMPARE (
    lob1     IN     CLOB,
    lob2     IN     CLOB,
    len      IN     INTEGER DEFAULT DBE_LOB.LOBMAXSIZE,
    start1   IN     INTEGER DEFAULT 1,
    start2   IN     INTEGER DEFAULT 1)
    RETURN INTEGER;
    
    表11 DBE_LOB.COMPARE接口参数说明

    参数

    说明

    lob1

    第一个要比较的BLOB/CLOB类型对象。

    lob2

    第二个要比较的BLOB/CLOB类型对象。

    len

    要比较的字符数或者字节数,最大值为DBE_LOB.LOBMAXSIZE。

    start1

    第一个LOB描述符的偏移量,初始位置是1。

    start2

    第二个LOB描述符的偏移量,初始位置是1。

  • DBE_LOB.SUBSTR

    用于读取一个LOB的子串,返回读取的字节个数或者字符个数,当amount > 1或者amount < 32767,offset < 1或者offset > LOBMAXSIZE的时候返回值是NULL。

    DBE_LOB.SUBSTR函数原型为:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    DBE_LOB.SUBSTR (
    lob        IN     BLOB,
    len        IN     INTEGER DEFAULT  32767,
    start      IN     INTEGER DEFAULT  1)
    RETURN RAW;
    
    DBE_LOB.SUBSTR (
    lob        IN     CLOB,
    len        IN     INTEGER DEFAULT  32767,
    start      IN     INTEGER DEFAULT  1)
    RETURN VARCHAR2;
    
    表12 DBE_LOB.SUBSTR接口参数说明

    参数

    说明

    lob

    将要读取子串的LOB描述符,对于BLOB类型的返回值是读取的字节个数,对于CLOB类型的返回值是字符个数。

    len

    要读取的字节数或者字符数量。

    start

    从开始位置偏移的字符数或者字节数量。

  • DBE_LOB.STRIP

    这个存储过程用于截断指定长度的LOB,执行完这个存储过程会将LOB的长度设置为newlen参数指定的长度。如果对一个空的LOB执行截断操作,不会有任何执行结果;如果指定的长度比LOB的长度长,会产生一个异常。

    DBE_LOB.STRIP函数原型为:

    1
    2
    3
    4
    5
    6
    7
    DBE_LOB.STRIP (
    lob       IN OUT     BLOB,
    newlen    IN       INTEGER);
    
    DBE_LOB.TRIM (
    lob       IN         OUT CLOB,
    newlen    IN        INTEGER);
    
    表13 DBE_LOB.STRIP接口参数说明

    参数

    说明

    lob

    待读入的指定BLOB类型对象。

    newlen

    截断后LOB的新长度,对于BLOB是字节数,对于CLOB是字符数。

  • DBE_LOB.CREATE_TEMPORARY

    这个存储过程创建一个临时的BLOB或者CLOB,这个存储过程仅用于语法上的兼容,并无实际意义。

    DBE_LOB.CREATE_TEMPORARY函数原型为:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    DBE_LOB.CREATE_TEMPORARY (
    locator           INOUT      BLOB,
    cache             IN         BOOLEAN,
    keep_alive_time   IN         INTEGER);
    
    DBE_LOB.CREATE_TEMPORARY (
    locator           INOUT      CLOB,
    cache             IN         BOOLEAN,
    keep_alive_time   IN         INTEGER);
    
    表14 DBE_LOB.CREATE_TEMPORARY接口参数说明

    参数

    说明

    locator

    LOB描述符。

    cache

    仅用于语法上的兼容。

    keep_alive_time

    仅用于语法上的兼容。

  • DBE_LOB.APPEND

    存储过程APPEND根据指定长度及起始位置偏移读取BLOB内容的一部分到BUFFER缓冲区。

    DBE_LOB.APPEND函数原型为:

    1
    2
    3
    4
    5
    6
    7
    DBE_LOB.APPEND (
    dest_lob    INOUT       BLOB,
    src_lob     IN          BLOB);
    
    DBE_LOB.APPEND (
    dest_lob    INOUT       CLOB,
    src_lob     IN          CLOB);
    
    表15 DBE_LOB.APPEND接口参数说明

    参数

    说明

    dest_lob

    要写入的BLOB/CLOB对象。

    src_lob

    读取的BLOB/CLOB对象。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
--获取字符串的长度
SELECT DBE_LOB.GET_LENGTH('12345678');

DECLARE
myraw  RAW(100);
amount INTEGER :=2;
buffer INTEGER :=1;
begin
DBE_LOB.READ('123456789012345',amount,buffer,myraw);
dbe_output.print_line(myraw);
end;
/

CREATE TABLE blob_Table (t1 blob) DISTRIBUTE BY REPLICATION;
CREATE TABLE blob_Table_bak (t2 blob) DISTRIBUTE BY REPLICATION;
INSERT INTO blob_Table VALUES('abcdef');
INSERT INTO blob_Table_bak VALUES('22222');

DECLARE
str varchar2(100) := 'abcdef';
source raw(100);
dest blob;
copyto blob;
amount int;
PSV_SQL varchar2(100);
PSV_SQL1 varchar2(100);
a int :=1;
len int;
BEGIN
source := dbe_raw.cast_from_varchar2_to_raw(str);
amount := dbe_raw.get_length(source);

PSV_SQL :='select * from blob_Table for update';
PSV_SQL1 := 'select * from blob_Table_bak for update';

EXECUTE IMMEDIATE PSV_SQL into dest;
EXECUTE IMMEDIATE PSV_SQL1 into copyto;

DBE_LOB.WRITE(dest, amount, 1, source);
DBE_LOB.WRITE_APPEND(dest, amount, source);

DBE_LOB.ERASE(dest, a, 1);
DBE_OUTPUT.PRINT_LINE(a);
DBE_LOB.COPY(copyto, dest, amount, 10, 1);
DBE_LOB.CLOSE(dest);
RETURN;
END;
/

--删除表
DROP TABLE blob_Table;
DROP TABLE blob_Table_bak;
分享:

    相关文档

    相关产品

close