DB_common::nextId()

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

説明

シーケンスから、次に使用可能な値を返します。このメソッドがコールされるたびにシーケンスは自動的に加算されます。

詳細な説明は、"導入 - シーケンス" を参照ください。

パラメータ

string $seq_name

シーケンスの名前。

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

boolean $onDemand

TRUE を設定すると、指定したシーケンスが存在しない場合には自動的に作成されます。

この機能を使用するには、スクリプトで指定したデータベースユーザがテーブルやシーケンスを作成する権限を持っている必要があります。必要な検眼は、使用している DBMS に依存します。

返り値

integer - 使用可能な ID 番号、あるいは失敗した場合に DB_Error オブジェクトを返します。

例外・エラー

表 39-1PEAR_Error の値

エラーコード	エラーメッセージ	原因	対応法
`DB_ERROR_NOT_CAPABLE`	DB backend not capable	この機能は、データベースバックエンドではサポートされていません。	もしほんとうにこの機能が必要であれば、別のデータベースシステムを使用しましょう。
`DB_ERROR_NOT_LOCKED`	not locked	シーケンステーブルが見つけられません。	データベース固有のエラーです。使用しているデータベースのドキュメントを参照ください。
`DB_ERROR_NOSUCHTABLE`	no such table	シーケンステーブルが見つかりませんでした。	新しいシーケンスを作成してください。もしシーケンスが存在することが確かなのであれば、データベースの状態を確認してみましょう。

注意

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

警告

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

例

例 39-1nextId() の使用法

<?php
// $db という名前の DB オブジェクトが作成済みであると仮定します...
$id = $db->nextId('mySequence');
if (PEAR::isError($id)) {
    die($id->getMessage());
}

// INSERT クエリで ID を使用します
$res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')");
?>

参照

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

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

DB_common::nextId()

概要

説明

パラメータ

返り値

例外・エラー

注意

例

参照