第十五章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性

文章目录

• [第十五章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性](#第十五章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性)
• • FetchRows()
  • [GatewayStatus property](#GatewayStatus property)
  • GatewayStatusGet()
  • GetConnection()
  • GetGTWVersion()
  • GetLastSQLCode()

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