预发布版本文档。 PostgreSQL 19beta4 为测试版本，最终发布内容可能有所不同。
SPI_copytuple
SPI_copytuple — 在上层执行器上下文中创建一行的副本
大纲
HeapTuple SPI_copytuple(HeapTuple row)
描述
SPI_copytuple 在上层执行器上下文中创建一行的副本。它通常用于从触发器中返回修改后的行。对于声明为返回复合类型的函数，应改用 SPI_returntuple。
此函数只能在连接到 SPI 时使用。否则，它会返回 NULL，并将
SPI_result 设为
SPI_ERROR_UNCONNECTED。
参数
HeapTuplerow要复制的行
返回值
复制后的行；出错时返回 NULL（错误指示见 SPI_result）