更新日期：2024年09月11日
使用 RENAME INDEX 语句来更改现有的索引的名称。此语句为对 SQL 的
ANSI/ISO 标准的扩展。
语法
元素
描述
限制
语法
new_index 您在此为该索引
声明的新名称
名称对于该数据库必须为唯
一的（或如果 old_index 在
临时表上，则是对于该会
话）
标识符
old_index new_index 替代
的索引名称
必须存在，但不可为下列中
的任何之一： -- 在系统目
录表上的索引 -- 系统生成
的约束索引 -- “虚拟索引
接口”（VII）
标识符
owner
索引的所有者
必须为 old_index 的所有者 所有者名称
用法
如果您是该索引的所有者或有对该数据库的 DBA 权限，则可重命名索引。
当您重命名索引时，数据库服务器更改 sysindexes、sysconstraints、sysobjstate
和 sysfragments 系统目录表中的索引名称。（但对于临时表上的索引，不更新系
统目录表。）
不可重命名系统目录表上的索引。如果您想更改实施约束的系统生成的索引的名
称，请使用 ALTER TABLE ... DROP CONSTRAINT 语句来删除该约束，然后再
使用 ALTER TABLE ... ADD CONSTRAINT 语句来定义新的约束，新约束与您删
除了的约束有相同的定义，但对于您声明的新名称。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 797
在缺省情况下，重新优化使用该重命名了的索引的 SPL 例程，当重命名该索引之
后下一次执行它们时。然而，当启用自动的重编译时，如果该重命名了的索引与
直接地引用了的表相关联，则在下一次使用该重命名了的索引时，自动地重编译
SPL 例程。然而，如果仅间接地引用该表，执行可失败，并报错 -710。要获取更
多关于在更改被引用的表的模式之后，启用或禁用自动的重编译的信息，请参阅
IFX_AUTO_REPREPARE 环境选项。要获取更多关于 AUTO_REPREPARE 配置
参数的信息，请参阅您的 GBase 8s 管理员参考手册。
ifx_lo_writewithseek() 函数执行搜寻操作，然后将指定字节数的数据写到打开的
智能大对象。
语法
mint ifx_lo_writewithseek(LO_fd, buf, nbytes, offset, whence, error)
mint LO_fd;
char *buf;
mint nbytes;
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 809 -
ifx_int8_t *offset;
mint whence;
mint *error;
LO_fd
表示要写到其的智能大对象的 LO 文件描述符。
buf
指向包含函数写到智能大对象的数据的缓冲区的指针。
nbytes
要写到智能大对象的字节数。此值不可超过 2 GB。
offset
指向从其起始的搜寻位置的 8 字节整数（INT8）偏移量的指针。
whence
标识起始的搜寻位置的 mint 值。
error
指向包含 ifx_lo_writewithseek() 设置的错误代码的 mint 的指针。
用法
ifx_lo_writewithseek() 函数将 nbytes 的数据写到 LO_fd 文件描述符标识的智能大对
象。该函数从 buf 指向的用户定义的缓冲区取得要写的数据。该缓冲区的大小必须小于 2
GB。
在 offset 和 whence 参数指示的 LO_fd 的搜寻位置开始写，如下：
whence 参数标识从其开始搜寻的位置。
有效的值包括下列 locator.h 头文件定义的常量。
Whence 常量
起始的搜寻位置。
LO_SEEK_SET
智能大对象的起始
LO_SEEK_CUR
智能大对象中的当前搜寻位置
LO_SEEK_END
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 810 -
智能大对象的末尾
offset 参数标识以字节计的偏移量，从（whence 参数指定的）起始的搜寻位置，至应
设置的搜寻位置。
如果数据库服务器将少于 nbytes 的数据写到智能大对象，则 ifx_lo_writewithseek()
函数返回它写了的字节数，并设置 error 值来指向表示未完成的写操作的原因的值。当
sbspace 用尽空间时，可发生此情况。
返回代码
>=0
该函数已从 buf 字符缓冲区写到智能大对象的字节数。
-1
函数不成功；要获取详尽的错误代码，请检测 error。