Informix IDS 11琐细管理(918测验)认证指南,第8局部:面向管理员的SQL特征(3)

SQL 管理 API 函数

SQL 管理 API 是内置的 SQL 管理 API 函数，可经过历程 SQL 的 EXECUTE Ffunction 语句完成管感性义务，该语句可以模仿 Dynamic Server 的种种管理号令行适用工具。

ADMIN 和 TASK 内置函数只在每个 Dynamic Server 实例的 sysadmin 数据库中做了界说。这些函数只能由用户 Informix 挪用。

应用相反参数列表挪用 admin( ) 和 task( ) 函数的结局是相反的；只是前往的值不同：

task() UDR 前往描绘前往形态的字符串
admin() UDR 前往一个整数前往形态，施展阐发到 command_history 表的链接
- 若是该值年夜于 0，则号令成功实行，并将一个新行拔出到 command_history 表
- 若是该值为 0，施展阐发号令成功，可是 Dynamic Server 不会把新行拔出到 command_history 表
- 若是该值小于 0，施展阐发号令失败，可是仍然将新行拔出到 command_history 表中

表 1. sysadmin 数据库中的 command_history 表
列数据规范申明
cmd_number serial 每行的专一 ID
cmd_exec_time datetime year-to-second 发出号令的时分
cmd_user varchar 实行号令的用户
cmd_hostname varchar 实行号令的主机的称呼
cmd_executed varchar 实行的号令
cmd_ret_status integer 前往代码
cmd_ret_msg lvarchar 前往音讯

当向 ADMIN 或 TASK 函数指定 size 参数时，可以应用下面的单位申明：

表 2. ADMIN 或 TASK 函数 size 参数的单位申明
标记对应的单位
B Bytes（= 2 的 0 次方)
KB Kilobytes（= 2 的 10 次方)
MB Megabytes（= 2 的 20 次方）
GB Gigabytes（= 2 的 30 次方）
TB Terabytes（= 2 的 40 次方）
PB Petabytes（= 2 的 50 次方）

应用 ADMIN 或 TASK 函数的示例

号令 oncheck -ce 等效于以下 SQL 语句：

EXECUTE FUNCTION task('check extents');

函数 admin() 也可以完成相反的结局：

EXECUTE FUNCTION admin('check extents');

号令 onspaces -c -d dbspace2 -p /informix/chunks/dbs2.00 -o 0 -s 20000 等价于以下 SQL 语句：

EXECUTE FUNCTION task('create dbspace','dbspace2','/informix/chunks/dbs2.00','20MB');
    (expression)  Space 'dbspace2' added.

（注：当应用函数 task() 时，前往值为描绘形态的字符串）。

也可以应用函数 admin() 完成相反结局：

EXECUTE FUNCTION admin('create dbspace','dbspace2','/informix/chunks/dbs2.00','20MB');
    (expression)  114

（注：前往值为 114，可在 command_history 表中找到）。

清单 10. 在 command_history 表中查找前往值

                    
    SELECT  * FROM command_history WHERE cmd_number = 114
    cmd_number      114
    cmd_exec_time   2007-05-10 20:13:22
    cmd_user        informix
    cmd_hostname    gavea.usfl.ibm.com
    cmd_executed    create dbspace
    cmd_ret_status  0
    cmd_ret_msg     Space 'dbspace2' added.
    1 row(s) retrieved.