准备

调用

此语句只能嵌入在应用程序， SQL 函数， SQL 过程或触发器中。 它是无法动态准备的可执行语句。 不得在 Java™中指定该值。

授权

授权规则与为 PREPARE 语句指定的 SQL 语句定义的规则相同。 例如，请参阅 select-statement 以获取在准备 SELECT 语句时应用的授权规则。

如果在 CRTSQLxxx 命令上指定了 DLYPRP (*NO) ，那么在准备语句时将执行授权检查，但以下情况除外:

• 如果准备了 DROP SCHEMA 语句，那么直到执行该语句之后才会检查该模式中所有对象的特权。
• 如果准备了 DROP TABLE 语句，那么在执行该语句之前，不会检查对引用该表的所有视图，索引和逻辑文件的特权。
• 如果准备了 DROP VIEW 语句，那么在执行该语句之前，不会检查所有引用该视图的视图上的特权。
• 如果准备了 CREATE TRIGGER 语句，那么在执行该语句之前，不会检查对 trigger-action 中引用的对象的特权。
• 如果准备了 FUNCTION ， PROCEDURE ， SEQUENCE ， TYPE ， TRIGGER ， VARIABLE 或 XSROBJECT 语句的 DROP ， COMMENT 或 LABEL ，那么直到执行该语句之后才会检查权限。
• 如果准备了 GRANT 或 REVOKE 语句，那么直到执行该语句之后才会检查权限。

如果在 CRTSQLxxx 命令上指定了 DLYPRP (*YES) ，那么将延迟所有授权检查，直到在 OPEN 语句中执行或使用该语句为止。

除非在创建程序时在 CRTSQLxxx 命令上指定了 USRPRF (*OWNER) 和 DYNUSRPRF (*OWNER) ，否则该语句的授权标识是运行时授权标识。 有关更多信息，请参阅 授权标识和授权名称。

如果在语句中引用了全局变量，那么该语句的授权标识所拥有的特权必须至少包含下列其中一项:

• 对于语句中标识的全局变量，
  • 对全局变量的 READ 特权，以及
  • 对包含全局变量的模式的 USAGE 特权
• 数据库管理员权限

描述

语句名

命名预编译语句。 如果该名称标识现有预编译语句，那么在下列情况下将销毁该预编译语句:

• 它是在同一程序的同一实例中准备的，或者
• 在与两个预编译语句相关联的 CRTSQLxxx 命令上指定了 CLOSQLCSR (*ENDJOB) ， CLOSQLCSR (*ENDACTGRP) 或 CLOSQLCSR (*ENDSQL)。

该名称不能标识预编译语句，该语句是此程序实例的打开游标的 SELECT 语句。

使用 SQL 描述符 SQL-descriptor-name

标识 SQL 描述符。 如果指定了 USING ，并且成功执行了 PREPARE 语句，那么有关预编译语句的信息将放在由 SQL-descriptor-name指定的 SQL 描述符中。 因此， PREPARE 语句:

   EXEC SQL PREPARE S1 USING SQL DESCRIPTOR :sqldescriptor FROM :V1;

等同于：

   EXEC SQL PREPARE S1 FROM :V1;
   EXEC SQL DESCRIBE S1 USING SQL DESCRIPTOR :sqldescriptor;

LOCAL

指定要在程序调用本地的描述符名称的作用域。

全局

指定要对 SQL 会话为全局的描述符名称的作用域。

SQL 描述符名称

命名 SQL 描述符。 该名称必须标识已存在的具有指定作用域的描述符。

请参阅 GET DESCRIPTOR 以获取放置在 SQL 描述符中的信息的说明。

INTO

如果使用了 INTO ，并且成功执行了 PREPARE 语句，那么有关预编译语句的信息将放在由 descriptor-name指定的 SQLDA 中。 因此， PREPARE 语句:

   EXEC SQL PREPARE S1 INTO :SQLDA FROM :V1;

等同于：

   EXEC SQL PREPARE S1 FROM :V1;
   EXEC SQL DESCRIBE S1 INTO :SQLDA;

描述符名称

标识 SQL 描述符区域 (SQLDA) ，如 SQLDA (SQL 描述符区域)中所述。 在执行 PREPARE 语句之前，必须设置 SQLDA 中的以下变量 (REXX 的规则不同。 有关更多信息，请参阅 嵌入式 SQL 编程 主题集合。)

SQLN

指示 SQLVAR 表示的变量数。 (SQLN 提供 SQLVAR 数组的维。) 在执行 PREPARE 语句之前，必须将 SQLN 设置为大于或等于零的值。 有关确定所需出现次数的方法的信息，请参阅 确定需要多少 SQLVAR 出现次数。

