Oracle中DBMS_LOB包使用小结

万望

本文主要介绍数据库中dbms_lob包的使用以及使用dbms_lob包来维护lob数据库类型的基本方法。随着社会的发展，在现代信息系统的开发中，需要存储的已不仅仅是简单的文字信息，同时还包括一些图片和音像资料或者是超长的文本。比如开发一套旅游信息系统，每一个景点都有丰富的图片、音像资料和大量的文字介绍。这就要求后台数据库要有存储这些数据的能力。ORACLE公司在其Oracle8i中通过提供LOB字段实现了该功能。

在ORACLE数据库中，LOB大对象类型是用来存储大量的二进制和文本数据的一种数据类型（一个LOB字段可存储可多达4GB的数据）。目前，它又分为两种类型：内部LOB和外部LOB。内部LOB将数据以字节流的形式存储在数据库的内部。因而，内部LOB的许多操作都可以参与事务，也可以像处理普通数据一样对其进行备份和恢复操作。Oracle8i支持三种类型的内部LOB：BLOB（二进制数据）、CLOB（单字节字符数据）、NCLOB（多字节国家字符数据）。其中CLOB和NCLOB类型适用于存储超长的文本数据，BLOB字段适用于存储大量的二进制数据，如图像、视频、音频等。目前，Oracle8i只支持一种外部LOB类型，即BFILE类型。在数据库内，该类型仅存储数据在操作系统中的位置信息，而数据的实体以外部文件的形式存在于操作系统的文件系统中。因而，该类型所表示的数据是只读的，不参与事务。该类型可帮助用户管理大量的由外部程序访问的文件。

为了方便下文的叙述，我们假定使用如下语句在数据库中创建了一张表。

1. CREATE TABLE view_sites_info(
   
2. site_id NUMBER(3),
   
3. audio BLOB DEFAULT empty_blob(),
   
4. DOCUMENT CLOB DEFAULT empty_clob(),
   
5. video_file BFILE DEFAULT NULL,
   
6. CONSTRAINT PK_TAB_view_sites_info PRIMARY KEY (site_id));

复制代码

ORACL提供了多种使用和维护LOB的方式，如使用PL/SQL DBMS_LOB包、调用OCI（Oracle Call Interface）、使用Proc*C/C++、使用JDBC等。其中最为方便有效的是使用PL/SQL调用DBMS_LOB包，本文就将介绍该方法。在Oracle中，存储在LOB中数据称为LOB的值，如使用Select对某一LOB字段进行选择，则返回的不是LOB的值，而是该LOB字段的定位器（可以理解为指向LOB值的指针）。如执行如下的SQL语句：

1. DECLARE
   
2.   audio_info BLOB;
   
3. BEGIN
   
4.   SELECT audio
   
5.     INTO audio_info
   
6.     FROM view_sites_info
   
7.    WHERE site_id = 100;
   
8. END;

复制代码

存储在AUDIO_INFO变量中的就是LOB定位器，而不是LOB的值。而要对某一LOB的值进行访问和维护操作，必需通过其定位器来进行。DBMS_LOB包中提供的所有函数和过程都以LOB定位器作为参数。

DBMS_LOB包中主要提供了以下几个过程供用户对内部LOB字段进行维护：

APPEND：将源LOB中的内容加到目的LOB中。

CLOSE：关闭已经打开的LOB。

CREATETEMPORARY：在用户的临时表空间中，建立临时LOB。

FILECLOSE：关闭打开的BFILE定位符所指向的OS文件。

FILECLOSEALL：关闭当前会话已经打开的所有BFILE文件。

FILEEXISTS：确定file_loc对应的OS文件是否存在，1：存在。0：不存在。

FILEGETNAME：获取BFILE定位符所对应的目录别名和文件名。

FILEISOPEN：确定BFILE对应的OS文件是否打开。

FREETEMPORARY：释放在默认临时表空间中的临时LOB。

FILEOPEN：打开文件。

GETCHUNKSIZE：当建立包含CLOB/BLOB列的表时，通过指定CHUNK参数可以指定操纵LOB需要分配的字节数（数据库尺寸的整数倍）默认为数据块的尺寸。

COPY：从源LOB中复制数据到目的LOB。

ERASE：删除LOB中全部或部分内容。

TRIM：将LOB值减少到指定的长度。

WRITE：向LOB中写入数据。

INSTR：返回特定样式数据从LOB某偏移位置开始出现N次的具体位置。

IDOPEN：确定LOB是否打开，打开：1，未打开：0。

ISTEMPORARY：确定定位符是否为临时LOB。

LOADFROMFILE：将BFILE的部分或全部内容复制到目标LOB变量。

LOADBLOBFROMFILE：将BFILE数据装载到BLOB中，并且在装载后取得最新的偏移位置。

