Sybase数据库技术,数据库恢复

 

随着Sybase被完全整合到SAP下，Sybase原来的支持网站被SAP Support Portal取代。
只有购买了SAP服务的用户才能使用账号登录SAP Support Portal进行介质下载、补丁升级、报Incident等。
目前，原Sybase所有产品（包括：Adaptive Server Enterprise、Sybase IQ、Replication Server、PowerDesigner等）的官方手册仍然可以从https://infocenter.sybase.com/help/index.jsp进行浏览或下载。暂不清楚该网站https://infocenter.sybase.com/help/index.jsp何时会被完全迁移到SAP Support上！
Sybase官方手册英文版有html和pdf两种格式，而中文版手册只有pdf一种格式。为了国内Sybase用户更方便、快捷地搜索Sybase常见产品的官方手册内容，特将中文版Sybase官方手册转为html格式！
Sybase产品官方手册中文版的html格式所有内容的版权归SAP公司所有！本博客站长是Sybase数据库的铁杆粉丝！

如有Sybase数据库技术问题需要咨询，请联系我！

  QQ :289965371
  Email:

以下官方手册为ASE 15.7 ESD#2中文版：

1. 新增功能公告 适用于 Windows、Linux 和 UNIX 的 Open Server 15.7 和 SDK 15.7
   
2. 新增功能摘要
   
3. 新增功能指南
   
4. ASE 15.7 发行公告
   
5. 配置指南（windows）
   
6. 安装指南（windows）
   
7. 参考手册：构件块
   
8. 参考手册：命令
   
9. 参考手册：过程
   
10. 参考手册：表
    
11. Transact-SQL® 用户指南
    
12. 系统管理指南，卷 1
    
13. 系统管理指南，卷 2
    
14. 性能和调优系列：基础知识
    
15. 性能和调优系列：锁定和并发控制
    
16. 性能和调优系列：监控表
    
17. 性能和调优系列：物理数据库调优
    
18. 性能和调优系列：查询处理和抽象计划
    
19. 性能和调优系列：使用 sp_sysmon 监控 Adaptive Server
    
20. 性能和调优系列：利用统计分析改进性能
    
21. 程序员参考 jConnect for JDBC 7.0.7
    
22. Adaptive Server Enterprise 中的 Java
    
23. 组件集成服务用户指南
    
24. Ribo 用户指南
    
25. 内存数据库用户指南
    
26. Sybase Control Center for Adaptive Server® Enterprise
    
27. 安全性管理指南
    
28. 实用程序指南
    

 

< 上一个 | 内容 | 下一步 >

连接属性 ‌ ‌

连接属性指定登录到服务器所需的信息并定义预期的客户端和服务器行 为。连接属性名称不区分大小写。

设置连接属性

必须在连接到服务器之前设置连接属性。可使用两种方法设置连接属性：

● 在应用程序中使用 DriverManager.getConnection 方法。

● 在定义 URL 时设置连接属性。

注释 在 URL 中设置的驱动程序连接属性不会覆盖在应用程序中使 用 DriverManager.getConnection 方法设置的任何相应的连接属性。

下面的示例代码使用了 DriverManager.getConnection 方法。随 jConnect 提 供的示例程序也包含设置这些属性的示例。

Properties props = new Properties(); props.put("user", "userid"); props.put("password", "user_password");

/*

* If the program is an applet that wants to access

* a server that is not on the same host as the

* web server, then it uses a proxy gateway.

*/

props.put("proxy", "localhost:port");

/*

* Make sure you set connection properties before

* attempting to make a connection.You can also

* set the properties in the URL.

*/

Connection con = DriverManager.getConnection ("jdbc:sybase:Tds:host:port", props);

列出当前连接设置

若要列出驱动程序的当前连接设置，请使用 Driver.getDriverPropertyInfo(String url, Properties props)。该代码返回包含以 下内容的 DriverPropertyInfo 对象数组：

● 驱动程序属性

● 驱动程序属性所基于的当前设置

● URL 和传入的属性

jConnect 连接属性列表

表 2-2 列出了 jConnect 的连接属性并给出了其缺省值。这些属性不区分 大小写。

可使用 getClientInfo() 和 setClientInfo() 标准方法动态设置标记为 Dynamic

的连接属性的值。

表 2-2：连接属性

缺省

属性 说明 值

Dynamic

或 Static

ALTERNATE_ SERVER_NAME

指定镜像 SQL Anywhere 环境中主数据库和辅助数 据库使用的备用服务器名称。主数据库和辅助数据 库使用相同的备用服务器名称，因此客户端应用程 序可以连接到当前主服务器，而无需事先知道两台 服务器中的哪一台是主服务器。

