(a) Function

Sets the LONGVARBINARY (a JDBD SQL type) data length for one access request to the HiRDB server.

(b) Format

 
public void setLONGVARBINARY_AccessSize ( int access_size ) throws SQLException
 

(c) Arguments

int access_size

Specifies the data length (kilobytes) to be requested. The specification value range is from 0 to 2,097,151 (the default is 0). If 0 is specified, the entire data is requested at once.

(d) Return value

None.

(e) Functional detail

Sets the LONGVARBINARY (a JDBC SQL type) data length for one access request to the HiRDB server.

For example, if 20 is specified for the access_size argument and the application uses the getBytes method of ResultSet to retrieve 100 kilobytes of LONGVARBINARY data stored in the database, the JDBC driver retrieves the data by dividing the operation into five executions of 20 kilobytes each.

This specification value becomes invalid if a value other than LOCATOR is specified in the mode argument of the setLONGVARBINARY_Access method.

Specifying a value for this method is equivalent to setting the HiRDB_for_Java_LONGVARBINARY_ACCESS_SIZE property, which is shown in 17.2.2(2) User properties.

(f) Exceptions

If a value outside the range from 0 to 2,097,151 is specified in the access_size argument, this method throws a java.sql.SQLException.

(g) Notes

See 17.2.2(2)(q) Notes about specification of LONGVARBINARY_ACCESS.