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

文章目录

• [第十六章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性](#第十六章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性)
• • GetOneRow()
  • `GetParameter()`
  • GetUV()
  • [Password property](#Password property)
  • `SetConnectOption()`
  • `SetParameter()`
  • [SQL 代码属性](#SQL 代码属性)
  • `UnloadDLL()`
  • 用户属性

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

GetOneRow()

返回（通过引用）给定连接句柄的下一行。

method GetOneRow(hstmt, ByRef row) as %Status

这里 hstmt 是连接句柄，从 AllocateStatement() 返回（通过引用）。另外，row 是返回的行，一个 IRIS $list。列表中的每个项目都包含一个字段。如果没有数据（SQL_CODE = 100），则假定获取成功，但返回列表为空。

注意：此方法主要用于测试，它会将字符字段截断最多 120 个字符，以便在一行中容纳更多字段。当您需要非截断数据时，请使用 GetData()。

GetParameter()

返回（通过引用）指定参数的当前值。

method GetParameter(hstmt, pnbr, ByRef value) as %Status

这里 hstmt 是从 AllocateStatement() 返回的连接句柄（通过引用），pnbr 是参数的序号。

GetUV()

返回（通过引用）共享库是否构建为 Unicode。

method GetUV(ByRef infoval) as %Status

请注意，此方法始终返回 $$$OK 状态。

Password property

%String在提供关联密码。

SetConnectOption()

调用 ODBC 函数 SQLSetConnectAttr()。

method SetConnectOption(opt, val) as %Status

仅支持整数值。 opt 参数的整数值可以从 sql.h 和 sqlext.h 头文件中获取。

SetParameter()

设置先前绑定的参数的值。

method SetParameter(hstmt, pvalue, pnbr) as %Status

这里 hstmt 是从 AllocateStatement() 返回的连接句柄（通过引用），pvalue 是要使用的值，pnbr 是参数的序号。参数以$list 格式存储。如果分配的缓冲区不够，则将分配新的缓冲区。

SQL 代码属性

%Intege属性中，提供上次调用返回的 SQL 代码（如果有）。

UnloadDLL()

从进程内存中卸载 ODBC SQL 网关的共享库。

method UnloadDLL() as %Status

用户属性

%String属性中提供用于登录数据源的用户名。