PEAR マニュアル
前のページ		次のページ

DB_common::createSequence()

DB_common::createSequence() -- 新しいシーケンスを作成する

概要

integer createSequence (string $seq_name)

説明

"導入 - シーケンス" を参照ください。

パラメータ

string $seq_name

作成するシーケンスの名前。

データベースの違いによる問題を避けるため、シーケンス名の最初には英字のみを使用するようにし、またそれ以降も英数字とアンダースコア文字のみを使用するようにしましょう。

返り値

integer - 成功した場合に DB_OK、失敗した場合に DB_Error オブジェクトを返します。

例外・エラー

表 39-1PEAR_Error の値

エラーコード	エラーメッセージ	原因	対応法
すべてのエラーコード		データベース固有のエラー。	シーケンス名をチェックします。もし正しければ、おそらくシーケンスの実装のバグでしょう。

注意

この関数は、スタティックにコールすることはできません。

警告

PEAR DB のシーケンスメソッドを使用する場合には、シーケンスの作成も含めたすべての処理にこれらのメソッドを用いることを強く推奨します。 DBMS で直接作成したシーケンスに対して PEAR DB のメソッドでアクセスすることは避けてください。完全な情報は、 "導入 - シーケンス" のページの警告を参照ください。

例

例 39-1createSequence() の使用

<?php
// $db という名前の DB オブジェクトが作成済みであると仮定します...
$tmp = $db->createSequence('mySequence');

if (PEAR::isError($tmp)) {
    die($tmp->getMessage());
}
?>

参照

"導入 - シーケンス"、 nextId()、 dropSequence()

前のページ	ホーム	次のページ
DB_common::commit()	上に戻る	DB_common::disconnect()