OPEN：打开LOB，open_mode（只读：dbms_lob.lob_readonly，写：dbms_lob.lob_readwrite）。

COMPARE：比较两个同种数据类型的LOB的部分或全部值是否相同。

GETLENGTH：获取LOB的长度。

READ：从LOB中读出数据。

SUBSTR：与字符处理函数SUBSTR使用方法一样。

WRITEAPPEND：将缓冲区数据写到LOB尾部。

下面我们以最为常用的读和写为例详细介绍这些过程的用法。首先介绍一下写过程。该过程的语法为：

1. PROCEDURE WRITE(lob_loc IN OUT BLOB,
   
2.                 amount  IN BINARY_INTEGER,
   
3.                 offset  IN INTEGER,
   
4.                 buffer  IN RAW);
   
5. PROCEDURE WRITE(lob_loc IN OUT CLOB CHARACTER SET any_cs,
   
6.                 amount  IN BINARY_INTEGER,
   
7.                 offset  IN INTEGER,
   
8.                 buffer  IN VARCHAR2 CHARACTER SET lob_loc%charset);

复制代码

各参数的含义为：

lob_loc：要写入的LOB定位器。

amount：写入LOB中的字节数。

offset：指定开始操作的偏移量。

buffer：指定写操作的缓冲区。

下面的代码就是运用该过程向LOB字段写入数据的示例：

1. DECLARE
   
2.   lobloc CLOB;
   
3.   buffer VARCHAR2(2000);
   
4.   amount NUMBER := 20;
   
5.   offset NUMBER := 1;
   
6. BEGIN
   
7.   --初始化要写入的数据   
   
8.   buffer := 'This is a writing example';
   
9.   amount := length(buffer);
   
10.   SELECT document
    
11.     INTO lobloc --   获取定位器并锁定行   
    
12.     FROM view_sites_info
    
13.    WHERE site_id = 100
    
14.      FOR UPDATE;
    
15.   dbms_lob.write(lobloc,
    
16.                  amount,
    
17.                  1,
    
18.                  buffer);
    
19.   COMMIT;
    
20. END;

复制代码

需要特别指出的是：

（1）在调用写过程前一定要使用SELECT语句检索到定位器且用FOR UPDATE子句锁定行，否则不能更新LOB。

（2）写过程从offset指定的位置开始，向LOB中写入长度为amount的数据，原LOB中在这个范围内的任何数据都将被覆盖。

（3）缓冲区的最大容量为32767字节，因此在写入大量数据时需多次调用该过程。

下面再来介绍一下读过程，该过程的语法为：

1. PROCEDURE READ(lob_loc IN BLOB,
   
2.                amount  IN OUT BINARY_INTEGER,
   
3.                offset  IN INTEGER,
   
4.                buffer  OUT RAW);
   
5. PROCEDURE READ(lob_loc IN CLOB CHARACTER SET any_cs,
   
6.                amount  IN OUT BINARY_INTEGER,
   
7.                offset  IN INTEGER,
   
8.                buffer  OUT VARCHAR2 CHARACTER SET lob_loc%charset);

复制代码

各参数的含义为：

lob_loc：要读取的LOB定位器。

amount：要读取的字节数。

offset：开始读取操作的偏移量。

buffer：存储读操作结果的缓冲区。

下面的代码演示了如何使用该过程读取LOB字段中的数据：

1. DECLARE
   
2.   lobloc CLOB;
   
3.   buffer VARCHAR2(2000);
   
4.   amount NUMBER := 2;
   
5.   offset NUMBER := 6;
   
6. BEGIN
   
7.   SELECT document
   
8.     INTO lobloc --获取定位器   
   
9.     FROM lob_store
   
10.    WHERE lob_id = 100;
    
11.   dbms_lob.read(lobloc,
    
12.                 amount,
    
13.                 offset,
    
14.                 buffer); --读取数据到缓冲区   
    
15.   dbms_output.put_line(buffer); --显示缓冲区中的数据   
    
16.   COMMIT;
    
17. END;

复制代码

append存储过程用于将一个大对象添加到另一个大对象中，此时是将源大对象的内容全部添加过去。append存储过程的语法如下：

1. PROCEDURE append(dest_lob IN OUT NOCOPY BLOB,
   
2.                  src_lob  IN BLOB);
   
3. PROCEDURE append(dest_lob IN OUT NOCOPY CLOB CHARACTER SET any_cs,
   
4.                  src_lob  IN CLOB CHARACTER SET dest_lob%charset);

复制代码

其中，各个参数的含义如下：

dest_lob是被源lob添加到的目标lob的定位器。

src_lob是源lob的定位器。

any_cs用来指定字符集。

张兴康

陈晓龙

陈晓龙

fteair