Movatterモバイル変換

SPI_freetuptable

SPI_freetuptable — free a row set created bySPI_execute or a similar function

Synopsis

void SPI_freetuptable(SPITupleTable *tuptable)

Description

SPI_freetuptable frees a row set created by a prior SPI command execution function, such asSPI_execute. Therefore, this function is often called with the global variableSPI_tuptable as argument.

This function is useful if an SPI-using C function needs to execute multiple commands and does not want to keep the results of earlier commands around until it ends. Note that any unfreed row sets will be freed anyway atSPI_finish. Also, if a subtransaction is started and then aborted within execution of an SPI-using C function, SPI automatically frees any row sets created while the subtransaction was running.

Beginning inPostgreSQL 9.3,SPI_freetuptable contains guard logic to protect against duplicate deletion requests for the same row set. In previous releases, duplicate deletions would lead to crashes.

Arguments