JDBC URL 的语法仍然是 jdbc:sybase:Tds:<hostname>:<port#>/databa se?connection_property=value;。但是，如果

设置了 ALTERNATE_SERVER_NAME， jConnect

将忽略 hostname 和 port 变量的值，而是使用 SQL Anywhere UDP 发现协议来确定当前主服务器。

有关数据库镜像的信息，请参见 《SQL Anywhere

服务器–数据库管理》。

注释 也可以对未镜像的 SQL Anywhere 使用 ALTERNATE_SERVER_NAME。不过，您将始终 从单独的服务器获取相同的主机和端口值。

Null Static

APPLICATIONNAME 指定应用程序名称。这是一个用户定义的属性。可

以编程使服务器端解释为此属性提供的值。

Null Static

BE_AS_JDBC_ COMPLIANT_AS_ POSSIBLE

调整其它属性以确保 jConnect 方法的应答方式尽可 能符合 JDBC 3.0 标准。

如果将该属性设置为 “true”，将影响 （并覆盖） 下列属性：

● CANCEL_ALL （设置为 “false”）

● LANGUAGE CURSOR （设置为 “false”）

● SELECT_OPENS_CURSOR （设置为 “true”）

● FAKE_METADATA （设置为 “true”）

● GET_BY_NAME_USES_COLUMN_LABEL （设 置为 “false”）

False Static

缺省

属性 说明 值

Dynamic

或 Static

CACHE_COLUMN_ METADATA

如果重复使用执行 SELECT 查询的 PreparedStatement 或 CallableStatement 对象，则将 CACHE_COLUMN_METADATA 设置为 true 可以提 高性能。设置为 true 时，该语句将会记住与第一次 执行该语句时所返回的 SELECT 查询结果关联的 ResultSet Metadata 信息。以后执行该语句时，将会 重用这些元数据，而不必重新构建。这可以通过使 用更多内存来节省 CPU 时间。

在连接到 Adaptive Server 15.7 ESD #1 及更高版本时， 应使用 SUPPRESS_ROW_FORMAT 连接属性。

False Static

CANCEL_ALL 指定 Statement.cancel 方法的行为：

● 如果 CANCEL_ALL 为 false，那么调用 Statement.cancel 将只取消调用其的 Statement 对 象。因此，如果 stmtA 是 Statement 对象， stmtA.cancel 将取消执行数据库中 stmtA 所包含的 SQL 语句，而不影响其它语句。无论 stmtA 是在 高速缓存中等待执行还是已开始执行并且正在等 待结果，都会取消该命令。

● 如果 CANCEL_ALL 为 true，那么调用 Statement.cancel 将不仅取消调用其的对象，还将 取消同一连接上已开始执行并且正在等待结果的 任何其它 Statement 对象。

以下示例将 CANCEL_ALL 设置为 “false”。 props

是指定连接属性的 Properties 对象：

props.put("CANCEL_ALL", "false");

注释 若要取消执行某个连接上的所有 Statement 对 象，而不管其是否已开始在服务器上执行，请使用 扩展方法 SybConnection.cancel。

● True–对于 JCONNECT_ VERSION <= “3”

● False–对于 JCONNECT_ VERSION >= “4”

Static

缺省

属性 说明 值

Dynamic

或 Static

CAPABILITY_TIME 仅在 JCONNECT_VERSION >= 6 时使用。此时

jConnect 与支持 TIME 数据类型的服务器相连，并 且所有类型为 java.sql.Time 或 escape literals {t ...} 的 参数都被作为 TIME 进行处理。

jConnect 的以前版本将这些参数作为 DATETIME 进 行处理并在 java.sql . Time 参数前加上 “1970-01- 01”。如果基础数据类型为 datetime 或 smalldatetime，则日期部分也会存储在数据库中。 在 jConnect 6.0 或更高版本中，在处理 TIME 时，服 务器会将时间转换成基础数据类型并在前面加上其 自己的基准年。这可能导致旧数据与新数据之间不 兼容。如果要对 java.sql.Time 使用 datetime 或 smalldatetime 数据类型，为了能够向后兼容，您应 将 CAPABILITY_TIME 保留为 false。将此属性保留为 false 可强制 jConnect 将 java.sql.Time 参数或转义文字

{t ...} 作为 DATETIME 进行处理，而不论服务器处理

TIME 数据类型的能力如何。

将此属性设置为 true 会使 jConnect 在连接到 Adaptive Server 时将 java.sql.Time 参数作为 TIME 数 据类型进行处理。如果您要使用 smalldatetime 或 datetime 列来存储时间值， Sybase 建议您将此属性 保留为 false。