有关放置在 SQLDA 中的信息的说明，请参阅 DESCRIBE OUTPUT 。

USING

指定要分配给 SQLDA 中的每个 SQLNAME 变量的值。 如果请求的值不存在或名称超过 30 ，那么 SQLNAME 设置为长度 0。

NAMES

分配列的名称。 这是缺省情况。 对于在 select-list 中显式指定了名称的预编译语句，将返回指定的名称。

SYSTEM NAMES

分配列的系统列名。

标签

分配列的标签。 (列标签由 LABEL 语句定义。) 仅返回标签的前 20 个字节。

任何

分配列标签。 如果该列没有标签，那么该标签是列名。

两者

同时指定列的标签和名称。 在这种情况下，需要每列出现两次或三次 SQLVAR ，具体取决于结果集是否包含单值类型，以适应其他信息。 要指定 SQLVAR 数组的此扩展，请将 SQLN 设置为 2 *n 或 3 *n(其中 n 是表或视图中的列数)。 SQLVAR 的前 n 次出现包含列名。 第二次或第三次 n 出现包含列标签。 如果没有单值类型，那么将在第二组 SQLVAR 条目中返回这些标签。 否则，将在第三组 SQLVAR 条目中返回这些标签。

如果在后续 FETCH 语句上使用相同的 SQLDA ，请在 PREPARE 完成后将 SQLN 设置为 n 。

全部

分配标签，列名和系统列名。 在这种情况下，根据结果集是否包含单值类型，需要每列出现三次或四次 SQLVAR ，以适应其他信息。 要指定 SQLVAR 数组的此扩展，请将 SQLN 设置为 3 *n 或 4 *n (其中 n 是结果表中的列数)。 前 n 次出现的 SQLVAR 包含系统列名。 第二次或第三次 n 次出现包含列标签。 第三次或第四次出现的 n 包含列名 (如果它们与系统列名不同)。 如果没有单值类型，那么将在第二组 SQLVAR 条目中返回标签，而在第三组 SQLVAR 条目中返回列名。 否则，将在第三组 SQLVAR 条目中返回标签，并在第四组 SQLVAR 条目中返回列名。

如果在后续 FETCH 语句上使用相同的 SQLDA ，请在 PREPARE 完成后将 SQLN 设置为 n 。

属性 attr-variable

指定如果未将相应属性指定为关联 SELECT 语句的最外层全查询的一部分，那么此游标的属性有效。 如果为最外面的全查询指定了属性，那么将使用这些属性来代替在 PREPARE 语句中指定的相应属性。 反过来，如果在 PREPARE 语句中指定了属性，那么将使用这些属性而不是在 DECLARE CURSOR 语句中指定的相应属性。

如果预编译语句不是 select-statement，那么将忽略除 USE 当前已落实和 WAIT FOR 结局以外的所有属性。

attr-variable 必须标识根据声明字符串变量的规则在程序中声明的字符串或 Unicode 图形变量。 attr-variable 必须是长度属性不超过 VARCHAR 最大长度的字符串变量 (固定长度或可变长度)。 将从变量的值中除去前导和尾部空格。 该变量必须包含有效的 attribute-string。

指示符变量可用于指示是否在 PREPARE 语句上实际提供了属性。 因此，无论是否需要指定属性，应用程序都可以使用相同的 PREPARE 语句。 可指定为 attribute-string 的一部分的选项如下所示:

ASENSITIVE, SENSITIVE, 或 INSENSITIVE

指定游标是对更改敏感，敏感还是不敏感。 有关更多信息，请参阅 DECLARE CURSOR。

如果指定了 SENSITIVE ，那么不得指定 fetch-clause 。 如果指定了 INSENSITIVE ，那么不得指定 update-clause 。

无滚动 或 滚动

指定游标是可滚动还是不可滚动。 有关更多信息，请参阅 DECLARE CURSOR。

WITHOUT HOLD 或 WITH HOLD

指定是否应防止因落实操作而关闭游标。 有关更多信息，请参阅 DECLARE CURSOR。

不带返回 或

指定是否打算将游标的结果表用作将从过程返回的结果集。 有关更多信息，请参阅 DECLARE CURSOR。

offset-子句

指定在检索任何行之前要跳过的行数。 有关更多信息，请参阅 offset-clause。 offset-row-count 必须是常量。

fetch-子句

指定应检索的最大行数。 有关更多信息，请参阅 fetch-clause。 fetch-row-count 必须是常量。 不支持备用 LIMIT 语法。

read-only-clause 或 update-clause

