更新日期：2024年09月11日
当您关闭 Statement 和 ResultSet 对象时，可以使用环境变
量 OPTOFC 和 IFX_AUTOFREE 减少网络流量。
将 OPTOFC 设置为 1 来指定：如果已在客户端元组缓冲区检索到所有合格的行，
则 ResultSet.close() 方法不需要网络。在检索完所有的行后，数据库服务器自动关闭游标。
在调用下一个 ResultSet.next() 方法之前，
GBase 8s JDBC Driver 在客户端元组缓冲区中可能
有也可能没有附加的行。因此，除非 GBase 8s JDBC Driver 已经从数据库服务器检索到所
有的行，否则当 OPTOFC 设置为 1 时，ResultSet.close() 方法可能仍然需要网络往返。
将 IFX_AUTOFREE 设置为 1 以指定如果数据库服务器中的游标已经关闭，
则 Statement.close() 方法不需要网络往返来释放数据库服务器游标资源。
还可以使用 setAutoFree(boolean flag) 和 getAutoFree() 方法释放数据库服务器游标资源。有
关更多信息，请参阅“自动释放”特性。
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 234 -
当游标关闭后，数据库服务器显式地通过 ResultSet.close()方法或隐式地通过 OPTOFC 环境
变量自动释放游标资源。
当游标资源释放后，该游标不能再被引用。
有关如何使用 OPTOFC 和 IFX_AUTOFREE 环境变量的示例，
请参阅 示例代码文件 中描
述的 autofree.java optofc.java 演示示例。
在这些示例中，
使用 Properties.put() 方法设置变量。
有关 GBase 8s 环境变量的设置的更多信息，请参阅随同 GBase 8s JDBC 驱动程序的
GBase 8s 环境变量。
sqlstart() 函数启动隐式的缺省连接。隐式的缺省连接可支持至缺省数据库服务器的一
个连接。（GBASEDBTSERVER 环境变量指定的）。
提示： 在仅使用一个连接的 6.0 版本之前，限制应用程序使用 sqlstart()。为了与这
些应用程序的较早版本相兼容，
GBase 8s ESQL/C 继续支持此函数。
对于 Version 6.0 和更
晚的应用程序，请使用 CONNECT 语句来建立至缺省数据库服务器的显示的连接。
语法
mint sqlstart();
用法
GBase 8s ESQL/C 为仅支持单个连接的 Version 6.0 之前的应用程序提供 sqlstart()
函数。在此上下文中，可能的 sqlstart() 使用如下：
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 950 -
您仅需证实缺省数据库服务器可用，但您不打算打开数据库。如果 sqlstart() 调用失
败，则您可检查返回状态来证实缺省数据库服务器不可用。
当应用程序在网络上运行时，
您需要加速 DATABASE 语句的执行。
当您将 sqlstart()
的调用放置在初始化例程中时，在用户开始与该应用程序交互之前，应用程序建立连接。
然后，DATABASE 语句可打开指定的数据库。
您不知道要访问的实际数据库的名称，
或您的应用程序计划创建数据库。
调用 sqlstart()
可建立隐式的缺省连接，且稍后应用程序可确定要访问或创建的数据库的名称。
如果您有一个 6.0 版本之前的应用程序，
处于任何其他原因，
其需要隐式的缺省连接，
则请使用 DATABASE 语句，而不是 sqlstart()。对于 6.0 版及其后来的应用程序，请使用
CONNECT 语句来建立数据库服务器连接。
当您调用 sqlstart() 函数时，
请确保该应用程序尚未建立任何连接，
隐式的或显式的。
当应用程序已建立了显式的连接时，sqlstart() 返回错误 -1811。如果建立了隐式的连接，
则 sqlstart() 返回错误 -1802。
在您建立显式的连接之前，您可多次调用此函数，只要在下一 sqlstart()
调用之前断开每一隐式的连接即可。
返回代码
0
sqlstart() 调用成功。
<0
sqlstart() 调用不成功。