DB_common::createSequence()

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

Synopsis

integer createSequence ( string $seq_name )

Description

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

Parameter

string $seq_name

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

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

Return value

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

Throws

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

Note

This function can not be called statically.

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

Example

createSequence() の使用

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

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