SPI_cursor_open_with_paramlist

SPI_cursor_open_with_paramlist — configura un cursor usando parámetros

Synopsis

Portal SPI_cursor_open_with_paramlist(const char *name,
                                      SPIPlanPtr plan,
                                      ParamListInfo params,
                                      bool read_only)

Descripción

SPI_cursor_open_with_paramlist configura un cursor (internamente, un portal) que ejecutará una sentencia preparada por SPI_prepare. Esta función es equivalente a SPI_cursor_open excepto que la información sobre los valores de los parámetros que se pasarán a la consulta se presenta de manera diferente. La representación ParamListInfo puede ser conveniente para pasar valores que ya están disponibles en ese formato. También admite el uso de conjuntos de parámetros dinámicos a través de funciones de gancho (hook) especificadas en ParamListInfo.

Los datos de los parámetros pasados se copiarán en el portal del cursor, por lo que se pueden liberar mientras el cursor aún exista.

Argumentos

const char * name

nombre del portal, o NULL para permitir que el sistema seleccione un nombre

SPIPlanPtr plan

sentencia preparada (devuelta por SPI_prepare)

ParamListInfo params

estructura de datos que contiene los tipos y valores de los parámetros; NULL si no hay ninguno

bool read_only

true para una ejecución de solo lectura

Valor de retorno

Puntero al portal que contiene el cursor. Ten en cuenta que no hay una convención de retorno de error; cualquier error se reportará a través de elog.