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

时间:2024-02-17 16:21:03

文章目录

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