3. DBI 类

DBI定义了一系列的方法、变量和常量，本章节介绍了这些方法。

• DBI 类方法_

• 句柄的通用方法

3.1. DBI 类方法

1. connect

   语法格式：

   $dbh = DBI->connect($data_source, $username, $password, \%attr);
   

   功能：

   该方法可建立与所查询的数据库 $data_source 相连的数据库连接或者会话。如果连接成功，返回一个数据库句柄对象。可以使用 $dbh->disconnect 来终止这个连接。如果连接失败，将返回 undef 并且设置 $DBI::err 和 $DBI::errstr。

   参数说明：

   $data_source 包含了连接到数据库的参数，应当以 dbi::KB 开头。如果没有定义或是定义为空，将用环境变量 DBI_DSN 代替这个值。 连接参数如下表所示：

   表 3.1.24 连接参数

   parameter	hard coded default
   host	local domain socket
   hostaddr	local domain socket
   port	54321
   dbname*	current userid
   username	current userid
   password	(none)
   options	(none)
   service	(none)
   sslmode	(none)

   \%attr 参数用来改变 PrintError，RaiseError， AutoCommit 及其他属性的缺省设置。

2. connect_cached

   语法格式：

   $dbh = DBI->connect_cached("dbi:KB:dbname=$dbname",
   $username, $password, \\%options);
   

   功能：

   作用与 connect 相似，返回相应缓存的数据库句柄。

3. data_sources

   语法格式：

   @data_sources = DBI->data_sources('KB');
   
   @data_sources = $dbh->data_sources();
   

   功能：

   使用给定的驱动程序名，返回所有可用的数据源的列表。

3.2. 句柄的通用方法

这些方法对所有的 DBI 句柄都是通用的。

1. err

   语法格式：

   $rv = $h->err;

   功能：

   返回最后一次调用的错误代码。

2. errstr

   语法格式：

   $str = $h->errstr;

   功能：

   返回错误信息。

3. state

   语法格式：

   $str = $h->state;

   功能：

   返回一个五个字符表示的 "SQLSTATE" 代码。

4. trace

   语法格式：

   $h->trace($trace_settings);

   $h->trace($trace_settings, $trace_filename);

   $trace_settings = $h->trace;

   功能：

   修改数据库句柄或者语句句柄上的 trace 设置。

5. trace_msg

   语法格式：

   $h->trace_msg($message_text);

   $h->trace_msg($message_text, $min_level);

   功能：

   把输出信息写到文件中。$min_level 表示日志级别。

6. private_attribute_info

   语法格式：

   $hashref = $dbh->private_attribute_info();

   $hashref = $sth->private_attribute_info();

   功能：

   返回所有的 DBD::KB 的私有属性的哈希引用。