False Static

CAPABILITY_ WIDETABLE

如果您为了提高性能而不使用 JDBC ResultSetMetaData （如列名），则可以将此属性设 置为 “false”。这将减少通过网络交换的数据并提 高性能。除非要使用 EAServer，否则 Sybase 建议 使用缺省设置。请参见 第 45 页的 “使用 Adaptive Server 的宽表支持 ”。

False Static

CHARSET 为传递给数据库的字符串指定字符集。如果 CHARSET 值为 Null， jConnect 将使用服务器的缺 省字符集向服务器发送 string 数据。如果指定 CHARSET，数据库必须能够处理此格式的字符。 如果数据库不能处理此格式的字符，将生成一条消 息，说明不能正确完成字符转换。

注释 如果使用的是 jConnect 6.05 或更高版本，并将 DISABLE_UNICHAR_SENDING 设置为 false，那 么当客户端试图向服务器发送无法用连接所使用的 字符集表示的字符时， jConnect 将能够检测出来。 发生这种情况时， jConnect 会将字符数据作为 unichar 数据发送给服务器，这样可使客户端能够在 unichar / univarchar 列和参数中插入 Unicode 数据。

Null Static

缺省

属性 说明 值

Dynamic

或 Static

CHARSET_ CONVERTER_CLASS

指定希望 jConnect 使用的字符集转换程序类。 jConnect 使用来自 SybDriver.setVersion 的版本设置 或随 JCONNECT_VERSION 属性传入的版本来确 定要使用的缺省字符集转换程序类。有关详细信 息，请参见 第 35 页的 “选择字符集转换程序 ”。

视版本而定。 请参见 第 6 页 的表 2-1。

Static

CLASS_LOADER 该属性设置为您创建的 DynamicClassLoader 对象。

DynamicClassLoader 用于装载在应用程序启动时存储 在数据库中但不在 CLASSPATH 中的 Java 类。有关详 细信息，请参见 第 87 页的 “使用动态类装载 ” 。

Null Static

CONNECTION_ FAILOVER

与 Java 命名和目录接口 (JNDI) 一起使用。请参见

第 31 页的 “ CONNECTION_FAILOVER 连接属性”。

True Static

CRC 当该属性设置为 true 时，返回的更新计数为累计计 数，其中既包括受执行的语句直接影响的更新，也 包括执行语句后调用的所有触发器。

DATABASE 当从 Sybase interfaces 文件获得连接信息时，使用

该属性指定连接的数据库名称。 interfaces 文件的

URL 无法提供数据库名称。

false Static

null Static

DEFAULT_QUERY_ TIMEOUT

DELETE_WARNINGS

_FROM_EXCEPTION_ CHAIN

DISABLE_UNICHAR_ SENDING

DISABLE_ UNPROCESSED_ PARAM_WARNINGS

当设置该连接属性时，它将作为在该连接上创建的 任何语句的缺省查询超时。

指定是要保留 SQLWarning 还是将其从

SQLException 链中删除。

值：

● True–jConnect 会将 SQLWarning 对象从

SQLException 链中删除。

● False–jConnect 会将 SQLWarning 对象保留在

SQLException 链中。

当客户端应用程序向服务器发送 unichar 字符 （以及 非 unichar 字符）时，会对发送到数据库的任何字符 数据产生轻微的性能影响。在 jConnect 6.05 和更高版 本中，此属性在缺省情况下设置为 false。如果使用 jConnect 较早版本的客户端希望向数据库发送 unichar 数据，则必须将此属性设置为 false 。请参见 第 33 页 的 “使用 jConnect 传递 Unicode 数据 ”。

禁用警告。在处理存储过程的结果时， jConnect 经 常读取行数据之外的返回值。如果不处理返回值， jConnect 将引发一个警告。若要禁用这些警告 （这 样有助于提高性能），请将此属性设置为 “true”。

0 （无超时） Dynamic True Static

视版本而定 Static

False Static

DYNAMIC_PREPARE 决定是否在数据库中预编译动态 SQL 预准备语

句。请参见 第 141 页的 “ DYNAMIC_PREPARE 连接属性”。

true Dynamic

缺省

属性 说明 值

Dynamic

或 Static

EARLY_BATCH_ READ_THRESHOLD

ENABLE_BULK_ LOAD

ENABLE_LOB_ LOCATORS

ENABLE_SERVER_ PACKETSIZE

ENCRYPT_ PASSWORD

指定行数阈值，超出该值后，读取器线程应启动， 以清除批处理的服务器响应。

如果无需较早读取，则将该值设置为 -1。 指定是否使用 bulk load 向数据库中插入行。值：

