gbase数据、南大通用产品文档：GBase8s语句块

使用语句块指定，当执行一个包含本段的 SPL 语句时，进行 SPL 和 SQL 操
作。
语法
语句块

用法
SPL 和 SQL 语句可以出现在语句块中，语句块是能够定义变量或 SPL 的 ON
EXCEPTION 语句的范围的零个或多个语句。如果语句块为空，当 SPL 例程中
的执行控制传递给空的 SPL 语句块时不会发生任何操作。

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1688
SPL 语句的子集在语句块中有效
语句块的语法引用了此节。您可以在语句块中使用下列任何 SPL 语句：

<>

CALL

CASE

CONTINUE

EXIT

FOR

FOREACH

GOTO

IF

LET

LOOP

RAISE EXCEPTION

RETURN

SYSTEM

TRACE

WHILE
但是，GOTO 和 << Label >> 在 ON EXCEPTION 语句块中无效。
SQL 语句在 SPL 语句块中有效
语句块的图表涉及这一节的内容。大多数 SQL 语句在 SPL 语句块中有效，除了
以下列出的语句。下列 SQL 语句在 SPL 语句块中无效：

CLOSE DATABASE

CONNECT

CREATE DATABASE

CREATE FUNCTION

CREATE FUNCTION FROM

CREATE PROCEDURE

CREATE PROCEDURE
FROM

CREATE ROUTINE FROM
DATABASE

DISCONNECT

EXECUTE

FLUSH

INFO

LOAD

OUTPUT

PUT

RENAME DATABASE

SET AUTOFREE

SET CONNECTION

UNLOAD

UPDATE STATISTICS

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1690
例如，您不能在 SPL 例程中关闭数据库或连接新的数据库。同样，您不能在同一
例程中删除当前 SPL 例程。然而，您可以删除另一个 SPL 例程。
只能在两种情况下使用 SELECT 语句：

可以使用 INTO TEMP 子句把 SELECT 语句的结果放进一个临时表。

可以使用 SELECT 语句的 SELECT ... INTO 形式把结果值放进 SPL 变
量。
当在 SELECT ... INTO TEMP 或 SELECT ... INTO variable 语句中包含 ORDER
BY 子句时，这表示此查询返回多行。如果您指定没有 FOREACH 循环的
ORDER BY 子句来在 SPL 例程中单独处理返回的行，那么数据库服务器会发出
错误。
如果后面 SPL 例程要作为数据操纵语言（DML）语句的一部分被调用，还有附
加的限制。有关更多信息，请参阅在数据操纵语句中 SPL 例程的限制。
嵌套语句块
可以使用 BEGIN 和 END 关键字来定界嵌套在另一个语句块中的语句块。
引用 SPL 变量和异常处理程序的作用域
BEGIN 和 END 关键字可以限制 SPL 变量和异常处理程序的作用域。在
BEGIN 和 END 语句块中的变量声明和异常处理程序定义是语句块局部的，在语
句块外面不可见。下面的代码使用了 BEGIN 和 END 语句块来限定变量引用的
作用域：
CREATE DATABASE demo;
CREATE TABLE tracker (
who_submitted CHAR(80), -- Show what code was running.
value INT, -- Show value of the variable.
sequential_order SERIAL -- Show order of statement execution.
);
CREATE PROCEDURE demo_local_var()
DEFINE var1, var2 INT;
LET var1 = 1;
LET var2 = 2;
INSERT INTO tracker (who_submitted, value)
VALUES ('var1 param before sub-block', var1);

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1691
BEGIN
DEFINE var1 INT; -- same name as global parameter.
LET var1 = var2;
INSERT INTO tracker (who_submitted, value)
VALUES ('var1 var defined inside the "IF/BEGIN".', var1);
END
INSERT INTO tracker (who_submitted, value)
VALUES ('var1 param after sub-block (unchanged!)', var1);
END PROCEDURE;
EXECUTE PROCEDURE demo_local_var();
SELECT sequential_order, who_submitted, value FROM tracker
ORDER BY sequential_order;
这个示例声明了三个变量，其中两个名为 var1。（这里创建的名称冲突是为了说
明哪种变量是可见的。通常建议对不同变量不要使用相同的名称。因为冲突的变
量名会造成代码可读性差并且难维护。）
因为语句块的关系，每次只有一个 var1 变量在作用域中。
在语句块中声明的 var1 变量是唯一可以在语句块中引用的 var1 变量。
在语句块外面声明的 var1 变量在语句块中是不可见的。因为它在作用域之外，
所以发生在语句块内部的 var1 变量值的更改对它没有影响。所有语句运行以
后，外面的 var1 的值仍然是 1。
var2 变量在语句块中可见，因为它没有因名称冲突而被块专用变量替代。
在数据操纵语句中 SPL 例程的限制
如果在非数据操纵语言（DML）语句（即 EXECUTE FUNCTION 或 EXECUTE
PROCEDURE）的 SQL 语句中调用 SPL 例程，那么 SPL 例程可以执行未列在
SQL 语句在 SPL 语句块中有效一节中的任何语句。
如果 SPL 例程作为 DML 语句（即 INSERT 、UPDATE 、DELETE 、MERGE 或
SELECT 语句）的一部分调用，那么例程不能执行下面列表中的任何 SQL 语句：

