IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

Replace


图象 音频 视频
X X X

更新存储在数据库中的图象、音频或视频的内容,并更新其注解。

包含文件

图象 (image)
dmbimage.h

音频 (audio)
dmbaudio.h

视频 (video)
dmbvideo.h

语法

从缓冲区或客户机文件更新内容, 并更新注解

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_file--,--comment--)--------------------------------><
 

语法

从服务器文件更新内容,并更新注解

>>-Replace--(--handle--,--source_file--,--source_format--,--stortype--,-->
 
>---comment--)-------------------------------------------------><
 

包含文件

从缓冲区或客户机文件更新具有用户提供的属性的内容, 并更新注解

>>-Replace--(--handle--,--content--,--target_file--,------------>
 
>----comment--,--attrs--,--thumbnail--)------------------------><
 

包含文件

从服务器文件更新具有用户提供的属性的内容, 并更新注解

>>-Replace--(--handle--,--source_file--,--stortype--,--comment--,-->
 
>---attrs--,--thumbnail--)-------------------------------------><
 

语法

从缓冲区或客户机文件更新内容, 并进行格式转换以及更新注解-仅适用于图象

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_format--,--target_file--,--comment--)--------------><
 

语法

从服务器文件更新内容,进行格式转换, 并更新注解 - 仅适用于图象

>>-Replace--(--handle--,--source_file--,--source_format--,------>
 
>----target_format--,--target_file--,--comment--)--------------><
 

语法

从缓冲区或客户机文件更新内容, 进行格式转换和其他更改,并更新注解-仅适用于图象

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_format--,--target_file--,--conversion_options--,---->
 
>----comment--)------------------------------------------------><
 

语法

从服务器文件更新内容, 并进行格式转换、附加更改和更新注解 - 仅适用于图象

>>-Replace--(--handle--,--source_file--,--source_format--,------>
 
>----target_format--,--conversion_options--,--target_file--,---->
 
>----comment--)------------------------------------------------><
 

参数(数据类型)

handle(DB2IMAGE、DB2AUDIO 或 DB2VIDEO)
包含图象、音频或视频的句柄的列名或主变量。

source_file (LONG VARCHAR)
包含图象、音频或视频的更新内容的文件名。

target_file (LONG VARCHAR)
包含要更新的图象、音频或视频的内容的文件名。

create_target (INTEGER)
指示当源内容在服务器文件中时,是否将创建目标文件的值。值可以是 0 或 1。值 0 表示将不创建目标文件(实际上,将不发生检索)。值 1 表示将 创建目标文件(若目标文件已存在,此值的作用是用来覆盖 该文件)。若源内容是 BLOB,则总是创建目标文件(若该文件已存在,将覆盖它)。

target_format (VARCHAR(8))
检索之后图象的格式。将适当地转换源图象的格式。若更新内容时 进行了格式转换,则需要在 DB2IMAGEPATH 和 DB2MMPATH 环境变量中指定 目标文件的路径。对于 MPG1 格式,可指定 MPG1、mpg1、MPEG1 或 mpeg1。对于 MPG2 格式, 可指定 MPG2、mpg2、MPEG2 或 mpeg2。

content (BLOB(2G) AS LOCATOR)
包含图象、音频或视频的更新内容的主变量的名称。主变量的类型可以是 BLOB、BLOB_FILE 或 BLOB_LOCATOR。DB2 将数据类型转换为 BLOB_LOCATOR,并将 LOB 定位器传送至 Replace UDF。

source_format (VARCHAR(8))
图象、音频或视频的更新源的格式。可指定空值或空字符串,或仅对于图象,可指定字符串 ASIS; 在这三种情况下,Extender 试图自动确定格式。对于 MPG1 格式,可指定 MPG1、mpg1、MPEG1 或 mpeg1。对于 MPG2 格式, 可指定 MPG2、mpg2、MPEG2 或 mpeg2。

comment (LONG VARCHAR)
注解。

attrs (LONG VARCHAR FOR BIT DATA)
图象、音频或视频的属性

thumbnail (LONG VARCHAR FOR BIT DATA)
图象或视频帧的缩略图(仅适用于图象和视频)

conversion_options (VARCHAR(100))
指定更新图象时,要对其应用的更改,如旋转和压缩。参见表 5 以获取受支持的转换选项。

返回值(数据类型)

要更新的图象、音频或视频的句柄(DB2IMAGE、DB2AUDIO 或 DB2VIDEO)。

更新 Employee 表的 Picture 列中 Anita Jones 的图象, 将图象的格式由 BMP 转换为 GIF,并更新注解:

EXEC SQL BEGIN DECLARE SECTION;
  long hvStorageType;
EXEC SQL END DECLARE SECTION;
 
hvStorageType = MMDB_STORAGE_TYPE_INTERNAL;
 
EXEC SQL UPDATE EMPLOYEE
  SET PICTURE = REPLACE(PICTURE,
        '/employee/newimg/ajones.bmp',
        'BMP',
        'GIF',
        :hvStorageType,
        'Anita''s new picture')
  WHERE NAME='Anita Jones';


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]