SPI_prepare_extended

SPI_prepare_extended — prepara una sentencia, sin ejecutarla todavía

Synopsis

SPIPlanPtr SPI_prepare_extended(const char * command,
                                const SPIPrepareOptions * options)

Descripción

SPI_prepare_extended crea y devuelve una sentencia preparada para el comando especificado, pero no la ejecuta. Esta función es equivalente a SPI_prepare, con la adición de que el llamador puede especificar opciones para controlar el análisis sintáctico de las referencias a parámetros externos, así como otras facetas del análisis sintáctico y la planificación de consultas.

Argumentos

const char * command

cadena de comando

const SPIPrepareOptions * options

estructura que contiene los argumentos opcionales

Los llamadores siempre deben inicializar en cero toda la estructura options y luego rellenar los campos que deseen establecer. Esto garantiza la compatibilidad futura del código, ya que cualquier campo que se añada a la estructura en el futuro se definirá para comportarse de manera compatible con versiones anteriores si está en cero. Los campos de options actualmente disponibles son:

ParserSetupHook parserSetup

Función de configuración del gancho del parser

void * parserSetupArg

argumento de paso para parserSetup

RawParseMode parseMode

modo para el análisis sintáctico bruto; RAW_PARSE_DEFAULT (cero) produce el comportamiento por defecto

int cursorOptions

máscara de bits entera de opciones de cursor; cero produce el comportamiento por defecto

Valor de retorno

SPI_prepare_extended tiene las mismas convenciones de retorno que SPI_prepare.