Perl DBI 入门

录 
基本功能  
建立连线  
选项  
下达 SQL  
进阶功能  
SELECT 述  
高等技巧  
交易机制  
注意事项  
其他资讯  


本文是以 Perl DBI Examples 为蓝本，配合 DBMaker 好学易用的特性，以及几个浅显易懂的例子，希望能够一步步地带领使用者学习 Perl DBI modules 存取 DBMaker 资料库的方法。而原作者撰写主要原动力是希望藉由这篇文章的问世，以降低 DBI mailing list 中一再重出现的 FAQ。 

读完本文之後，我们就能学到利用 DBI 建立一个完备的资料库程式。 以下就先由 DBI 的基本功能开始，然後再逐步研究改善效能与可靠度技巧。 

基本功能 
DBI - Database independent interface for Perl. Perl DBI 是 Perl 程式语言存取资料库时的标准应用程式介面 (API)。 DBI 中定义了一组函数、变数和一致性的资料库介面， 可满足与特定资料库无关的特性。 

值得一提的，DBI 只是一个程式介面，利用一组十分轻巧的层面， 将你的应用程式与一个以上的资料库驱动程式紧密地结合在一起， DBI 的架构主要只是提供标准的介面，目的是为了方便使用者下达一些简单的指令， 就可以轻易地让那些驱动程式发挥作用 

首先该做的事就是建构以及安装 DBI， 详细的步骤可参考 DBI INSTALL 文件中有说明. 然後再来就是建构出所需的资料库驱动程式，或是参考 DBD. 在每个 DBD 套件中都应该会有建构程序。 与其他 Perl 模组相较之下， 安装 DBI/DBD 步骤算是相当容易 

 localhost:~/DBI-1.08$ perl Makefile.PL && make  
        && make test && make install  
在 DBI 与 DBD 安装完成之後， 您可以执行下列指令阅读更多的资讯:  

 localhost:~$ perldoc DBI  
建立连线 
每一种资料库都有不同的连线方式， 若是想知道特殊用法， 请务必阅读 DBD 所提供的说明文件。 下面的例子是连线到 DBMaker 的基本方法. 

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                      ); 
     
上述的 connect 函数用到了三个参数: 资料来源名称 (data source name, DSN), 使用者名称和密码。 其中 DSN 的格式为 dbi:DriverName:instance. 不过我们要如何知道连线成不成功呢? 首先可以查看 connect 的传回值，true 代表成功，false 就是代表失败。 其次，当有错误发生时， DBI 会把错误讯息存放在 package variable $DBI::errstr 之中。  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 
$dbh->disconnect(); 
     
结束资料库连线请使用 disconnect() 函数， 正确地使用可避免错误讯息 "Database handle destroyed without explicit disconnect" 的发生.  

选项 
在连线资料库时 connect() 这个方法可以接受 hash 型态的选项，常用的选项包括了: AutoCommit，设为 true 表示资料库交易自动确认； RaiseError，告诉 DBI 在错误发生时触发例外 croak $DBI::errstr 而不只是仅传回错误代码；PrintError，让 DBI 以警告方式 warn $DBI::errstr 传回错误讯息.  

在下一段程式中，是希望进行采交易处理的用法，设定成 AutoCommit off，RaiseError on，而让 PrintError 使用内定值 on.  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 
$dbh->disconnect(); 
     
有一点要特别注意，如果资料库本身不支援交易处理的功能时，设定 AutoCommit off 会接收到错误发生的传回值.  

下达 SQL 
现在开始可以对我们的资料库做一些有意义的事了. 下达至资料库的 SQL 述分成两类. 一是查询指令，预期会有数笔资料传回，例如 SELECT，这一类的指令我们会使用 prepare 方法. 另一类的指令，如 CREATE 和 DELETE，我们会使用 do 方法. 我们先看看後者如何使用.  

这一段程式示在资料库中建立一个员工资料表格的方法.  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 

my $sql = qq{ CREATE TABLE employees ( id INTEGER NOT NULL,  
                                       name VARCHAR(128),  
                                       title VARCHAR(128),  
                                       phone CHAR(10)  
                                     ) }; 
$dbh->do( $sql ); 
$dbh->commit(); 
$dbh->disconnect(); 
     
进阶功能 
我们已经学会了连线资料库，错误侦测，以及下达简单的 SQL 述的方法. 是该学一些更有用的程式语法的时候了.  

SELECT 述 
在 SQL 的述中，最常使用的指令莫过於 SELECT 述. 为了使用 SELECT，我们应该先 prepare 这一段述，然後进行 execute 动作. 在下面的程式片段中，我们都会使用 statement handle $sth 有存取 SELECT 的结果.  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jeerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 

