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

文章目录

• 第十五章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性
• • FetchRows()
  • 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