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

Null SQL statement
传入的 SQL 语句为空。
请检查您的应用程序的 SQL 语句字符串，以确保它包含有效的语句。

终止用户会话
（SQL 管
理 API）
随同 admin() 或 task() 函数，使用 onmode 和 z 参数来终止指定的用户会话。
语法

元素
描述
关键考虑
session_id
会话 ID。
该值必须为大于 0 的无符号整数，且必须为当前正在
运行的会话的会话标识号。

用法
这个函数等同于 onmode -z 命令。
示例
下列示例终止 ID 为 14 的用户会话：
EXECUTE FUNCTION task("onmode","z","14");

CALL PKG_SERVICE.JOB_UPDATE(101, 'insert into tbl_a values(sysdate);', sysdate,
'sysdate + 1.0/1440');

PKG_SERVICE.SUBMIT_ON_NODES
存储过程SUBMIT_ON_NODES 创建一个结点上的定时任务，
仅sysadmin/monitor admin

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
687
有此权限。
PKG_SERVICE.SUBMIT_ON_NODES 函数原型为：
PKG_SERVICE.SUBMIT_ON_NODES(
node_name
IN
TEXT,
database
IN
TEXT
what
IN
TEXT,
next_date
IN
TIMESTAMP DEFAULT sysdate,
job_interval IN
TEXT
DEFAULT 'null',
job
OUT
INTEGER);
表17-13 PKG_SERVICE.SUBMIT_ON_NODES 接口参数说明
参数
类
型
入参/出
参
是否
可以
为空
描述
node_na
me
text
IN
否
指定作业的执行节点，
当前仅支持值为'ALL_N
ODE'（在所有节点执行）与'CCN'（注：CCN
在集中式/小型化环境下无意义）。
database
text
IN
否
数据库实例作业所使用的database，节点类型
为'ALL_NODE'时仅支持值为'postgres'。
what
text
IN
否
要执行的SQL 语句。支持一个或多个‘DML’，
‘匿名块’，
‘调用存储过程的语句’或3 种混合的
场景。
nextdate
time
sta
mp
IN
否
下次作业运行时间。默认值为当前系统时间（s
ysdate）。如果是过去时间，在提交作业时表示
立即执行。
job_inter
val
text
IN
否
用来计算下次作业运行时间的时间表达式，可
以是interval 表达式，也可以是sysdate 加上一
个numeric 值（例如：sysdate+1.0/24）。如果
为空值或字符串”null”表示只执行一次，
执行后
JOB 状态STATUS 变成'd'不再执行。
job
inte
ger
OUT
否
作业号。范围为1～32767。当使用select 调用
dbms.submit_on_nodes 时，该参数可以省略。
示例：

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
688
select pkg_service.submit_on_nodes('ALL_NODE', 'postgres', 'select
capture_view_to_json(''dbe_perf.statement'', 0);', sysdate, 'interval ''60
second''');
select pkg_service.submit_on_nodes('CCN', 'postgres', 'select
capture_view_to_json(''dbe_perf.statement'', 0);', sysdate, 'interval ''60
second''');

PKG_SERVICE.ISUBMIT_ON_NODES
ISUBMIT_ON_NODES 与SUBMIT_ON_NODES 语法功能相同，但其第一个参数是入
参，即指定的作业号，SUBMIT 最后一个参数是出参，表示系统自动生成的作业号。仅
sysadmin/monitor admin 有此权限。

PKG_SERVICE.SQL_GET_ARRAY_RESULT
该函数用来返回绑定的数组类型的OUT 参数的值，可以用来获取存储过程中的OUT
参数。
PKG_SERVICE.SQL_GET_ARRAY_RESULT 函数原型为：
PKG_SERVICE.SQL_GET_ARRAY_RESULT(
context_id in int,
pos in VARCHAR2,
column_value inout anyarray,
result_type in anyelement
);
表17-14 PKG_SERVICE.SQL_GET_ARRAY_RESULT 接口说明
参数名称
描述
context_id
想查找的CONTEXT ID 号。
pos
绑定的参数名。
column_value
返回值。
result_type
返回值类型。

PKG_SERVICE.SQL_GET_VARIABLE_RESULT
该函数用来返回绑定的非数组类型的OUT 参数的值，
可以用来获取存储过程中的OUT

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
689
参数。
PKG_SERVICE.SQL_GET_VARIABLE_RESULT 函数原型为：
PKG_SERVICE.SQL_GET_VARIABLE_RESULT(
context_id in int,
pos in VARCHAR2,
result_type in anyelement
)
RETURNS anyelement;
表17-15 PKG_SERVICE.SQL_GET_VARIABLE_RESULT 接口说明
参数名称
描述
context_id
想查找的CONTEXT ID 号。
pos
绑定的参数名。
result_type
返回值类型。