第十五章 以编程方式使用 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

02-11 08:44