● 空值–禁用批量装载。

● ARRAYINSERT_WITH_MIXED_STATEMENTS – 使用行级别日志记录启用批量装载，并允许应用 程序在批量装载操作过程中执行其它语句。

● ARRAYINSERT–使用行级别日志记录启用 bulk load，但应用程序在执行 bulk load 操作期间无法 执行其它语句。

● BCP –使用页面级别日志记录启用批量装载，但应 用程序在批量装载操作过程中无法执行其它语句。

● LOG_BCP–除对整个事务进行转储以供可能的 完全恢复外，其余和 BCP 相同。

指定 jConnect 应该创建客户端物化 LOB 还是服务 器端 LOB 定位符。有效值：

● False：缺省值 –jConnect 使用客户端物化 LOB。 即， LOB 的所有数据均在客户端进行处理和高 速缓存。

● True：仅在自动提交设置为 False 时有效，否 则，会在内部将值更改为 False。设置为 true 后， 将使用服务器定位符，而不是在客户端存储

LOB 数据。

请参见 第 69 页的 “大对象定位符支持”。 指定是否将连接包大小设置为服务器建议的值。如

果设置为 true，驱动程序将不使用 PACKETSIZE 连 接属性，并且服务器可以使用介于 512 和最大包大 小之间的任何值。如果设置为 false，将使用 PACKETSIZE 连接属性。

允许安全登录。当该属性设置为 true 时，登录和远 程站点口令都会被加密，然后再发送到服务器。不 再以明文形式发送这些口令。

ENCRYPT_PASSWORD 优先于

RETRY_WITH_NO_ENCRYPTION。有关口令加密 的详细信息，请参见 第 80 页的 “使用口令加密 ” 。

-1 Static

Null Dynamic

False Dynamic

True Static

False Static

缺省

属性 说明 值

Dynamic

或 Static

ESCAPE_ PROCESSING_ DEFAULT

EXECUTE_BATCH_ PAST_ERRORS

避免处理 SQL 语句中的 JDBC 函数转义。缺省情况 下， jConnect 会分析提交到数据库的所有 SQL 语 句，以查找有效的 JDBC 函数转义。如果应用程序 不在其 SQL 调用中使用 JDBC 函数转义，可将此连 接属性设置为 “false”以避免此处理过程。这样做 可以使性能获得略微改善。

此外， ESCAPE_PROCESSING_DEFAULT 可帮助

在 SQL 语法中使用大括号的后端服务器 （如

Sybase IQ）

指定 jConnect 允许批处理更新操作忽略在执行各个 语句时遇到的非致命错误并完成批处理更新，还是 中止批处理更新操作。值：

● True –允许批处理更新操作忽略遇到的非致命错 误并完成批处理更新。

● False –在遇到非致命错误时中止批处理更新。

True Static

False Static

EXPIRESTRING 包含许可证有效 date。除 jConnect 的评估副本之

外，其余副本的有效期均设置为 Never。这是一个 只读属性。

F AKE_METADATA 返回假元数据。如果在调用 ResultSetMetaData 方法

getCatalogName 、 getSchemaName 和 getTableName 时此属性设置为 “true”，由于服务器不提供有用 的元数据，调用过程将返回空字符串 ("")。

如果此属性设置为 “false”，那么调用这些方法将 引发 “Not Implemented” SQLException。

注释 如果已启用宽表且正在使用 Adaptive Server 12.5 或更高版本，则将忽略此属性设置，因为服务 器提供了有用的元数据。

Never Static

False Static

GET_BY_NAME_ USES_COLUMN_ LABEL

提供与 jConnect 6.0 之前版本的向后兼容性。

在 Adaptive Server 12.5 和更高版本中， jConnect 跟 以前相比可以访问更多的元数据。在 12.5 版本之 前， column name 和 column alias 代表同一数据类 型。现在在使用 Adaptive Server 12.5 或更高版本且 启用宽表的情况下， jConnect 可以区分这两者。

若要保留向后兼容性，请将此属性设置为 “true”。

如果希望调用 getByte、 getInt、 get* (String columnName) 以查看列的实际名称，请将此属性设 置为 “false”。

True Static

缺省

属性 说明 值

Dynamic

或 Static

GET_COLUMN_ LABEL_FOR_NAME

GSSMANAGER_ CLASS

HOMOGENEOUS_ BATCH

保持与 jConnect 5.5 或更早版本的向后兼容，其中 对 ResultMetaData.getColumnName 的调用将返回列 标签而不是列名称。值：

● True–ResultMetaData.getColumnName 返回列标签

