Perl DBI 入门

theoforce

　　目录
　　基本功能
　　建立连线
　　选项
　　下达 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 (>　　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>　　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, $phonen";
　　}
　　$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>　　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, $phonen";
　　}
　　}
　　$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::errstrn";
　　$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