my $sql = qq{ SELECT * FROM employees }; 
my $sth = $dbh->prepare( $sql ); 
$sth->execute(); 

$dbh->disconnect(); 
     
上述程式要求 DBMaker 资料库为查询指令先准备好执行计画，之後再执行该查询指令. 到目前为止还没有任何一笔记录传回. 稍後我们会使用 bind_columns 的技术以取得资料库输出的记录. bind_columns 分别将每个输出栏位结到一个 scalar reference. 一旦呼叫到 fetch 时，这些 scalars 就会填入这资料库传回的值.  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 

my $sql = qq{ SELECT id, name, title, phone FROM employees }; 
my $sth = $dbh->prepare( $sql ); 
$sth->execute(); 

my( $id, $name, $title, $phone ); 
$sth->bind_columns( undef, \$id, \$name, \$title, \$phone ); 

while( $sth->fetch() ) { 
  print "$name, $title, $phone\n"; 
} 

$sth->finish(); 
$dbh->disconnect(); 
     
这倒是一个列印出全公司电话连络簿的好方法，尤其是 WHERE 区块的使用让我们轻易地取出所有的资料输出! 下面会利用到 bind_param 先将 SQL 述做一次 prepare，就能够高速地执行许多次.  

use strict; 
use DBI; 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 

my @names = ( "Larry%", "Tim%", "Randal%", "Doug%" ); 

my $sql = qq{ SELECT id, name, title, phone FROM employees WHERE name LIKE ? }; 
my $sth = $dbh->prepare( $sql ); 

for( @names ) { 
  $sth->bind_param( 1, $_); 
  $sth->execute(); 

  my( $id, $name, $title, $phone ); 
  $sth->bind_columns( undef, \$id, \$name, \$title, \$phone ); 

  while( $sth->fetch() ) { 
    print "$name, $title, $phone\n"; 
  } 
} 

$sth->finish(); 
$dbh->disconnect(); 
     
高等技巧 
交易机制 
到目前为止，我们的动作都还不需要使用到交易机制的功能，不过当下达 UPDATE 或是 DELETE 述时，我们就会希望使用到它了. 根据 DBI 文件指出，如果想作一套稳固的交易机制，就应该配合 eval{...} 区块来拦截错误的发生，最後再使用 commit 或 rollback 来完成整个交易程序. 这就是我们以下所要谈的内容.  

本程式示保四笔记录写入资料库的方法.  

use strict; 
use DBI qw(:sql_types); 

my $dbh = DBI->connect( 'dbi:DBMaker:dbsample', 
                        'jerry', 
                        'jerrypassword', 
                        { 
                          RaiseError => 1, 
                          AutoCommit => 0 
                        } 
                      ) 
          || die "Database connection not made: $DBI::errstr"; 

my @records = ( 
                [ 0, "Larry Wall",      "Perl Author",  "555-0101" ], 
                [ 1, "Tim Bunce",       "DBI Author",   "555-0202" ], 
                [ 2, "Randal Schwartz", "Guy at Large", "555-0303" ], 
                [ 3, "Doug MacEachern", "Apache Man",   "555-0404" ]  
              ); 

my $sql = qq{ INSERT INTO employees VALUES ( ?, ?, ?, ? ) }; 
my $sth = $dbh->prepare( $sql ); 


for( @records ) { 
  eval { 
    $sth->bind_param( 1, @$_->[0]); 
    $sth->bind_param( 2, @$_->[1]); 
    $sth->bind_param( 3, @$_->[2]); 
    $sth->bind_param( 4, @$_->[3]); 
    $sth->execute(); 
    $dbh->commit(); 
  }; 

  if( $@ ) { 
    warn "Database error: $DBI::errstr\n"; 
    $dbh->rollback(); #just die if rollback is failing 
  } 
} 

$sth->finish(); 
$dbh->disconnect(); 
     
注意事项 
关於 finish 的呼叫在我们的例子并不是必要的. 这个函数适用於 statement handle 完成时所使用。  
永远要加上 use strict。  
仔细阅读 Perl DBI manual 以深入解 DBI 架构  
其他资讯 
DBI - A Database Interface Module for Perl 5  
DBI at Hermetica  
DBI mailing list information  
DBI mailing list archives  
Persistent connections with mod_perl  

-------------------------------------------------------------------------------- 

This document rewrite to Chinese by Jackie Yu. Last modified 20 May 1999  
This document Copyright Jeffrey William Baker. Last modified 10 October 1998