● False–ResultMetaData.getColumnName 返回列名

指定 org.ietf.jgss.GSSManager 类的一种第三方实 现。

可将此属性设置为字符串或 GSSManager 对象。 如果将此属性设置为字符串，其值应是第三方 GSSManager 实现的全限定类名。如果将此属性设

置为对象，则该对象必须扩展

org.ietf.jgss.GSSManager 类。有关详细信息，请参 见 第 3 章 “安全性 ” 。

调用新的 ASE 优化批处理协议以加快 PreparedStatement 对象的批处理操作速度。有 效值：

● True –使用新的优化批处理协议。

● False–即使 jConnect 连接到支持新优化批处理 协议的 ASE，也使用旧的批处理协议。

请参见 第 143 页的 “ jConnect 中的优化批处理”。

False Static

Null Static

True Dynamic

HOSTNAME 标识当前主机名。 无。 最大长度是 30 个字符，

如果超过则被 截断至 30 个 字符。

Static

HOSTPROC 标识主机上的应用程序进程。 无 Static

IGNORE_DONE_IN_ PROC

确定不返回中间更新结果 （像在存储过程中那 样），而只返回最终结果集。

False Static

缺省

属性 说明 值

Dynamic

或 Static

IGNORE_WARNINGS 指定是否检查并生成警告消息。目前，此属性仅检

查有关将时间戳值存储为 Adaptive Server date 和 time 数据类型 （其精度低于 Java 时间戳）时的精 度损失的警告。

有效值：

● True–jConnect 不检查和生成警告消息，因此提 高了性能。

● False–缺省值，指示 jConnect 检查并生成警告 消息。

注释 在将 IGNORE_WARNINGS 设置为 true 前，应 就此类配置对应用程序产生的影响进行全面测试。

False Static

IMPLICIT_CURSOR_ FETCH_SIZE

INTERNAL_QUERY_ TIMEOUT

将该属性与 SELECT_OPENS_CURSOR 属性结合使 用，可强制 jConnect 在发送到数据库的每个 select 查询上打开一个只读游标。该游标具有在此属性中 设置的值提取大小，除非使用 Statement.setFetchSize 方法加以覆盖。

使用该属性可设置将由在内部创建并用 jConnect 执 行的语句所使用的查询超时。如果内部命令没有在 适当的时间内完成，这可以防止应用程序失败。

0 Static

0 （无超时） Dynamic

IS_CLOSED_TEST 允许指定在调用 Connection.isClosed 时向数据库发

送何种查询 （如果有）。有关详细信息，请参见 第 101 页的 “使用 Connection.isClosed 和 IS_CLOSED_TEST”。

Null Static

J2EE_TCK_ COMPLIANT

JAVA_CHARSET_ MAPPING

当该属性设置为 true 时， jConnect 驱动程序会启用 符合 J2EE 1.4 技术兼容包 (TCK) 测试套件的行为， 这会导致性能有所下降。因此， Sybase 建议使用缺 省值 false。

指定用户定义的字符集映射，取代 Adaptive Server 的缺省字符集映射。请参见 第 39 页的 “取代缺省字符集映射 ” 。

false Static

- Static

JCE_PROVIDER_ CLASS

指定 RSA 加密算法中使用的 Java Cryptography Extension (JCE) 提供程序。

绑定的 JCE

提供程序。

Static

JCONNECT_VERSION 设置版本专有的特性。请参见 第 6 页的 “使用

JCONNECT_ VERSION”。

7 Static

LANGUAGE 指定来自 jConnect 和服务器的消息的显示语言。该

设置必须与 syslanguages 中的语言相符，因为服务 器消息将根据您的当地环境中的语言设置进行本地 化。支持的语言包括：中文、美国英语、法语、德 语、日语、韩语、波兰语、葡萄牙语和西班牙语。

视版本而定。 请参见 第 6 页 的 “使用 JCONNECT_ VERSION”。

Static

缺省

属性 说明 值

Dynamic

或 Static

LANGUAGE_ CURSOR

确定 jConnect 使用 “语言游标”而不使用 “协议 游标”。

请参见 第 144 页的 “游标性能”。

False Static

L ITERAL_PARAMS 如果设置为 “true”，那么 setXXX 方法在

PreparedStatement 接口中设置的任何参数都会在

SQL 语句执行时以文字形式插入该语句。

如果设置为 “ false”，参数标记将留在 SQL 语句 中，而参数值被单独发送给服务器。

False Static

NEWPASSWORD 指定口令有效期处理过程中使用的新口令。 Null Static

OPTIMIZE_FOR_ PERFORMANCE

