pg_last_oid

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_last_oid — 直近の行のオブジェクト ID を返す

    説明

    pg_last_oid(PgSql\Result $result): string|int|false

    pg_last_oid() は、挿入された行に割り当てられた OID を取得します。

    OID フィールドは PostgreSQL 7.2 からはオプションとなり、 PostgreSQL 8.1 ではデフォルトで存在しません。OID フィールドが テーブルに存在しない場合、プログラマは pg_result_status() を使用して挿入が成功したことを 確かめる必要があります。

    挿入された行の SERIAL フィールドの値を取得するには、 PostgreSQL の CURRVAL 関数を使用してシーケンス内で 直近に要求された値を取得する必要があります。シーケンス名がわからない 場合は、PostgreSQL 8.0 の関数 pg_get_serial_sequence が必要になります。

    PostgreSQL 8.1 には LASTVAL 関数が存在し、セッション内で 直近に使用されたシーケンスの値を返します。これを用いれば、シーケンスや テーブルやカラムの名前を指定する必要がなくなります。

    注意:

    この関数は、以前は pg_getlastoid() と呼ばれていました。

    パラメータ

    result

    pg_query()、pg_query_params() や (様々な関数がありますが、特に) pg_execute() が返した PgSql\Result クラスのインスタンス。

    戻り値

    指定された connection で、直近に挿入された行に 割り当てられた OID を数値または文字列で返します。エラー時や有効な OID のない場合に false を返します。

    変更履歴

    バージョン 説明
    8.1.0 result は、PgSql\Result クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、リソース を期待していました。

    例

    例1 pg_last_oid() の例

    <?php
    // データベースに接続します
    pg_connect("dbname=mark host=localhost");

    // サンプルのテーブルを作ります
    pg_query("CREATE TABLE test (a INTEGER) WITH OIDS");

    // データを追加します
    $res = pg_query("INSERT INTO test VALUES (1)");

    $oid = pg_last_oid($res);
    ?>

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 6 notes

    up
    0
    julian at e2-media dot co dot nz
    21 years ago
    The way I nuderstand it, each value is emitted by a sequence only ONCE. If you retrieve a number (say 12) from a sequence using nextval(), the sequence will advance and subsequent calls to nextval() will return further numbers (after 12) in the sequence.

    This means that if you use nextval() to retrieve a value to use as a primary key, you can be guaranteed that no other calls to nextval() on that sequence will return the same value. No race conditions, no transactions required.

    That's what sequences are *for* afaik :^)
    up
    0
    a dot bardsley at lancs dot ac dot uk
    21 years ago
    As pointed out on a busy site some of the above methods might actually give you an incorrect answer as another record is inserted inbetween your insert and the select. To combat this put it into a transaction and dont commit till you have done all the work
    up
    0
    webmaster at gamecrash dot net
    21 years ago
    You could use this to get the last insert id...

    CREATE TABLE test (
    id serial,
    something int not null
    );

    This creates the sequence test_id_seq. Now do the following after inserting something into table test:

    INSERT INTO test (something) VALUES (123);
    SELECT currval('test_id_seq') AS lastinsertid;

    lastinsertid should contain your last insert id.
    up
    -1
    dtutar at yore dot com dot tr
    21 years ago
    This is very useful function :)

    function sql_last_inserted_id($connection, $result, $table_name, $column_name) {
    $oid = pg_last_oid ( $result);
    $query_for_id = "SELECT $column_name FROM $table_name WHERE oid=$oid";
    $result_for_id = pg_query($connection,$query_for_id);
    if(pg_num_rows($result_for_id))
    $id=pg_fetch_array($result_for_id,0,PGSQL_ASSOC);
    return $id[$column_name];
    }

    Call after insert, simply ;)
    up
    -4
    qeremy [atta] gmail [dotta] com
    12 years ago
    Simply getting LAST_INSERT_ID;

    <?php
    // Note: waiting for "select" part from pg_query below.
    // Note: separating the query parts using semicolons (;).

    $qry = pg_query("
    INSERT INTO users (id,uname,upass,rep) VALUES (DEFAULT,'bubu','a981v',0.19);
    SELECT Currval('users_id_seq') LIMIT 1
    "    );

    // or
    $qry = pg_query("
    INSERT INTO users (id,uname,upass,rep) VALUES (DEFAULT,'bubu','a981v',0.19) RETURNING Currval('users_id_seq')"    );

    $fch = pg_fetch_row($qry);
    print_r($fch);
    ?>

    Array
    (
    [0] => 3 -> Gotcha!
    )
    up
    -3
    Jonathan Bond-Caron
    19 years ago
    I'm sharing an elegant solution I found on the web (Vadim Passynkov):

    CREATE RULE get_pkey_on_insert AS ON INSERT TO Customers DO SELECT currval('customers_customers_id_seq') AS id;

    Every time you insert to the Customers table, postgreSQL will return a table with the id you just inserted. No need to worry about concurrency, the ressource is locked when the rule gets executed.

    Note that in cases of multiple inserts:
    INSERT INTO C1 ( ... ) ( SELECT * FROM C2);

    we would return the id of the last inserted row.

    For more info about PostgreSQL rules:
    http://www.postgresql.org/docs/7.4/interactive/sql-createrule.html
    ＋add a note
    To Top