指定结果表是只读表还是可更新表。 必须指定不带列名 (FOR UPDATE) 的 update-clause 子句。 有关更多信息，请参阅 read-only-clause 和 update-clause。

optimize-子句

指定数据库管理器应假定程序不打算从结果表中检索超过 integer 行。 有关更多信息，请参阅 optimize-clause。

隔离子句

指定执行 SELECT 语句的隔离级别。 有关更多信息，请参阅 isolation-clause。

并发访问解决条款

指定要用于 SELECT 语句的并发访问解析。 有关更多信息，请参阅 concurrent-access-resolution-clause。

没有扩展指示符 或具有扩展指示符的

指定在执行 INSERT 或 UPDATE 期间为指示符变量提供的值是否遵循用于指示 NULL 值的标准 SQL 语义，或者是否可以使用包括 DEFAULT 或 UNASSIGNED 在内的扩展指示符值。

仅当语句是使用 INSERT 语句的 VALUES 格式的 INSERT ， UPDATE 语句或语句包含使用 INSERT 语句的 VALUES 格式的 INSERT 时，才必须指定带有扩展指示符。

没有行更改列 或 具有可能相异的行更改列 或 具有始终相异的行更改列

指定是否应将其他列添加到准备好的 select-statement 的结果集，随后可使用这些列来标识行中列的值是否可能已更改。 仅当在最外面的子查询中引用了单个表 (或可更新视图) 时，才会添加其他行更改列。 DESCRIBE 和 GET DESCRIPTOR 语句将指示已添加哪些行。

无行更改列

行更改列不会添加到结果集。 这是缺省情况。

具有可能不同的行更改列

行更改列将添加到结果集，即使它们不唯一表示单个行也是如此。 添加的列可用于确定行中列的值自最初访存以来是否已更改。

• 如果行更改列值自第一次访存以来未更改，那么自第一次访存以来未更改行的任何列。
• 如果行更改列值自首次访存以来已更改，那么该行的列可能已更改，也可能未更改，因为不保证行更改值表示单个行。

具有行更改列时始终相异

仅当行更改列唯一表示单个行时，才会将这些行更改列添加到结果集。 否则，不会向结果集添加任何行更改列。 添加的列可用于确定行中列的值自最初访存以来是否已更改。 (请注意，表需要行更改时间戳记列以保证行的行更改列唯一地标识单个行。)

• 如果行更改列值自第一次访存以来未更改，那么自第一次访存以来未更改行的任何列。
• 如果行更改列值自首次访存以来已更改，那么该行的列已更改。

如果指定了 WITH ROW CHANGE COLUMNS ALWAYS DISTINCT 并且数据库管理器无法返回相异行更改列，那么将返回警告 (SQLSTATE 0168T)。

自

引入语句字符串。 语句字符串是指定的 表达式 string-expression的值。 或标识的 变量。

变量

标识根据声明字符串或 Unicode 图形变量的规则在程序中声明的 变量 。 不得指定指示符变量。

表达式

表达式中描述的类型的 表达式 ，它不包含聚集函数或列名。 它必须返回一个作为字符串或 Unicode 图形字符串的值。 如果在 表达式 中指定了变量，那么该变量的 CCSID 不得为 65535。¹

语句字符串必须是下列其中一个 SQL 语句：

ALLOCATE CURSOR	插入	SET CURRENT DEGREE
ALTER	标签	SET CURRENT IMPLICIT XMLPARSE OPTION
ASSOCIATE LOCATORS	LOCK TABLE	设置当前时间系统时间
CALL	MERGE	SET ENCRYPTION PASSWORD
COMMENT	REFRESH TABLE	SET PATH
COMMIT	RELEASE SAVEPOINT	SET SCHEMA
复合（动态）	RENAME	SET SESSION AUTHORIZATION
创建	撤销	SET TRANSACTION
DECLARE GLOBAL TEMPORARY TABLE	ROLLBACK	SET 变量2
删除	SAVEPOINT	TRANSFER OWNERSHIP
DROP	SELECT 语句	TRUNCATE
FREE LOCATOR	SET CURRENT DEBUG MODE	更新
授予	SET CURRENT DECFLOAT ROUNDING MODE	VALUES INTO
HOLD LOCATOR

语句字符串不得:

• 以 EXEC SQL 开头。
• 以 END-EXEC 或分号结束。
• 包括对变量的引用。 允许使用全局变量。

注意

示例

例 1： 在 COBOL 程序中准备并执行一个非选择语句。 假定语句包含在变量 HOLDER 中，并且程序将根据用户的一些指令将语句字符串放入变量中。 要准备的语句没有任何参数标记。