文章目录
- [第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考](#第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考)
- [%SQLGatewayConnection 快速参考](#%SQLGatewayConnection 快速参考)
第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考
%SQLGatewayConnection 快速参考
%SQLGatewayConnection API 概述
%SQLGatewayConnection
提供了可用于管理与外部数据源的连接、检查状态信息以及获取有关 ODBC
共享库的信息的属性和方法。下面列出了本参考中涵盖的方法和属性,按用途组织:
管理连接
%SQLGatewayConnection
提供可用于管理与外部数据源的连接的属性和方法。
DSN
---(%String
属性)要连接的符合ODBC
的数据源的数据源名称。User
用户 ---(%String
属性)用于登录数据源的用户名。Password
密码 ---(%String
属性)关联密码ConnectionHandle
---(%Binary
属性)与ODBC
兼容的数据源的当前连接句柄。Connect()
--- 建立与DSN
的连接。GetConnection()
--- 使用配置设置建立连接以确定DSN
、用户名和密码。SetConnectOption()
--- 调用ODBC
函数SQLSetConnectAttr
。Disconnect()
--- 关闭连接。
状态及查询方法
%SQLGatewayConnectio
n 的大多数方法都会返回一个状态,应该检查该状态。还可以通过以下属性和方法获取状态信息:
sqlcode
---(%Integer
属性)包含上次调用返回的SQL
代码(如果有)。GatewayStatus
---(%Integer
属性)指示上次调用的状态。GetLastSQLCode()
--- 如果此调用不返回SQL
代码,则返回上次调用的SQL
代码。GatewayStatusGet()
--- 返回上次调用的错误代码。
以下方法从结果集中获取行:
FetchRows()
--- 返回(通过引用)给定连接句柄的指定行数。GetOneRow()
--- 返回(通过引用)给定连接句柄的下一行。
以下方法获取和设置绑定查询参数的值:
GetParameter()
--- 返回(通过引用)指定参数的当前值。SetParameter()
--- 设置先前绑定的参数的值。
使用共享库
%SQLGatewayConnection
提供了属性和方法,可以调用这些属性和方法来获取有关 ODBC SQL
网关使用的共享库的信息。
DLLHandle
---(%Binary
属性)当前使用的共享库的句柄。这是在连接时设置的。DLLName
---(%String
属性)当前使用的共享库的名称。这是在连接时设置的。GetGTWVersion()
--- 返回共享库的当前版本。GetUV()
---(通过引用)返回共享库是否构建为Unicode
。请注意,此方法始终返回$$$OK
状态。UnloadDLL()
--- 从进程内存中卸载共享库。