历史版本。 PostgreSQL 13 已结束支持。 2025-11-13. 请参阅 当前版本手册.
SPI_returntuple
SPI_returntuple — 准备把一个元组返回为一个 Datum
大纲
HeapTupleHeader SPI_returntuple(HeapTuplerow, TupleDescrowdesc)
描述
SPI_returntuple 在上层执行器上下文中创建一行的副本,并以行类型 Datum 的形式返回。返回的指针只需在返回前用
PointerGetDatum 转换为 Datum 即可。
此函数只能在连接到 SPI 时使用。否则,它会返回 NULL,并将
SPI_result 设为
SPI_ERROR_UNCONNECTED。
请注意,它应用于声明为返回复合类型的函数,而不用于触发器;触发器中返回修改后的行应使用 SPI_copytuple。
参数
HeapTuplerow要复制的行
TupleDescrowdesc行描述符(若要获得最佳缓存效果,每次都传入同一个描述符)
返回值
指向复制后行的 HeapTupleHeader;出错时返回
NULL(错误指示见 SPI_result)