クラスメソッドはDBIをuseしてすぐに使える関数です。クラスメソッドは、データベースに接続するためのconnect以外はそれほど必須なメソッドではありません。

DBIクラスメソッド

connect

# %attrはオプションです
$dbh = DBI->connect($data_source, $user, $password, \%attr)
    or die $DBI::errstr;

connectはデータベース接続するためのメソッドです。connectが正常終了した場合は、データベース・ハンドルを返すので、そのハンドルを使ってデータベースを操作するメソッドを呼び出します。接続の終了は$dbh->disconnectを使用します。

$dbh を使ってメソッドを呼び出す

# データベースへ接続
$dbh = DBI->connect($dsn, $user, $password);
# データベース・ハンドルから selectrorw_array を呼び出す
$ref = $dbh->selectrow_array(
    "SELECT COUNT(*) FROM db "
);

connectは、接続に失敗すると、$DBI::errと$DBI::errstrにエラー情報をセットし、undefを返します。connectの返すステータスを確認し、失敗していたら$DBI::errstrを表示させるとよいでしょう。

$dbh = DBI->connect($dsn, $user, $password);
if ( ! $dbh ){
    print "エラー： $dbh->err $dbh->errstr\n";
}

引数$data_sourceの値にはDBI:ドライバ名を指定します。大文字・小文字は区別されます。さらに データベース名、ホスト名、ポート番号を指定できます。

$data_source値の例

dbi:DriverName:database_name
dbi:DriverName:database_name@hostname:port
dbi:DriverName:database=database_name; host=hostname;port=port

引数$userまたは$passwordが未定義（空ではなく）ならば、環境変数DBI_USERとDBI_PASSの値で置き換えられます。ただし、セキュリティを考慮すると、これらの環境変数の値を使うことは推薦されません。

ドライバがまだインストールされていない場合、connectはドライバを自動的にインストールします。ドライバのインストールは有効なドライバハンドルを返すか、エラーメッセージとともに終了します。

\%attrパラメータはPrintError、RaiseError、AutoCommitなどの属性を変更することができます。AutoCommitとPrintError属性はデフォルトでONですが、明示的にAutoCommitを定義したほうが安全です。

引数 \%attr の値を設定

$dbh = DBI->connect($data_source, $user, $pass, {
    PrintError    => 0,
    AutoCommit => 0
});

$dbhを使った各セッションは、他のセッションのトランザクションから独立しています。これはオープンしたカーソルをトランザクションをまたがって保持する必要がある場合には便利です。つまり１つのセッションを長い寿命をもつカーソルとして使い、他のセッションで短い更新トランザクションを実行できるということです。

環境変数DBI_AUTOPROXYが定義されていて、$data_sourceに'Proxy'の指定がなければ、接続の要求は自動的に以下のように変更され、DBD::Proxyモジュールに渡されます。

DBI_AUTOPROXYの設定

dbi:Proxy:$ENV{DBI_AUTOPROXY};dsn=$data_source

DBI_AUTOPROXYの書式は、hostname=...;port=...です。

connect_cached

# %attrはオプションです
$dbh = DBI->connect_cached($data_source, $username,
$password, \%attr) or die $DBI::errstr;

connect_cachedは、返却値のデータベース・ハンドルが与えられたパラメータと関連付けられ、ハッシュにも格納されるという点を除けばconnectに似ています。同じパラメータ値でconnect_cachedがもう一度呼ばれると、それがまだ適切であれば、キャッシュされた$dbhが返されます。すでに切断されている場合などは、新しい接続で置きかえられます。

キャッシュはCachedKids属性
でアクセス、もしくはクリアすることができます。

キャッシュは、問題の原因になりやすく、このメソッドの動作は変更される可能性が高いので、注意して使いましょう。

available_drivers

@ary = DBI->available_drivers;
@ary = DBI->available_drivers($quiet);

@INCディレクトリからDBD関連のモジュールを検索して、使用可能なドライバのリストを返します。MySQLのドライバ名はmysqlです。
available_driversは、同じ名前のドライバがあれば警告します。引数$quietをTRUEにセットすると、警告が出力されなくなります。

data_sources

@ary = DBI->data_sources($driver);
@ary = DBI->data_sources($driver, \%attr);

指定されたドライバが利用可能な全てのデータソースのリストを返します。data_sourcesが返す値はconnectメソッドにそのまま渡すことができます。このとき、読み込まれていないドライバは
自動的にロードされます。

$driverが空文字や未定義の場合、DBI_DRIVER環境変数の値が使用されます。
多くのドライバが、空文字、もしくは不完全なリストを返すことが多いので、注意しましょう。

trace

DBI->trace($trace_level)
DBI->trace($trace_level, $trace_file)

traceメソッドは、全てのハンドルのDBIトレース情報を有効にします。特定のハンドルに対するトレース情報を得るには、$h->traceメソッドを使うと良いでしょう。

トレース・レベル（$trace_level）は以下のとおりです。

トレース出力の多くはneat関数を使用して整形されるので、トレース出力中の文字列は切り詰められることもあります。

トレースはデフォルトで標準エラー出力（STDERR）に出力されます。引数$trace_fileを指定した場合、ファイルは追加モードで開かれ、すべてのトレース情報が指定のファイルに書き込まれます。それ以降は、$trace_fileを指定しなくても、そのファイルがデフォルトで使用されます。

traceの一般的な使用方法

# 出力はファイルDBI.traceに送られます
$dbh->trace(2, 'DBI.trace');

DBI ユーティリティ関数

DBIは上記で紹介したメソッドに加え、下記のユーティリティ関数を用意しています。

neat非日本語対応）

$str = DBI::neat($value, $maxlen);

指定された文字列を整形して返します。

整形内容

• 文字列中のクォーテーションをエスケープ
• 文字列全体をクォーテーションで囲む（数値は対象外）
• 出力できない文字はドット( . )で置き換え

また、未定義値（NULL）はundefとして返されます。

引数$maxlenを指定して、文字列の長さを切り詰めることができます。変換結果の文字列が$maxlenよりも長ければ、文字列は$maxlen-4の長さに切り詰め、... を追加します。$maxlenが 0
またはundefの場合、$DBI::neat_maxlen（デフォルトは400）で切り詰めます。

neatの使用方法

my $str = "1234567890";
$str = DBI::neat($str, 9);
print $str, "\n"; # "1234..."と出力される

neat_list

$str = DBI::neat_list(\@listref, $maxlen, $field_sep);

リストの各要素でDBI::neatを呼び、$field_sepで結合した文字列を返します。$field_sepのデフォルトはカンマ( , )です。

looks_like_number

@bool = DBI::looks_like_number(@array);

リストの各要素について、数値に見えばTRUE、そうでなければFALSEを返します。未定義、あるいは空文字であれば、undefもしくは空文字を返します。

DBI の動的な属性

動的な属性は、常に最後に使用されたハンドルに関係しています。

※　これらの属性は便宜上提供されますが、制限があります。特に、使用される最後のハンドルに関係しているので、それらをセットしたメソッドを呼んだ直後にのみ使用してください。

問題が無ければ、対応するメソッド呼び出しを使うようにしましょう。