SPI_modifytuple — 通过替换一个给定行的选定域来创建一行
HeapTuple SPI_modifytuple(Relation rel
, HeapTuple row
, int ncols
,
int * colnum
, Datum * values
, const char * nulls
)
SPI_modifytuple
创建一个新行,其中选定的列 用新值替代,其他列则从输入行中拷贝。输入行本身不被修改。新行被返回在上层的执行器上下文中。
这个函数只能在连接到SPI时使用。否则,它会返回NULL并且把SPI_result
设置为SPI_ERROR_UNCONNECTED
。
Relation rel
只被用作该行的行描述符的来源(传递一个关系而不是 一个行描述符是一种令人头痛的设计)。
HeapTuple row
要被修改的行
int ncols
要被修改的列数
int * colnum
一个长度为ncols
的数组,包含了要被修改的列号 (列号从 1 开始)
Datum * values
一个长度为ncols
的数组,包含了指定列的新值
const char * nulls
一个长度为ncols
的数组,描述哪些新值为空值
如果nulls
为NULL
,那么 SPI_modifytuple
假定没有新值为空值。否则, 如果对应的新值为非空,nulls
数组的每一项都应 该是" "
,而如果对应的新值为空值则为
"n"
(在 后一种情况中,对应的values
项中的新值无关紧 要)。注意nulls
不是一个文本字符串,只是一个 数组:它不需要一个"0"
终止符。
修改过的新行,它被分配在上层的执行器上下文中,或者在出错时返回NULL
(错误的内容请参考SPI_result
)
出错时,SPI_result
被设置如下:
SPI_ERROR_ARGUMENT
如果rel
为NULL
,或者 row
为NULL
,或者ncols
小于等于 0,或者colnum
为
NULL
, 或者values
为NULL
。
SPI_ERROR_NOATTRIBUTE
如果colnum
包含一个无效的列号(小于等于 0 或者大于 row
中的列数)。
SPI_ERROR_UNCONNECTED
如果SPI不是活跃状态
ALTER MATERIALIZED VIEW — 更改一个物化视图的定义大纲ALTER MATERIALIZED VIEW [ IF EXISTS ] name action [, ... ]ALTER MAT...
HTML DOM documentElement 属性 Document 对象实例返回文档的 documentElement:document.documentElement;定义和用法documentEle...
JavaScript pop() 方法 JavaScript Array 对象实例移除最后一个数组元素var fruits = [Banana, Orange, Apple, Mango];fruits.po...
Table cells 集合 Table 对象定义和用法 cells 集合返回表格中所有 td 或 th 元素。语法tableObject.cellsProperties属性描述len...
HTML DOM doctype 属性 Document 对象实例返回 HTML 文档的文档类型对象:document.doctype;定义和用法doctype 属性可返回与文档...
在 OceanBase 开发者中心(OceanBase Developer Center,ODC)点击连接名进入连接后,在左导航栏中点击 函数 标签可以查看函数列...
进入 OceanBase 开发者中心(OceanBase Developer Center,ODC)点击目标连接配置卡片进入对应的数据库对象管理页面后,点击右上...