指定是否启用 jConnect 性能增强属性。目前，此属 性仅控制 IGNORE_WARNINGS 属性。

有效值：

● True–jConnect 在增强性能模式下运行。

● False–缺省值，表示 jConnect 在正常模式下运行。

注释 在将 OPTIMIZE_FOR_PERFORMANCE 设置

为 true 前，应就此类配置对应用程序产生的影响进 行全面测试。

False Static

OPTIMIZE_STRING_ CONVERSIONS

指定是否启用字符串转换优化。

客户端在 SQL 预准备语句中使用字符数据类型时， 此优化行为可提高 jConnect 的性能。

值：

● 0 – 缺省值；不启用字符串转换优化。

● 1– 在 jConnect 使用 utf8 或服务器缺省字符集 时，启用字符串转换优化。

● 2 – 在所有情况下均启用字符串转换优化。

0 Static

PACKETSIZE 标识网络包大小。如果使用的是 Adaptive Server

15.0 或更高版本， Sybase 建议您不要设置此属性， 并让 jConnect 和 Adaptive Server 选用适合于您的环 境的网络包大小。

PASSWORD 标识登录口令。

如果使用 getConnection(String, String, String) 方法， 将自动设置；如果使用 getConnection(String, Props)，将显式设置。

512 Static

无 Static

缺省

属性 说明 值

Dynamic

或 Static

PRELOAD_JARS 包含以逗号分隔的与指定 CLASS_LOADER 相关联

的 .jar 文件名的列表。这些 .jar 文件在连接时装 载，可供使用相同 jConnect 驱动程序的任何其它连 接使用。有关详细信息，请参见 第 89 页的 “预装 载 .jar 文件 ”。

Null Static

PROMPT_FOR_ NEWPASSWORD

PROTOCOL_ CAPTURE ‌

指定是执行透明口令更改还是提示输入新口令。 值：

● True –提示手动设置新口令。

● False–jConnect 检查 NEWPASSWORD 的值，如 果不是空值，则使用该值替换到期口令。

指定用于捕获应用程序和 Adaptive Server 间的 TDS

通信的文件。

False Static

Null Dynamic

PROXY 指定网关地址。对于 HTTP 协议， URL 是

http://host:port。

若要使用支持加密的 HTTPS 协议， URL 应为

https://host:port/servlet_alias 。

无 Static

QUERY_TIMEOUT_ CANCELS_ALL

RELEASE_LOCKS_ ON_CURSOR_ CLOSE

强制 jConnect 在读取超时时取消连接上的所有语 句。可以在客户端调用 execute() 但由于死锁 （例 如，试图读取当前正在另一个事务中更新的表）而 超时时使用此行为。

指定在游标关闭时 Adaptive Server 是否在隔离级别

2 和 3 释放共享只读游标锁：

● False –在游标关闭时不释放共享游标锁。

● True –在游标关闭时释放共享游标锁。 请参见 第 54 页的 “在游标关闭时释放锁 ” 。

False Dynamic

False Static

REMOTEPWD 包含用于通过服务器到服务器远程过程调用进行访

问的远程服务器口令。请参见 第 44 页的 “执行服 务器到服务器的远程过程调用”。

REPEAT_READ 确定驱动程序是否保留列和输出参数的副本，以便

可以随机读取或重复读取列。请参见 第 136 页的 “ REPEAT_READ 连接属性”。

无 Static

True Static

缺省

属性 说明 值

Dynamic

或 Static

REQUEST_HA_ SESSION

指示连接客户端是否希望开始高可用性 (HA) 故障 切换会话。请参见 第 40 页的 “实施高可用性故障 切换支持 ”。

建立连接后将不能重置此属性。如果希望请求故障 切换会话时具有更大的灵活性，可以对客户端应用 程序进行编码，使其在运行期设置 REQUEST_HA_SESSION。

注释 此属性设置为 “true”将导致 jConnect 尝试进 行故障切换登录。如果没有正确设置此连接属性， 即使已为故障切换配置了服务器，也不能启动故障 切换会话。

False Static

REQUEST_ KERBEROS_SESSION

RETRY_WITH_NO_ ENCRYPTION

确定 jConnect 是否使用 Kerberos 进行鉴定。如果此 属性设置为 “true”，还必须指定 SERVICE_PRINCIPAL_NAME 属性的值。

可能还要为 GSSMANAGER_CLASS 属性提供值。 有关详细信息，请参见 第 3 章 “安全性 ”。

允许服务器使用明文口令重新尝试登录 当 ENCRYPT_PASSWORD 和

RETRY_WITH_NO_ENCRYPTION 属性都设置为

