您的位置:58编程 > PostgreSQL SPI_modifytuple

PostgreSQL SPI_modifytuple

2023-03-29 14:33

 PostgreSQL SPI_modifytuple

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的数组,描述哪些新值为空值

如果nullsNULL,那么 SPI_modifytuple假定没有新值为空值。否则, 如果对应的新值为非空,nulls数组的每一项都应 该是" ",而如果对应的新值为空值则为 "n"(在 后一种情况中,对应的values项中的新值无关紧 要)。注意nulls不是一个文本字符串,只是一个 数组:它不需要一个"0"终止符。

返回值

修改过的新行,它被分配在上层的执行器上下文中,或者在出错时返回NULL(错误的内容请参考SPI_result

出错时,SPI_result被设置如下:

SPI_ERROR_ARGUMENT

如果relNULL,或者 rowNULL,或者ncols 小于等于 0,或者colnumNULL, 或者valuesNULL

SPI_ERROR_NOATTRIBUTE

如果colnum包含一个无效的列号(小于等于 0 或者大于 row中的列数)。

SPI_ERROR_UNCONNECTED

如果SPI不是活跃状态

阅读全文
以上是58编程为你收集整理的 PostgreSQL SPI_modifytuple全部内容。
声明:本站所有文章资源内容,如无特殊说明或标注,均为采集网络资源。如若本站内容侵犯了原著者的合法权益,可联系本站删除。
相关文章
© 2024 58编程 58biancheng.com 版权所有 联系我们
桂ICP备12005667号-32 Powered by CMS