ALTER ACCESS_METHOD

ALTER FRAGMENT

ALTER INDEX

ALTER SEQUENCE

ALTER TABLE

BEGIN WORK

COMMIT WORK

CREATE ACCESS_METHOD

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1692

CREATE AGGREGATE

CREATE DISTINCT TYPE

CREATE OPAQUE TYPE

CREATE OPCLASS

CREATE ROLE

CREATE ROW TYPE

CREATE SEQUENCE

CREATE TRIGGER

DELETE

DROP ACCESS_METHOD

DROP AGGREGATE

DROP INDEX

DROP OPCLASS

DROP ROLE

DROP ROW TYPE

DROP SEQUENCE

DROP SYNONYM

DROP TABLE

DROP TRIGGER

DROP TYPE

DROP VIEW

INSERT

MERGE

RENAME COLUMN

RENAME DATABASE

RENAME SEQUENCE

RENAME TABLE

ROLLBACK WORK

SET CONSTRAINTS

TRUNCATE

UPDATE
如果 SPL 例程的调用上下文是试图执行以上列出的任何 SQL 语句的 DML 语
句，则 GBase 8s 发出错误 -675。
这些限制不适用于触发器调用的 SPL 例程，因为在这些情况下 SPL 例程不是由
DML 语句调用，因而可以包含任意未列在 SQL 语句在 SPL 语句块中有效中的
SQL 语句，例如 UPDATE 、INSERT 和 DELETE。
SPL 例程中的事务
在不符合 ANSI 的数据库中，可以在 SOL 语句中使用 BEGIN WORK 和
COMMIT WORK 语句启动事务、结束事务、或者在同一 SPL 例程中启动和终止
的事务。如果在远程执行的例程中启动一个事务，必须在例程退出之前结束这个
事务。
然而，就像前面提到的，ROLLBACK WORK 语句在 SPL 语句块中是无效的。
对用户身份和角色的支持
可以在 SPL 例程中使用角色。可以在 SPL 例程中执行角色相关语句（CREATE
ROLE 、DROP ROLE 、GRANT 、REVOKE 和 SET ROLE）并且持有

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1693
SETSESSIONAUTH 特权的用户可以发出 SESSION AUTHORIZATION 语句。在
SPL 例程中，您可以使用 GRANT 语句

授予角色自由访问权限，

或向角色授予基于标签的访问凭证（LBAC），

或向角色授予其它角色。
SPL 例程还可以使用 REVOKE 语句撤销角色的访问特权、LBAC 凭证或角色。
在授予访问特权、角色和 LBAC 凭证的 SPL 例程完成执行后，用户通过启用角
色或通过 SET SESSION AUTHORIZATION 语句在 SPL 例程中获取的访问权
限，角色和 LBAC 凭证不会自动退出。所授予的内容持续存在，直到后续的
REVOKE 操作取消 GRANT 操作的效果。
有关角色的更多信息，请参阅第二章中的 CREATE ROLE 语句 、DROP ROLE
语句 、GRANT 语句 、REVOKE 语句 和 SET ROLE 语句。

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1694
6. 内置例程
该主题描述创建数据库时被数据库服务器所知的标识符的例程，但是其用法与第
4 章描述的内置 SQL 函数有所不同。
内置例程可以根据它们执行的任务分类：

会话配置过程
o
SYSDbClose( )
o
SYSDbOpen( )

DataBlade 模块管理函数
o
SYSBldPrepare( )
o
SYSBldRelease( )

Visual Explain 输出生成函数
o
Explain_SQL( )

UDR 定义例程
o
ifx_Replace_Module( )
o
ifx_Unload_Module( )
o
jvpControl( )
o
sqlj.Alter_Java_Path( )
o
sqlj.Install_jar( )
o
sqlj.Remove_jar( )
o
sqlj.Replace_jar( )
o
sqlj.SetUDTExtName( )
o
sqlj.UnsetUDTExtName( )
o
sysibm.Metadata( )
o
sysibm.sqlcaMessage( )
如果数据库服务器配置为支持 DRDA 协议，则会自动创建 Metadata 和
sqlcaMessage 例程。SYSDbOpen 和 SYSDbClose 例程可以在任一 GBase 8s 数据
库中定义。
随后的章节描述了这些类别和每个类别中的例程。

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1695

onstat 实用程序读取共享内存结构，并提供有关数据库服务器在该命令执行时的统计信息。

可在单个命令中组合多个 onstat 选项标志。
onstat 显示输出时，
共享内存的内容可能更改。
onstat 实用程序不在共享内存上放置任何锁，因此运行该实用程序不会影响性能。
可使用等同于 onstat 命令的 SQL 管理 API 函数。

GetValues 方法
获得当前行中所有属性，返回属性的数量。

语法
[Visual Basic]
Public Overrides Function GetValues ( _

values As Object() _
) As Integer
[C#]
public override int GetValues(

Object[] values
)

GBase 8a 程序员手册ADO.NET 篇


- 246 -

南大通用数据技术股份有限公司

参数
1) values ：获取的所有属性

实现
IDataRecord.GetValues(Object[])