SPI_prepare_extended

SPI_prepare_extended — 准备一个语句，而不执行它

概要

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

描述

SPI_prepare_extended创建并返回指定命令的已准备语句，但不执行该命令。此函数等同于SPI_prepare，此外，调用者可以指定选项来控制外部参数引用的解析以及查询解析和规划的其他方面。

参数

const char * command

命令字符串

const SPIPrepareOptions * options

包含可选参数的结构

调用者应始终将整个*options结构清零，然后填充他们想要设置的任何字段。这确保了代码的前向兼容性，因为将来添加到结构中的任何字段都被定义为在为零时向后兼容。当前可用的options*字段是

ParserSetupHook parserSetup

解析器挂钩设置函数

void * parserSetupArg

用于 parserSetup 的直通参数

RawParseMode parseMode

原始解析模式；RAW_PARSE_DEFAULT（零）产生默认行为

int cursorOptions

游标选项的整数位掩码；零产生默认行为

返回值

SPI_prepare_extended具有与SPI_prepare相同的返回约定。