文章目录
第十六章 以编程方式使用 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
属性中提供用于登录数据源的用户名。