第十六章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性
文章目录
- 第十六章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 方法和属性
- GetOneRow()
- `GetParameter()`
- GetUV()
- Password property
- `SetConnectOption()`
- `SetParameter()`
- 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属性中提供用于登录数据源的用户名。