true 时， jConnect 会首先使用加密口令登录。如果 登录失败， jConnect 将使用明文口令登录。有关口 令加密的详细信息，请参见 第 80 页的 “使用口令 加密 ” 。

False Static

False Static

RMNAME 在使用分布式事务 (XA) 时设置资源管理器名称。

此属性将覆盖可能在 LDAP 服务器条目中设置的资 源管理器名称。有关详细信息，请参见 第 99 页的 “分布式事务管理支持 ”。

Null Static

SECONDARY_ SERVER_HOSTPORT

在客户端使用 HA 故障切换会话时设置辅助服务器 的主机名和端口。此属性的值应采用下列格式： hostName:portNumber。除非 REQUEST_HA_SESSION 也设置为 “true ”，否则 将忽略此属性。有关详细信息，请参见 第 40 页的 “实施高可用性故障切换支持 ”。

Null Static

缺省

属性 说明 值

Dynamic

或 Static

SELECT_OPENS_ CURSOR

SEND_BATCH_ IMMEDIATE

SERIALIZE_ REQUESTS ‌

SERVER_INITIATED_ TRANSACTIONS

确定对 Statement.executeQuery 的调用在查询包含

FOR UPDATE 子句时是否自动生成游标。

如果前面已经在同一语句中调用了 Statement.setFetchSize 或 Statement.setCursorName，那么将 SELECT_OPENS_CURSOR 设置为 “true”将不起 作用。

注释 将 SELECT_OPENS_CURSOR 设置为 “true” 时，系统性能可能会下降。

有关在 jConnect 中使用游标的详细信息，请参见 第 47 页的 “对结果集使用游标 ”。

指定 jConnect 是在调用 PreparedStatement.addBatch() 后立即为当前行发送 参数，还是仅在调用 PreparedStatement.executeBatch() 后再发送。

● True–jConnect 在调用 PreparedStatement.addBatch() 后立即为当前行发 送参数。这会最大限度地减少客户端内存的使用 率，并让服务器有更多时间来处理批处理参数。

● False–jConnect 仅在调用 PreparedStatement.executeBatch() 后才发送批处 理参数。

确定 jConnect 在发送其它请求之前是否等待服务器 的响应。

允许服务器控制事务。缺省情况下，该属性设置为 true，并且 jConnect 通过使用 Transact-SQL 命令 set chained on 来允许服务器启动并控制事务。如果设 置为 false，则 jConnect 通过使用 Transact-SQL 命令 begin tran 启动并控制事务。Sybase 建议允许服务器 控制事务。

False Static

False Dynamic

False Static

True Static

SERVICENAME 指示 DirectConnect 网关服务的后台数据库服务器的

名称。还用于指示在连接到 SQL Anywhere 之后应 使用的数据库。

SERVERTYPE 在连接到 OpenSwitch 时将此属性设置为

“OSW”。这使得 jConnect 可以向 OpenSwitch 发送 某些指令，允许 OpenSwitch 在将连接重定向到另 一个服务器实例时记住初始的连接设置，例如隔离 级别、 textsize、带引号的标识符和 autocommit。

无 Static

无 Static

缺省

属性 说明 值

Dynamic

或 Static

SERVICE_ PRINCIPAL_NAME

在建立到 Adaptive Server 的 Kerberos 连接时使用。 此属性的值应与密钥分发中心 (KDC) 中的服务器条 目和数据库运行时所使用的服务器名称对应。

如果 REQUEST_KERBEROS_SESSION 属性设置为

“ false”，将会忽略 SERVICE_PRINCIPAL_NAME 属 性的值。有关详细信息，请参见 第 3 章 “安全性 ”。

Null Static

SESSION_ID TDS 会话 ID。如果设置此属性，jConnect 将认为应

用程序正试图恢复由 TDS 贯通网关保持打开的现 有 TDS 会话的通信。jConnect 将跳过登录协商并将 所有来自应用程序的请求转发到指定的会话 ID。

SESSION_TIMEOUT 指定 HTTP 贯通会话（使用 jConnect TDS 贯通服务

器小程序创建）在空闲时保持活动的时间量 （以 秒为单位）。在达到指定时间后，连接会自动关 闭。有关 TDS 贯通服务器小程序的详细信息，请 参见 第 151 页的 “使用 TDS 贯通 ”。

Null Static

Null Static

SETMAXROWS_ AFFECTS_SELECT_ ONLY

指定 setMaxRows 是否仅限制 select 语句返回的行， 以与 JDBC 规范一致。值：

● True – Statement.setMaxRows(int max) 仅限制作为

select 语句的结果返回的行数。

