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