返回首页

gbase数据、南大通用产品文档:GBase8sCREATE PROCEDURE FROM 语句

更新日期:2024年09月11日

使用 CREATE PROCEDURE FROM 语句存取用户定义的过程。CREATE
PROCEDURE 语句的实际文本驻留在单独的文件中。
该语句是 SQL ANSI/ISO 标准的扩展。您可以在 GBase 8s ESQL/C 中使用此语
句。
语法

元素
描述
限制
语法
file
包含 CREATE PROCEDURE
语句的全文本的文件的路
径名和文件名。缺省路径
名为当前目录。
必须存在,并且仅可包含一
个 CREATE PROCEDURE 语
句。另见 持有文件的缺省目

特定于
操作系

file_var 包含文件规范的程序变量
的名称
必须是字符数据类型;其内
容有与 file 相同的限制
特定于
语言
用法

GBase 8s SQL 指南:语法
南大通用数据技术股份有限公司 318
不能直接在 GBase 8s ESQL/C 程序中创建用户定义的过程。这就是说,程序不能
包含 CREATE PROCEDURE 语句。
要在 ESQL/C 程序中使用用户定义的过程:
1. 用 CREATE PROCEDURE 语句创建源文件。
2. 使用 CREATE PROCEDURE FROM 语句来将此源文件的内容发送到数据
库服务器用于执行。
文件仅能包含一个 CREATE PROCEDURE 语句。
例如,假设以下 CREATE PROCEDURE 语句是在称为 raise_pr.sql 的单独文
件中:
CREATE PROCEDURE raise_prices( per_cent INT )
UPDATE stock -- increase by percentage;
SET unit_price = unit_price +
( unit_price * (per_cent / 100) );
END PROCEDURE;
在 GBase 8s ESQL/C 程序中,您可以使用以下 CREATE PROCEDURE FROM 语
句存取 raise_prices( ) SPL 过程:
EXEC SQL create procedure from 'raise_pr.sql';
如果您不确定文件中的 UDR 是否返回值,请使用 CREATE ROUTINE FROM 语
句。
当 IFX_EXTEND_ROLE 配置参数设置成 ON 时,只有拥有内置 EXTEND 角色
的用户才可以创建外部例程。
当 IFX_EXTEND_ROLE 配置参数设置成 1 或 ON 时,只有由数据库服务器管
理员(DBSA)授予内置 EXTEND 角色的用户才能创建外部例程。此外,您对要
注册例程所在的数据库必须至少持有的 Resource 存取权限。还必须对编写例程所
使用的程序语言拥有 Usage 权限。(有关使用 C 语言将 Usage 特权授予用户或
角色的语法,请参阅 语言级权限 。)
用户定义过程,类似用户定义函数,使用创建时有效的对照顺序。请参阅 SET
COLLATION 语句 获取关于使用非缺省对照的信息。

GBase 8s SQL 指南:语法
南大通用数据技术股份有限公司 319
持有文件的缺省目录
数据库服务器将此指定的文件名(以及任何路径名)看作相关的。
在 UNIX™ 上,如果您指定一个简单文件名而不是完整的路径名作为 file 参
数,则客户机应用程序在数据库驻留的计算机上的主目录中寻找文件,如果您在
此计算机上没有主目录,则缺省目录为根目录。
在 Windows™ 上,如果您指定文件名而非目录名为 file 参数,则客户端应用程
序在您的当前工作目录中寻找文件(如果数据库在本地计算机上)。否则,缺省
目录为 %GBASEDBTDIR%\bin 。
重要: GBase 8s ESQL/C 预处理器不处理您指定的文件的内容。它只将内容发送
到数据库服务器用于执行。因此对您在 CREATE PROCEDURE FROM 中指定的文件是
否实际包含 CREATE PROCEDURE 语句没有语法检查。然而,要提高代码的可读
性,建议匹配这两个语句。

嵌套赋值
给变量嵌套赋值的语法请参见图17-3。
图17-3 nested_assignment_value::=
对以上语法格式的解释如下:

variable_name:变量名。

col_name:列名。

subscript:下标,针对数组变量使用,可以是值或表达式,类型必须为int。

value:可以是值或表达式。值value 的类型需要和变量variable_name 的类型兼容
才能正确赋值。
示例:
gbase=#CREATE TYPE o1 as (a int, b int);
postgres=# DECLARE

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
635
TYPE r1 is VARRAY(10) of o1;
emp_id
r1;
BEGIN
emp_id(1).a := 5;--赋值
emp_id(1).b := 5*7784;
END;
/

INTO 方式赋值仅支持对第一层列赋值,且不支持二维及以上数组;

引用嵌套的列值时,
若存在数组下标,
目前仅支持在前三层列中只存在一个小括号
情况,建议使用方括号[ ]引用下标;

简介
审计日志最重要的作用,就是用于监控SQL 执行性能,当一些SQL 语句的执行用
时大于long_query_time 设定值的时候,审计日志便将这些SQL 语句记录下来,方
便用户针对这些执行效率低下的SQL 语句进行分析、优化和改写,从而提高SQL
语句的执行效率。
审计日志记录的主要内容如下:

start_time:开始执行时间;

user_host:登录的用户和IP
显示格式为:priv_user[user]@hostname[ip];

query_time:执行语句所用时间;

rows:行数;

db:执行语句所针对的数据库;

sql_text:记录执行用时大于long_query_time 设定值的SQL 语句;

conn_type:用户登录方式(CAPI、ODBC、JDBC、ADO.NET)。
目前,用户每次查看的审计日志为登录节点机器上的日志内容。

GBase UP 产品手册 4 管理员指南

文档版本04(2021-04-21) 南大通用数据技术股份有限公司 148