Perl DBI 入门

本文是以 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 方法. 咱们先看看後者如何使用.

 

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

#!/usr/bin/perl -w

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 @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