Smart-large-object interface

The DataBlade® API provides routines for handling smart large objects.

Table 1. DataBlade API functions for handling smart large objects

Function category DataBlade API function DataBlade API function
Creating a smart large object

mi_lo_copy()
mi_lo_create()
mi_lo_from_file()

Deprecated function:

mi_lo_expand()

Performing I/O on a smart large object

mi_lo_close()
mi_lo_from_buffer()
mi_lo_lock()
mi_lo_open()
mi_lo_read()
mi_lo_readwithseek()
mi_lo_seek()
mi_lo_stat()

mi_lo_tell()
mi_lo_to_buffer()
mi_lo_truncate()
mi_lo_unlock()
mi_lo_utimes()
mi_lo_write()
mi_lo_writewithseek()

Moving smart large objects to and from operating-system files

mi_lo_filename()
mi_lo_from_file()

mi_lo_from_file_by_lofd()
mi_lo_to_file()

Manipulating LO handles

mi_get_lo_handle()
mi_lo_alter()
mi_lo_decrefcount()
mi_lo_delete_immediate()
mi_lo_filename()
mi_lo_from_string()
mi_lo_increfcount()
mi_lo_invalidate()

mi_lo_lolist_create()
mi_lo_ptr_cmp()
mi_lo_release()
mi_lo_to_string()
mi_lo_truncate()
mi_lo_validate()
mi_put_lo_handle()

Handling LO-specification structures

mi_lo_colinfo_by_ids()
mi_lo_colinfo_by_name()
mi_lo_spec_free()
mi_lo_spec_init()
mi_lo_specget_def_open_flags()
mi_lo_specget_estbytes()
mi_lo_specget_extsz()
mi_lo_specget_flags()

mi_lo_specget_maxbytes()
mi_lo_specget_sbspace()
mi_lo_specset_def_open_flags()
mi_lo_specset_estbytes()
mi_lo_specset_extsz()
mi_lo_specset_flags()
mi_lo_specset_maxbytes()
mi_lo_specset_sbspace()

Handling smart-large-object status

mi_lo_stat()
mi_lo_stat_atime()
mi_lo_stat_cspec()
mi_lo_stat_ctime()
mi_lo_stat_free()

mi_lo_stat_mtime_sec()
mi_lo_stat_mtime_usec()
mi_lo_stat_refcnt()
mi_lo_stat_size()
mi_lo_stat_uid()

Important: The term smart large object refers to either a BLOB or CLOB object. References to a single type of smart large object use the data type specification.