↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0
开发快照。 PostgreSQL 20devel 尚未正式发布,内容仍可能变化。

SPI_returntuple

SPI_returntuple — 准备把一个元组返回为一个 Datum

大纲

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

描述

SPI_returntuple 在上层执行器上下文中创建一行的副本,并以行类型 Datum 的形式返回。返回的指针只需在返回前用 PointerGetDatum 转换为 Datum 即可。

此函数只能在连接到 SPI 时使用。否则,它会返回 NULL,并将 SPI_result 设为 SPI_ERROR_UNCONNECTED。

请注意,它应用于声明为返回复合类型的函数,而不用于触发器;触发器中返回修改后的行应使用 SPI_copytuple。

参数

HeapTuple row

要复制的行

TupleDesc rowdesc

行描述符(若要获得最佳缓存效果,每次都传入同一个描述符)

返回值

指向复制后行的 HeapTupleHeader;出错时返回 NULL(错误指示见 SPI_result)

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.