文章目录
第十五章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性
FetchRows()
返回(通过引用)给定连接句柄的指定行数。
method FetchRows(hstmt, Output rlist As %List, nrows As %Integer) as %Status
这里 hstmt 是连接句柄,从 AllocateStatement() 返回(通过引用)。另外,rlist 是返回的行列表;这是 InterSystems IRIS $ 列表。列表中的每个项目都包含一行。如果没有数据(SQL_CODE = 100),则假定获取成功,但返回列表为空。
注意:此方法主要用于测试,它会将字符字段截断最多 120 个字符,以便在一行中容纳更多字段。当您需要非截断数据时,请使用 GetData()。
GatewayStatus property
%String\ 属性中提供上次调用的状态。状态值将为以下之一:
- 0 - 成功
- -1 - SQL 错误
- -1000 - 严重错误
GatewayStatusGet()
返回上次调用的错误代码。
method GatewayStatusGet() as %Integer
它不会初始化错误代码,并且可以多次调用。
GetConnection()
建立连接,使用配置文件条目确定 DSN、用户名和密码。
method GetConnection(conn, timeout) as %Status
GetGTWVersion()
返回共享库的当前版本。
method GetGTWVersion() as %Integer
GetLastSQLCode()
如果此调用不返回 SQL 代码(例如,如果使用 SQLGetData()),则返回上次调用的 SQL 代码。
method GetLastSQLCode() as %Integer