● False –Statement.setMaxRows(int max) 对作为 select、 insert、 update 和 delete 语句的结果返回 的行数加以限制。

当连接到 Adaptive Server 15.5 或更低版本时，

SETMAXROWS_AFFECTS_SELECT_ONLY 会被

忽略。

True Static

SQLINITSTRING 定义要在连接打开时传递给数据库服务器的一组命 令。这些命令必须是可以用 Statement.executeUpdate 方法执行的 SQL 命令。

Null Static

STREAM_CACHE_ SIZE

指定用于高速缓存语句响应流的最大大小。 Null （无限制

的高速缓存大 小）

Dynamic

STRIP_BLANKS 强制服务器在将字符串值存储到表中之前，先删除 其前导空白和尾随空白。

值：

● 0 – 缺省值；客户端发送的字符串值 “按原样” 存储。

● 1 – 在将字符串值存储到表中之前，先删除其前 导空白和尾随空白。

0 Static

缺省

属性 说明 值

Dynamic

或 Static

SUPPRESS_ CONTROL_TOKEN

SUPPRESS_PARAM_ FORMAT

SUPPRESS_ROW_ FORMAT

SUPPRESS_ROW_ FORMAT2

取消发送控制令牌。 值：

● 0 – 缺省值；发送控制令牌。

● 1 – 取消发送控制令牌。

在执行动态 SQL 预准备语句时，jConnect 客户端可 使用 SUPPRESS_PARAM_FORMAT 连接字符串属 性来抑制参数格式元数据。在可能的情况下，客户 端会减少发送的参数元数据以提高性能。

值：

● 0– 在 select、 insert 和 update 操作中不抑制参数 格式元数据。

● 1 – 缺省值；在可能的情况下抑制参数格式元数 据。

在 jConnect 中，客户端可使用 SUPPRESS_ROW_FORMAT 连接字符串属性来强 制 Adaptive Server 仅在动态 SQL 预准备语句的行格 式更改时发送 TDS_ROWFMT 或 TDS_ROWFMT2 数据。这样， Adaptive Server 可以尽量向客户端发 送较少的数据，从而提高性能。

值：

● 0–即便行格式未发生更改，也发送 TDS_ROWFMT 或 TDS_ROWFMT2 数据。

● 1–缺省值；强制服务器仅在行格式更改时才发 送 TDS_ROWFMT 或 TDS_ROWFMT2 数据。

指定 Adaptive Server 尽可能使用 TDS_ROWFMT 字 节序列而不是 TDS_ROWFMT2 字节序列发送数 据。

值：

● 0–缺省值；不抑制 TDS_ROWFMT2。

● 1–强制服务器尽可能以 TDS_ROWFMT 格式发 送数据。

注释 在连接到 Adaptive Server 15.7 ESD #1 及更高版本 时，应改用 SUPPRESS_ROW_FORMAT 连接属性。

0 Static

1 Static

1 Static

0 Static

缺省

属性 说明 值

Dynamic

或 Static

SYBSOCKET_ FACTORY

使 jConnect 能够使用自定义套接字实现。

将 SYBSOCKET_FACTORY 设置为下列两项之一：

● 实现 com.sybase.jdbcx.SybSocketFactory 的类的名 称；或

● “DEFAULT”，设置为此值将实例化新的

java.net.Socket( )

使用此属性可建立到数据库的 SSL 连接。

Null Static

TEXTSIZE 允许设置文本大小。缺省情况下， Adaptive Server

和 SQL Anywhere 允许从图像或文本列中读取 32,627 字节。如果已经安装了 jConnect mda 表， jConnect 会将该值更改为 2GB。但是，如果在连接 到 OpenSwitch 时设置该值，则允许连接在 OpenSwitch 将连接重定向到另一个服务器实例时记 住此设置。

USE_METADATA 在建立连接时创建并初始化 DatabaseMetaData 对

象。连接到指定的数据库必须要使用

DatabaseMetaData 对象。

jConnect 将 DatabaseMetaData 用于某些功能，如分 布式事务管理支持 (JTA/JTS) 和动态类装载 (DCL)。

如果收到错误 010SJ （表明应用程序需要元数 据），请安装 jConnect 附带的用于返回元数据的存 储过程。请参见 《jConnect for JDBC 安装指南》第 3 章中的 “安装存储过程”。

USER 指定登录 ID。

如果使用 getConnection(String, String, String) 方法，将 自动设置；如果使用 getConnection(String, Props)，将 显式设置。

2GB Static

True Static

无 Static

VERSIONSTRING 提供 JDBC 驱动程序的只读版本信息。 jConnect 驱动

程序版本

Static

< 上一个 | 内容 | 下一步 >