iAnywhere Solutions ODBC Driver for Oracle
如果应用程序要求使用连接字符串连接到数据源,则必须指定数据源名称,告诉驱动程序使用系统信息中的哪一部分作为缺省连接信息。或者,也可以在连接字符串中指定 attribute=value 对,替换在系统信息中存储的缺省值。不会将这些值写入系统信息中。
可以在连接字符串中指定长名称或短名称。连接字符串的格式为:
DSN=data_source_name[;attribute=value[;attribute=value]...]
Oracle 的连接字符串的示例如下:
DSN=Accounting;SRVR=QESRVR;UID=JOHN;PWD=XYZZY
如果服务器名包含分号,请用引号将它括起来:
DSN=Accounting;SRVR="QE;SRVR";UID=JOHN;PWD=XYZZY
要在 UNIX 环境中配置数据源,您必须编辑系统信息文件。此文件只接受属性的长名称。
有关详细信息,请参见 UNIX 快速入门。
如果在连接字符串或系统信息内的数据源定义中未指定任何值,则使用表中列出的初始缺省值。如果在配置数据源时指定了该属性的值,则将该值作为缺省值。
大多数设置可保留其缺省值。有关使用 MobiLink 时的关键驱动程序设置列表,请参见 MobiLink 和 Oracle 的关键设置。
| 属性 | 说明 |
|---|---|
| AppCodePage (ACP) | AppCodePage 已由 IANAAppCodePage (IACP) 替代。请参见以下内容。 |
| ApplicationUsingThreads (AUT) |
ApplicationUsingThreads={0 | 1}。确保该驱动程序可在多线程应用程序中正常工作。
在设置为 1(初始缺省值)时,该驱动程序是线程安全的。 在单线程应用程序中使用该驱动程序时,可将此选项设置为 0,以避免 ODBC 线程安全标准所需要的额外处理。 设置为 1 可使 DSN 用于 MobiLink 服务器。 |
| ArraySize (AS) |
驱动程序用于读取多行的字节数。值可以是从 1 到 4 GB 的任何整数。值越大,吞吐量越大,因为驱动程序通过网络读取数据的次数会减少。值越小,响应时间越长,因为等待服务器传送数据会有一些延迟。
初始缺省值为 60,000。 |
| CachedCursorLimit (CCL) | 驱动程序存储在高速缓存中的 Oracle 游标标识符的数目。每个打开的结果集都需要一个游标标识符。当某个结果集关闭时,驱动程序会将标识符存储在它的高速缓存中(直到数目达到指定的限制),而不是通知 Oracle 数据库服务器关闭该游标标识符。需要新的游标标识符时,驱动程序会从它的高速缓存中提取(如果有的话)。连接关闭时,高速缓存中相应的游标标识符也会关闭。初始缺省值为 32。 |
| CachedDescriptionLimit (CDL) |
驱动程序为 SELECT 语句保留的说明的长度,其范围从 0 到 65535。这些说明包括列数以及各列的数据类型、长度和小数位数。匹配是由通过 FROM 子句进行的精确文本匹配来完成的。因为分析 SQL 语句会造成开销,故缺省值为 0。使用 FROM 子句时,对于那些发出的 SELECT 语句会重复地返回一些行的应用程序而言,如使用此选项可获得极好的性能。
注意:如果语句中包含 UNION 或嵌套的 SELECT,则不会将说明放入高速缓存中。 |
| CatalogIncludesSynonyms (CIS) |
CatalogIncludesSynonyms={0 | 1}。决定是否在对 SQLProcedures、SQLStatistics 和 SQLProcedureColumns 的调用中包括同义词。设置为 1 时,在这些调用中包括同义词。设置为 0 时,将不包括同义词(非标准行为)并且性能会得到改善。
ODBC 规范要求,如果这些分类调用为非限定的,则应在这些调用的结果集中包括同义词。大多数用户不会限定查询,因此,缺省情况下将包括同义词(这会降低性能)。该选项允许您不包括同义词并以此提高性能。初始缺省值为 1。 |
| CatalogOptions (CO) | CatalogOptions={0 | 1}。决定分类函数 SQLTables 和 SQLColumns 的结果列 REMARKS 以及分类函数 SQLColumns 的结果列 COLUMN_DEF 对 Oracle 是否有意义。如果要获得实际的缺省值,请设置 CO=1。初始缺省值为 0。 |
| DataSourceName (DSN) | 在系统信息中标识 Oracle 数据源配置的字符串。示例包括"Accounting"或"Oracle-Serv1"。 |
| DefaultLongDataBuffLen (DLDBL) | 一个大小为 1024 字节的倍数的整数值,用于指定从 Long/LOB 列读取的数据的最大长度。如果任何长数据的总大小超过 1 MB,则需要增大此值。缺省值为 1024。 |
| DescribeAtPrepare (DAP) |
DescribeAtPrepare={0 | 1}。决定驱动程序是否在准备时描述 SQL 语句。
设置为 0(初始缺省值)时,驱动程序在准备时不描述 SQL 语句。 |
| EnableDescribeParam (EDP) |
EnableDescribeParam={0 | 1}。决定是否启用 ODBC API 函数 SQLDescribeParam;启用时,所有参数都将用 SQL_VARCHAR 数据类型描述。
使用 Microsoft Remote Data Objects (RDO) 访问数据时,应将此属性设置为 1。初始缺省值为 0。 |
| EnableScrollableCursors (ESC) | EnableScrollableCursors={0 | 1}。为数据源启用可滚动游标。键集游标和静态游标都会被启用。初始缺省值为 1。 |
| EnableStatic CursorsForLongData (ESCLD) |
EnableStaticCursorsForLongData={0 | 1}。决定驱动程序在使用静态游标时是否支持长列。如果使用该属性,则会影响读取长数据时的执行性能。
初始缺省值为 0。 |
| EnableTimestampWithTimezone (ETWT) | EnableTimestampWithTimezone={0 | 1}。决定驱动程序是否向应用程序提供带有时区的时间戳。设置为 1 时,驱动程序会在连接时发出"ALTER SESSION"以修改 NLS_TIMESTAMP_TZ_FORMAT。NLS_TIMESTAMP_TZ_FORMAT 将更改为 ODBC 定义(时间戳文字附加上时区文字):YYYY-MM-DD HH24:MI:SSXFF TZR。初始缺省值为 0。 |
| HostName (HOST) | HostName={servername | IP_address}。标识要连接到的 Oracle 服务器。如果网络支持命名的服务器,可以指定主机名(例如 Oracleserver)。否则,可以指定 IP 地址(例如 199.226.224.34)。 |
| IANAAppCodePage (IACP) |
IANAAppCodePage 连接字符串属性的值中列出了此属性的有效值。指定的代码页必须与应用程序使用的代码页相同。UNIX 上的驱动程序通过按照以下顺序检查 IANAAppCodePage 的值来确定应用程序代码页的值:
注意:IANAAppCodePage 连接字符串属性替代了 Connect for ODBC 早期版本中的 AppCodePage 连接字符串属性。这些驱动程序向后兼容 AppCodePage |
| LocalTimeZoneOffset (LTZO) | 该属性的缺省值为 ""(空字符串)。这表示驱动程序从操作系统确定本地时区信息。如果不能从操作系统中获取,则驱动程序缺省使用 Oracle 服务器上的设置。其它可能的值按下列格式以相对于 GMT 的偏移量的形式指定:(-)HH:MM。例如,"-08:00"表示 GMT 减去 8 小时。驱动程序使用该属性的值在连接时发出"ALTER SESSION"以获取本地时区。 |
| LockTimeOut (LTO) |
LockTimeOut={0 | -1}。决定 Oracle 在处理 Select...For Update 语句时,是否应该在引发错误前等待锁被释放。
设置为 0 时,Oracle 不等待。 设置为 -1(初始缺省值)时,Oracle 会永远等待。 |
| LogonID (UID) | 应用程序用于连接到 Oracle 数据库的缺省登录 ID(用户名)。只有在数据库上启用了安全机制的情况下,才需要登录 ID。如果是这样,请与您的系统管理员联系以获取您的登录 ID。 |
| Password (PWD) | 应用程序用于连接到 Oracle 数据库的口令。 |
| PortNumber (PORT) | 标识 Oracle 监听器的端口号。初始缺省值为 1521。要获得正确的端口号,请询问您的数据库管理员。 |
| ProcedureRetResults (PRR) |
ProcedureRetResults={0 | 1}。决定驱动程序是否从存储过程函数返回结果集。
设置为 0(初始缺省值)时,驱动程序不从存储过程返回结果集。 设置为 1 时,驱动程序从存储过程返回结果集。如果设置为 1 并执行不返回结果集的存储过程,将会对性能造成轻微影响。有关详细信息,请参见存储过程结果。 |
| Sid (SID) | 引用服务器上运行的 Oracle 实例的 Oracle 系统标识符。当连接到支持多个 Oracle 数据库实例的服务器时,这一项是必需的。 |
| UseCurrentSchema (UCS) |
UseCurrentSchema={0 | 1}。决定驱动程序在执行 SQLProcedures 时是否仅指定当前用户。
设置为 0 时,驱动程序不会仅指定当前用户。 设置为 1(初始缺省值)时,对 SQLProcedures 的调用将得到优化,但仅返回当前用户拥有的过程。 |
SQL Anywhere Studio 9.0.2
版权所有 © 1989–2005 Sybase, Inc. 部分版权所有 © 2001–2005 iAnywhere Solutions, Inc. 保留所有权利。