使用 PREPARE 语句可在运行时解析、验证和生成一个或多个 SQL 语句的执行计划;
用法
请在 ESQL/C 或 SPL 例程中使用此语句。
PREPARE 语句启用您的程序来在运行时收集一个(或对于 ESQL/C,多于一个)SQL 语句的文
本,来声明结果的准备好的对象的标识符,并使之可运行。以三个步骤实现此 SQL 的动态形式:
-
PREPARE 语句接收语句文本为输入,或作为引用的字符串,或 ESQL/C 字符变量,或(在 SPL 中)作为字符表达式计算的值。语句文本可包含问号(?)占位符来表示要到执行该语句时定义的值。
-
OPEN 语句(以及在 ESQL/C 例程中,EXECUTE 语句)可提供所需要的输入值并一次或多次执行准备好的语句。
-
稍后,可使用 FREE 语句释放那些分配给准备好的语句的资源。要获取更多关于在准备好的语句中以运行时的值替换占位符的信息,请参阅章节 准备接收参数的语句。
当您创建准备好的对象时的整理顺序为当前,执行那个对象时的整理顺序也一样,即使该会话的(或 DB_LOCALE 的)执行时整理是不同的。
限制
在单个程序内准备好的对象的数目受可用内存的限制。这些包括在 PREPARE 语句(statement_id或 statement_id_var)中声明的语句标识符,以及声明了的游标。要避免超限,请使用 FREE 语句来释放一些语句或游标。
在 SPL 例程中,准备好的对象可包括不超过一 SQL 语句的文本,那语句必须或为 EXECUTEUNCTION、EXECUTE PROCEDURE,或为 SELECT 语句,但 SELECT 语句不可包括 INTOvariable、INTO TEMP 或 FOR UPDATE 子句。在 SPL 例程中指定语句文本的表达式必须计算为 CHAR、LVARCHAR、NCHAR、NVARCHAR或 VARCHAR 数据类型。您必须显式地强制转型为这些任何其他文本数据类型的表达式类型,诸如 UDT。
要了解在 ESQL/C 例程中对字符串中的 SQL 语句的限制,请参阅 在单一语句准备中受限的语句
和 在多语句准备好的对象中的受限语句。