DmConnection 对象表示一个 DM 数据库打开的连接。
公共属性
ConnectionString:获取或设置用于连接 DM 数据库的字符串;
ConnectionTimeout:获取在尝试建立连接时终止尝试并生成错误之前所等待的时间;
Database:DM8 不再有 database 的概念,该属性将不再起任何作用;
DataSource:获取要连接的 DM 实例的名称;
ServerVersion:DM 不支持该属性;
State:获取连接的当前状态;
MppType : MPP 连 接 属 性 , 有 效 值 为 DmMppType.LOGIN_MPP_LOCAL 、
DmMppType.LOGIN_MPP_GLOBAL;
RwSeparate:是否读写分离,有效值为 true 或 false;
RwPercent:表示分发到主库的事务占主备库总事务的百分比,有效值范围:0~100,默
认值为 25;
StmtPooling:是否启用句柄重用,有效值为 true 或 fasle;
PoolSize:句柄重用缓冲区的大小。
公共方法
DmConnection():构造函数,初始化 DmConnection 的新实例;
DmConnection(string connectionString):构造函数,以指定的连接串进行连接对象新实
例的初始化;
BeginTransaction():开始数据库事务;
BeginTransaction(IsolationLevel il):以指定的隔离级别启动数据库事务;
ChangeDatabase():DM8 不支持该操作,调用该函数将不产生任何影响;
Close():关闭与数据库的连接;
CreateCommand():创建并返回一个与 DM 关联的 DmCommand 对象;
GetSchema():返回 DM 的数据源的全部元信息;
GetSchema(String) :使用指定字符串的元信息名称返回 DM 元信息结果集;
GetSchema(String, String[]) :使用指定字符串的元信息名以及表示限制值的指定字符串
数组返回 DM 元信息结果集;
Open():使用 ConnectionString 所指定的属性设置打开数据库连接。
连接串
公共属性 ConnectionString 是用于连接 DM 数据库的字符串,其格式为:
<属性名>=<属性值>{;<属性名>=<属性值>}
其中支持的属性名及其意义如下表所示:
属性名 |
意义 |
SERVER |
服务名 |
LOGIN_PRIMARY |
在主备情况下是否仅登录到主库或备库。0:主库不存在的情况下可连接备库;1: 只连接主库;2:只连接备库;3:优先连接备库。默认为 0 |
PORT |
登录端口号 |
USER |
用户名 |
PASSWORD |
用户口令 |
TIMEOUT |
连接超时时间,默认 15s |
COMMANDTIMEOUT |
命令超时时间,默认 30s |
APPNAME |
应用名 |
TRACE |
NONE:不记录 TRACE DEBUG:将 TRACE 内容打印到控制台 TRACE:将 TRACE 内容记录到运行路径下的 ProviderTrace.txt 文件中 |
PRIMARY_KEY |
需要加双引号的关键字 |
SWITCH_TIME |
主备切换的次数,默认为 3 |
SWITCH_INTERVAL |
主备切换的时间间隔,默认为 200ms |
TIME_ZONE |
时区,默认为当前时区 |
RWSEPARATE |
是否读写分离,默认为 FALSE |
RWPERCENT |
读写分离百分比,默认为 25 |
CONNPOOLING |
是否使用连接缓存池,默认为 TRUE |
STMTPOOLING |
是否启用句柄重用,默认为 TRUE |
POOLSIZE |
句柄重用缓冲区的大小,默认为 100 |
ENCODING |
客户端本地编码,支持 UTF-8、GB18030,默认为 GB18030 |
评论