云数据库OceanBase入门教程 OceanBase LONG 和 LONG RAW 数据类型

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

当查询选择一个或多个 LONG或 LONG RAW列时，OceanBase Connector/J 将这些列以流模式传输到客户端。

在流模式下，OceanBase Connector/J 一般不会从网络读取 LONG或 LONG RAW 列的数据。在使用代码调用 getXXX方法读取列数据之前，列数据将保留在网络通信通道中。除了读取列数据外，任何连接使用都会将列数据从通道中丢弃。虽然流模式可以有效利用内存并最大程度地减少往返通信，但它会干扰其他数据库操作。

要访问 LONG列中的数据，您可以将该列作为 Java InputStream对象，并使用 InputStream对象的 read方法获取。也可以将数据作为 String或 byte数组，通过执行流传输获取。

三种流类型都可以获取 LONG和 LONG RAW数据。驱动程序将根据数据库和驱动程序的字符集进行执行转换。

注意
不要创建带有 LONG列的表。可以改用大对象（LOB）列：CLOB、NCLOB和 BLOB。因为 LOB列的使用限制远少于 LONG列，所以建议将现有的 LONG列转换为 LOB列。

LONG RAW 数据转换

调用 getBinaryStream返回 RAW数据。调用 getAsciiStream会将 RAW数据转换为十六进制并返回相应的 ASCII。调用getUnicodeStream会将 RAW数据转换为十六进制并返回 Unicode 字符。

LONG 数据转换

使用 getAsciiStream获取 LONG数据时，驱动程序会假定数据库中的基础数据使用 US7ASCII或 WE8ISO8859P1字符集。如果假设为真，则驱动程序将返回与 ASCII 字符相对应的字节。如果数据库未使用 US7ASCII或 WE8ISO8859P1字符集，则调用 getAsciiStream将返回无意义的信息。

使用 getUnicodeStream获取 LONG数据时，将获得 UTF-16 编码的 Unicode 字符流。

使用 getBinaryStream获取 LONG数据时，如果数据库字符集不是 US7ASCII或 WE8ISO8859P1，则调用 getBinaryStream将返回 UTF-8。如果服务器端字符集是 US7ASCII或 WE8ISO8859P1，则调用将返回 US7ASCII字节流。

注意
将 LONG或 LONG RAW列作为流进行接收时，需要特别注意在数据库中检索的列的顺序。
LONG和 LONG RAW数据转换的详细信息如下表所示。

数据类型	BinaryStream	AsciiStream	UnicodeStream
LONG	字节表示 Unicode UTF-8 中的字符。如果数据库字符集为 `US7ASCII`或 `WE8ISO8859P1`，则这些字节表示 `US7ASCII`或 `WE8ISO8859P1`中的字符。	字节表示 ISO-Latin-1（`WE8ISO8859P1`）编码中的字符。	字节代表 Unicode UTF-16 编码的字符。
LONG RAW	数据不变数据。	十六进制字节的 ASCII 表示形式。	十六进制字节的 Unicode 表示形式。

示例

getXXXStream方法的功能之一是能够以增量方式获取数据，而 getBytes在一次调用中就获取所有数据。以下是获取二进制数据流的示例。

示例 1：使用 getBinaryStream 方法获取 LONG RAW 数据

创建表 stream01，存储与名称 SAMPLE相关的 LONG RAW数据列。

CREATE TABLE stream01 (name VARCHAR2 (50), giftype LONG RAW);
INSERT INTO stream01 VALUES ('SAMPLE', '1234567890123');

将 LONG RAW列中的数据写入名为 sample.gif的文件中。

ResultSet rs = st.executeQuery
                 ("select giftype from stream01 where NAME='SAMPLE'");

使用 getBinaryStream方法获取 LONG RAW数据。

// 获取第一行
if (rs.next())
{
    // 以流形式获取 GIF 数据
    InputStream gif_type = rs.getBinaryStream (1);
   try
   {
      FileOutputStream file = null;
      file = new FileOutputStream ("sample.gif");
      int chunk;
      while ((chunk = gif_type.read()) != -1)
         file.write(chunk);
   }
   catch (Exception e)
   {
      String err = e.toString();
      System.out.println(err);
   }
   finally
   {
      if file != null()
         file.close();
   }
}

上述示例中，调用 getBinaryStream返回的 InputStream对象直接从数据库连接中读取数据。

示例 2：使用 getBytes 方法获取 LONG RAW 数据

本示例使用 getBytes获取 giftype列的内容，驱动程序将在一次调用中获取所有数据，并将其存储在字节数组中。

ResultSet rs2 = st.executeQuery
                  ("select giftype from streame01 where NAME='SAMPLE'");
// 获取第一行
if (rs2.next())
{
   // 以流形式获取 GIF 数据
   byte[] bytes = rs2.getBytes(1);
   try
   {
      FileOutputStream file = null;
      file = new FileOutputStream ("sample2.gif");
      file.write(bytes);
   }
   catch (Exception e)
   {
      String err = e.toString();
      System.out.println(err);
   }
   finally
   {
      if file != null()
         file.close();
   }
}

因为 LONG RAW列最多可以包含 2 GB 的数据，所以与 getBinaryStream示例相比，getBytes示例可以使用更多的内存。如果不知道 LONG或 LONG RAW列中数据的最大大小，请使用流。

说明

OceanBase Connector/J 可以自动流传输任何 LONG和 LONG RAW列。但在某些情况下，您可能希望避免数据流传输。例如，当 LONG列很小时，这种情况可能就要避免递增式返回数据，而是采用一次调用就返回数据。
为避免流传输，请使用 defineColumnType方法重新定义 LONG列的类型。例如，可以将 LONG或 LONG RAW列重新定义为 VARCHAR或 VARBINARY类型，则驱动程序将不会自动流传输数据。
如果使用 defineColumnType重新定义列类型，则必须在查询中声明列的类型。否则，executeQuery将执行失败。另外，必须将 Statement对象转换为 oceanbase.jdbc.oceanbaseStatement。

上一节： OceanBase Java 数据流概述

下一节： OceanBase LOB 数据类型

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

云数据库OceanBase入门教程 OceanBase LONG 和 LONG RAW 数据类型

LONG RAW 数据转换

LONG 数据转换

示例