sa_conn_properties 系统过程

报告连接属性信息。

语法

sa_conn_properties( [ connidparm ] )

参数

connidparm 使用此可选的 INTEGER 参数指定连接的 ID 号。

结果集

列名	数据类型	说明
Number	INTEGER	连接的 ID 号。
PropNum	INTEGER	连接属性编号。
PropName	VARCHAR(255)	连接属性名称。
PropDescription	VARCHAR(255)	连接属性说明。
Value	LONG VARCHAR	连接属性值。

注释

以 Number 的形式返回连接 ID，并返回每个可用连接属性的 PropNum、PropName、PropDescription 和 Value。返回所有连接属性、与连接相关的数据库选项设置以及与连接相关的统计信息的值。同时返回具有 NULL 值的有效属性。

如果没有提供 connidparm，则返回当前数据库的所有连接的属性。如果 connidparm 小于零，则返回当前连接的选项值。

权限

无

副作用

无

另请参见

示例

以下示例使用 sa_conn_properties 系统过程为所有连接返回一个汇总连接属性信息的结果集。

CALL sa_conn_properties( );

Number	PropNum	PropName	...
79	37	CacheHits	...
79	38	CacheRead	...
...	...	...	...

以下示例使用 sa_conn_properties 系统过程返回所有连接的列表，并按 CPU 时间降序排序*：

SELECT Number AS connection_number,
    CONNECTION_PROPERTY ( 'Name', Number ) AS connection_name,
    CONNECTION_PROPERTY ( 'Userid', Number ) AS user_id,
  CAST ( Value AS NUMERIC ( 30, 2 ) ) AS approx_cpu_time
  FROM sa_conn_properties()
  WHERE PropName = 'ApproximateCPUTime'
  ORDER BY approx_cpu_time DESC;

*经 Breck Carter 允许使用的示例，引自 RisingRoad Professional Services，网址为 [external link] http://www.risingroad.com。