SPI_prepare_extended — prepara uma instrução, sem executá-la ainda
SPIPlanPtr SPI_prepare_extended(const char *command, const SPIPrepareOptions *options)
A função SPI_prepare_extended cria e retorna uma
instrução preparada para o comando especificado, mas não executa o comando.
Esta função é equivalente à função SPI_prepare,
com a adição de que o chamador pode especificar opções para controlar
a análise de referências a parâmetros externos, bem como outras
facetas de análise e planejamento de consultas.
const char * commandcadeia de caracteres de comando
const SPIPrepareOptions * optionsestrutura contendo argumentos opcionais
Os chamadores devem sempre zerar toda a estrutura
options e, em seguida, preencher os campos
que desejam definir.
Isto garante a compatibilidade futura do código, uma vez que quaisquer
campos adicionados à estrutura no futuro serão definidos para se
comportarem de maneira compatível com as versões anteriores se forem zero.
Os campos de options disponíveis no momento são:
ParserSetupHook parserSetupfunção de definição do gancho (hook) do analisador
void * parserSetupArg
argumento de passagem (pass-through)
para parserSetup
RawParseMode parseMode
modo para análise bruta (raw);
RAW_PARSE_DEFAULT (zero)
produz o comportamento padrão
int cursorOptionsnúmero inteiro, máscara de bits das opções do cursor; zero produz o comportamento padrão
A função SPI_prepare_extended tem as mesmas
convenções de retorno que a função SPI_prepare.