参数详解

DBParm 参数

VDN 驱动中常用到下面几个参数,用来弥补一些与直连专用接口默认效果不同的情况

PBTrimCharColumns

可选
默认:No
示例: PBTrimCharColumns='Yes'

如果使用了 Char 类型的列，使用此参数可以在检索 Char 类型列时自动去除后面的空格。

RecheckRows

可选
默认:0
示例: RecheckRows=1

如果使用了 INSERT\DELETE\UPDATE 触发器（Trigger）务必加上这个参数，否则更新会有异常。

DateTimeFormat、TimeFormat

可选
默认:Yes
示例: DateTimeFormat='\''yyyy-MM-dd hh:mm:ss.fff\''',TimeFormat='\''hh:mm:ss\'''

SQLSERVER使用time类型提示错误:数据类型 time 和 datetime 在 equal to 运算符中不兼容

设置为示例中的格式后,生成的SQL语句为 time_col='11:11:11' ,而不是 time_col= {t '11:11:11'}，来避免这个错误

CommitOnDisconnect

可选
默认:Yes
示例: CommitOnDisconnect='No'

断开数据库连接时提交或回滚数据，默认为提交。(超时断开或者调用 Disconnect 操作都会执行)

Yes: 提交 No: 回滚

与 Outage 的区别详见附录 1

PROVIDERSTRING 参数

VDN 驱动独有的连接参数均放在 PROVIDERSTRING 中,绝大多数为可选参数，实现特定的功能。

以下参数释义按照重要性及使用频率排序。

图例: 🏷️ 必须参数 ⭐ 重要参数

Database 🏷️⭐

必须
示例: database=帐套名称

指定帐套，对应服务器的帐套设置中的名称

自定义数据库(适用于 SQLSERVER)

当帐套设置的数据库名称为:[Custom]，支持客户端自定义连接的数据库名称,帐套名称和数据库名之间半角冒号(:)分割 :

         database=帐套名称:数据库名

服务端设置参见:帐套设置

V2017.8.1.3 版本之后支持

DesKey 🏷️⭐

必须
示例: deskey=Topany

与服务器交互式关键字加密的（参见安全设置一节），建议修改为自定义的值以增强安全性。

Debug ⭐

可选
默认:0
示例: Debug=1

Debug=1 PB 开发模式
Debug=0 正式运行

指定系统为运行模式还是开发模式，在 PB 调试运行时设定 Debug=1,否则连接不上数据库。

ProvType

可选
默认:空
示例: ProvType=NCLI

指定服务器端连接 SQLSERVER 时使用 Microsoft SQL Server Native Client 驱动。

提示

SQLSERVER2008 版本增加了 DATE 数据类型，为了支持此类型，连接 SQLSERVER2008 时可以指定服务器使用 SQLNCLI 驱动，服务器端需要单独安装该驱动(sqlncli.msi) 。

一些情况下使用 SQLNCLI 驱动可以获取更快的速度

V2015.8.1.1 版本之后支持

AppName

可选
默认:无
示例: AppName=VDN

指定程序名称,使用后将在 SQLSERVER 的连接进程里显示。

Host

可选
默认:无
示例: Host=PCName

指定客户端名称。使用后将在 SQLSERVER 的连接进程里显示。

SysUserID

可选
默认:无
示例: SysUserID=123

指定数据库连接在[在线管理]里的用户 ID,如果不指定则显示为数据库登录的用户名(例如:sa),这个 ID 一般为用户登录系统使用的用户 ID,配合 SysUser 使用。

当数据库连接时还不确定这个 ID 时，可以后期使用 SQL 指令修改这个值。

V2023.2.1.1 版本之后支持

SysUser

可选
默认:无
示例: SysUser=张三

指定数据库连接在[在线管理]里的用户名,如果不指定则显示为数据库登录的用户名(例如:sa),这个用户名一般为用户登录系统使用的用户名,配合 SysUserID 使用。

当数据库连接时还不确定这个用户名时，可以后期使用SQL 指令修改这个值。

V2023.2.1.1 版本之后支持

ReConSQL

可选
默认:无
示例: ReConSQL=Update Tab set spid=@@spid where id=123

在数据库重连后系统自动执行的 SQL 语句，用来进行一些相关的操作，例如同步 SPID。
可以是单独的 SQL 语句,也可以是一个存储过程。

SQLSERVER 存储过程格式:
execute 存储过程名 @参数 1 ='值' , @参数 2 ='值'

execute P_USER @ID ='123' , @NAME ='张三';

ORACLE 存储过程格式:
call 存储过程名（'参数值 1','参数值 2')

call P_USER('123' , '张三');

如果 SQL 语句中包含引号、逗号这些特殊字符，可以给整个语句使用 base64 编码后传递，格式为 ReconSQL=base64:编码后的 SQL:

ls_sql_base64 = uo_vdn.base64Encode("call P_USER('9999' , '张三')")
SQLCA.DBParm+="ReconSQL=base64:"+ ls_sql_base64  +";"

当数据库连接时还不确定这个 SQL 语句，可以后期使用SQL 指令修改这个值。

V2023.2.1.1 版本之后支持

DoubleQuote

可选
默认:0
示例: DoubleQuote=1

当值为 1 时就会执行： SET QUOTED_IDENTIFIER OFF; 操作，可以在语句里使用双引号，作用同 DelimitIdentifierToDB='Yes'。

ConcatNull

可选
默认:1
示例: ConcatNull=1

值为 1 时：执行 SET CONCAT_NULL_YIELDS_NULL OFF; 操作,同 NULL 字符串连接时返回非空字符串

值为 0 时：同 NULL 字符串相连时返回 NULL

例如：select A + B from tab;, A 列值为"123", B 列值为 NULL

当 ConcatNull=1 是返回 "123"
当 ConcatNull=0 是返回 NULL

提示

PB9 的专用接口 MSS Microsoft SQL Server 连接默认 ConcatNull=1,

如果使用 OLE DB 接口直连该参数默认为 0,但使用 VDN 时被默认位置为 1

Truncate

可选
默认:0
示例: Truncate=1

当值为 1 时，字段值超出字段长度将被自动截断，不会出现：将截断字符串或二进制数据的错误提示，直连 SQLSERVER 数据库时默认为 1

V2018.2.1.1 版本之后支持

ConvertWChar

可选
默认:0
示例: ConvertWChar=1

如果使用 PB9 且 SQLSERVER 里使用了 nvarchar,ORACLE 里使用了 varchar2(char)\nvarchar 等双字节数据类型就需要设置这个值，否则：PB9 读取双字节字段会产生乱码。主要出现在动态 DataWindow 和嵌入式 SQL 语句里。

提示

这个参数是针对 PB9 的一个 BUG 来设置的，PB10 及以上版本不用设置这个参数。

IgnorePBTable

可选
默认:0
示例: IgnorePBTable=1

当值为 1 时 VDN 将忽略对 PB 系统表(pbcattbl)的检索。为动态 DataWindow 提速使用,速度提升很明显。

PLSQLRSet

可选
默认:0
示例: PLSQLRSet=1

连接 Oracle 时如果使用存储过程作为 DATAWINDOW 的数据源，返回数据集（SYS_REFCURSOR）必须加上这个参数

Traditional

可选
默认:0
示例: Traditional=1

Traditional=1:使用繁体序操作系统时设置该值为 1 Traditional=2:当时用繁体服务器端连接简体数据库，显示简体中文字符为乱码时使用 Traditional=3:当用到泰文等文字编码时使用 Traditional=4:当用到繁体序列号时用到韩文等文件编码时使用

注: 值 2、3 在V2017.6.1.3 版本之后支持，在智能提速开启时使用

Encrypt

可选
默认:0
示例: Encrypt=1

对发往服务器的 SQL 语句进行加密处理，进一步增强安全性。
加密处理对系统速度会有一定的影响，根据需要酌情处理。

SSLEncrypt

可选
默认:No
示例: SSLEncrypt=No

当 SQLSERVER 开启了 SSL 连接，要在 PROVIDERSTRING 里设置该参数为 Yes

V2023.1.1.1 版本之后支持

CompressType

可选
默认:Default
示例: CompressType=Default

客户端可以根据不同的网络情况决定服务器采用何种压缩方式返回数据。

fastest：压缩速度最快，压缩率较低，适用于局域网 fast：压缩速度较快，压缩率中等，适用于 15M-30M 的带宽 normal：压缩速度中等，压缩率较高，适用于 3M-15M 的带宽 maximum：压缩速度较慢，压缩率最高，适用于 3M 以下的带宽 default：使用服务器设置的默认参数

V2016.10.1.1 版本之后支持