云数据库OceanBase入门教程 OceanBase LOB 数据接口

2024-02-26 开发教程云数据库OceanBase入门教程匿名 3℃

OceanBase Connector/J 提供了用于写入和读取整个 LOB内容的简化机制，称为数据接口。

数据接口使用标准的 JDBC 方法（如 getString和 setBytes）读取和写入 LOB数据。使用数据接口更易于编码且速度更快，但与标准 java.sql.Blob、java.sql.Clob和 java.sql.NClob接口不同，它不提供随机访问功能，并且访问数据量不能超出 2147483648 个元素。

Input

OceanBase Connector/J 扩展了 PreparedStatement的 setBytes、setBinaryStream、setString、setCharacterStream和 setAsciiStream方法，以增强使用 BLOB、CLOB和 NCLOB的能力。

对于服务器端内部驱动程序，当前对 SQL 语句（如 INSERT语句）的操作限制为 4000 字节。此限制不适用于 PL 语句。INSERT语句通过包裹在 PL 块中来解决这一限制，方法如下：

BEGIN
 INSERT id, name INTO clob_emp VALUES(?,?);
END

对于大型数据共有三种输入模式，如下所示：

直接绑定
此绑定方式的大小受到限制，但效率最高。它将所有输入列的数据内联在的数据块中，再发送到服务器。所有数据（包括批处理的多次执行）都在单个网络操作中发送。

流绑定
此绑定将数据放在末尾。它将批量大小限制为一个，因而可能需要多次往返才能完成。

LOB绑定
此绑定创建一个临时 LOB，将数据复制到 LOB，并绑定 LOB定位器。临时 LOB在执行后自动释放。创建临时 LOB然后写入 LOB的操作需要多次往返。定位器的输入可以是成批的。

对于 SQL 语句，输入模式的使用注意事项如下：

setBytes和 setBinaryStream方法对小于 4001 字节的数据使用直接绑定。
setBytes和 setBinaryStream方法对大于 4000 字节的数据使用流绑定。
setAsciiStream、setBinaryStream和 setCharacterStream方法将长参数作为表单长度，使用长度大于 2147483648 的 LOB绑定。未指定长度的表单始终使用 LOB绑定。
setString、setCharacterStream和 setAsciiStream方法对小于 32767 个字符的数据使用直接绑定。
setString、setCharacterStream和 setAsciiStream方法对大于 32766 个字符的数据使用流绑定。
setCharacterStream方法的新形式需要使用 long参数的中作为长度，对大于 2147483647 的长度使用 LOB绑定。未指定长度的表单始终使用 LOB绑定。

对于 PL 语句，输入模式的使用注意事项如下：

setBytes和 setBinary流式方法对小于 32767 字节的数据使用直接绑定。
setBytes和 setBinaryStream方法对大于 32766 字节的数据使用 LOB绑定。
setString、setCharacterStream和 setAsciiStream方法对数据库字符集中小于 32767 字节的数据使用直接绑定。
说明
BLOB无法使用 setString来设置。
setString、setCharacterStream和 setAsciiStream方法对数据库字符集中大于 32766 字节的数据使用 LOB绑定。

自动切换输入模式会影响某些程序。自动切换也可能导致附加的服务器端解析，以适应参数类型的更改。如果重复执行语句时，数据大小在阈值上下不断变化，则将导致性能影响。切换到流模式也会影响批处理。

Output

ResultSet和 CallableStatement的 getBytes、getBinaryStream、getString、getCharacterStream和 getAsciiStream方法已扩展为可与 BLOB、CLOB或 OUT参数一起使用。这些方法适用于长度小于 2147483648 的任何 LOB。

说明

getString和 getNString方法不能用于检索 BLOB列值。

数据接口通过访问驱动程序中的 LOB定位器进行操作，并且对应用程序编程是透明的。可以根据需要使用 LOB预取来减少或消除的其他数据库往返行程。

可以使用与 LONG RAW和 LONG数据相同的流式传输机制来读取和写入 BLOB或 CLOB数据。可以在列上使用 defineColumnType(nn，Types.LONGVARBINARY)或 defineColumnType(nn，Types.LONGVARCH方法来读取数据，产生直接流，就好像是读取 LONG RAW或 LONG列的数据一样。

CallableSatement 和 IN OUT 参数

PL 要求用作 IN OUT参数输入和输出的 Java 类型必须相同。

对于存储过程的 IN OUT CLOB参数，希望使用 setString方法设置该参数的值。对于任何 IN和 OUT参数，必须对相同的类型进行绑定。如果无法确定数据大小，则自动切换输入模式会引发错误。例如，如果知道输入数据和输出数据都不会大于 32766 字节，则可以对输入参数使用 setString方法，并将 OUT参数注册为 Types.VARCHAR，对输出参数使用 getString方法。

更好的解决方案是将存储过程更改为具有单独的 IN和 OUT参数。如下例所示：

CREATE PROCEDURE clob_obproc( cc IN OUT CLOB );

更改为如下示例：

CREATE PROCEDURE clob_obproc( cc_in IN CLOB, cc_out OUT CLOB );

另一个解决方法是使用容器块进行调用。clob_plproc存储过程可以用 Java 字符串包装，以用于 prepareCall语句，如下所示：

"DECLARE cc_temp; BEGIN cc_temp := ?; clob_plproc( cc_temp); ? := cc_temp; END;"

无论哪种情况，都可以在第一个参数上使用 setString方法，在第二个参数上使用 registerOutParameter方法和 Types.CLOB。

大小限制

如果创建非常大的 byte数组或 String 可能会对 Java 内存管理系统的性能产生影响。阅读 Java 虚拟机（JVM）供应商提供的有关大量数据元素影响内存管理的相关信息，并考虑改用流接口。

上一节： OceanBase LOB 数据类型简介

下一节： OceanBase LOB Locator 接口

"云数据库OceanBase入门教程"的目录

云数据库OceanBase入门教程 OceanBase LOB 数据接口

Input

Output

CallableSatement 和 IN OUT 参数

大小限制