SQLite 備忘録: oid

概要

現在のデータベース接続で一番最後に挿入されたレコードのrowidの値を取得するには last_insert_rowid関数を使用する。

構文


last_insert_rowid()

実行例

環境

Windows 11
SQLite3 (3.53.3) Command-Line Shell

最後に挿入したレコードのrowidが取得される
一括で挿入した際も最後のrowidが取得される
他のテーブルに挿入した場合はそちらで挿入したrowidが取得される


sqlite> create table user (id, name);
sqlite> create table product (id, name, quantity);

sqlite> -- 1.
sqlite> insert into user (id, name) values ('001', 'sample_user_001');
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   1 │
╰─────────────────────╯

sqlite> -- 2. 
sqlite> insert into user (id, name) values ('002', 'sample_user_002'), ('003', 'sample_user_003');
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
│     2 │ '002' │ sample_user_002 │
│     3 │ '003' │ sample_user_003 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   3 │
╰─────────────────────╯

sqlite> --3.
sqlite> insert into product (id, name, quantity) values ('001', 'tomato', 100);
sqlite> select rowid, * from product;
╭───────┬───────┬────────┬──────────╮
│ rowid │  id   │  name  │ quantity │
╞═══════╪═══════╪════════╪══════════╡
│     1 │ '001' │ tomato │      100 │
╰───────┴───────┴────────┴──────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   1 │
╰─────────────────────╯
sqlite>

last_insert_row()で取得できるのはあくまで「新規挿入」された時のrowidであり、たとえばupdateで更新された際の値は無視される。


sqlite> select rowid, * from product;
╭───────┬───────┬────────┬──────────╮
│ rowid │  id   │  name  │ quantity │
╞═══════╪═══════╪════════╪══════════╡
│     1 │ '001' │ tomato │      100 │
╰───────┴───────┴────────┴──────────╯
sqlite> insert into user (id, name) values ('004', 'sample_user_004');
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
│     2 │ '002' │ sample_user_002 │
│     3 │ '003' │ sample_user_003 │
│     4 │ '004' │ sample_user_004 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   4 │
╰─────────────────────╯
sqlite> update user set rowid = '999' where id = '004';
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
│     2 │ '002' │ sample_user_002 │
│     3 │ '003' │ sample_user_003 │
│   999 │ '004' │ sample_user_004 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   4 │
╰─────────────────────╯
sqlite>

DBをattachした場合の挙動

attachコマンドを使えば複数のDBを同時に操作できる。この場合もlast_insert_rowid()は接続先のDBを問わず、一番最近insertした際のrowidが返される。


C:\temp>sqlite3 test01.db
SQLite version 3.53.3 2026-06-26 20:14:12
Enter ".help" for usage hints.
sqlite> insert into user (id, name) values ('005', 'sample_user_005');
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
│     2 │ '002' │ sample_user_002 │
│     3 │ '003' │ sample_user_003 │
│     4 │ '004' │ sample_user_004 │
│     5 │ '005' │ sample_user_005 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   5 │
╰─────────────────────╯
sqlite> attach database "test02.db" as test02;
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   5 │
╰─────────────────────╯
sqlite> insert into test02.user (id, name) values ('006', 'sample_user_006');
sqlite> select rowid, * from test02.user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '006' │ sample_user_006 │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   1 │
╰─────────────────────╯
sqlite>

コネクション作成直後は0になる

last_insert_rowid()はあくまで 現在の接続で最後に挿入されたデータのrowidを取得するので、一度接続を切ればリセットされて最初は0を返す。


sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   6 │
╰─────────────────────╯
sqlite> .quit
C:\temp>sqlite3 test01.db
SQLite version 3.53.3 2026-06-26 20:14:12
Enter ".help" for usage hints.
sqlite> select rowid, * from user;
╭───────┬───────┬─────────────────╮
│ rowid │  id   │      name       │
╞═══════╪═══════╪═════════════════╡
│     1 │ '001' │ sample_user_001 │
│     2 │ '002' │ sample_user_002 │
│     3 │ '003' │ sample_user_003 │
│     4 │ '004' │ sample_user_004 │
│     5 │ '005' │ sample_user_005 │
│     6 │ '007' │ sample          │
╰───────┴───────┴─────────────────╯
sqlite> select last_insert_rowid();
╭─────────────────────╮
│ last_insert_rowid() │
╞═════════════════════╡
│                   0 │
╰─────────────────────╯

参考URL

公式のlast_insert_rowid()に関するドキュメント
https://sqlite.org/lang_corefunc.html#last_insert_rowid

概要

SQLite のテーブルの各レコードにはデフォルトで隠しカラムとしてrowidが設定される。
積極的に使うわけではないけど覚えておくと便利な機能、といった程度の認識でいい。
仕様を理解していないうちに頼ってしまうと後々痛い目に合うので注意。

このrowidには符号付64ビットのユニークな整数が自動的に格納される。
役割としてはprimary keyと同じで、テーブルのレコードを一意に識別するために使われる。

この記事ではprimary key や autoincrement を設定していないシンプルなテーブルでの挙動について記載する。

実行例

環境

Windows 11
SQLite3 (3.53.1) Command-Line Shell

適当なテーブルを作成し、適当なデータを挿入し、rowidを確認してみる。

rowidに入っている値を調べるには、以下のいずれかのカラム名を指定してselect文を実行する。

rowid
oid
_rowid_

アスタリスク（*）では rowidselect されない。
明示的にrowidを指定すると select することができる。
rowid、 oid、 _rowid_はすべて同じ値を指し、カラム名はrowidとして返される。


sqlite> create table user (id, name);
sqlite> insert into user (id, name) values (111, 'sample_user_1');
sqlite> insert into user (id, name) values (222, 'sample_user_2');
sqlite> .mode box

sqlite> -- 1.
sqlite> select * from user;
┌─────┬───────────────┐
│ id  │     name      │
├─────┼───────────────┤
│ 111 │ sample_user_1 │
│ 222 │ sample_user_2 │
└─────┴───────────────┘

sqlite> -- 2.
sqlite> select rowid, * from user;
┌───────┬─────┬───────────────┐
│ rowid │ id  │     name      │
├───────┼─────┼───────────────┤
│ 1     │ 111 │ sample_user_1 │
│ 2     │ 222 │ sample_user_2 │
└───────┴─────┴───────────────┘

sqlite> -- 3.
sqlite> select rowid, oid, _rowid_ from user;
┌───────┬───────┬───────┐
│ rowid │ rowid │ rowid │
├───────┼───────┼───────┤
│ 1     │ 1     │ 1     │
│ 2     │ 2     │ 2     │
└───────┴───────┴───────┘

要するに上記のSQLでは、実際には以下のようなテーブルが作成されていることになる。

rowid 別名：oid 別名：_rowid_ （隠しカラム）	id	name
1	111	sample_user_1
2	222	sample_user_2

そのテーブルの最大 rowid + 1 が採番される

例外はあるものの、基本的にはそのテーブルの最大 rowid + 1 が採番される。
そのため、rowid は連番であることが多い。

参考URL

ROWIDs and the INTEGER PRIMARY KEY(英語)
公式のROWIDに関するドキュメント
https://www.sqlite.org/lang_createtable.html#rowids_and_the_integer_primary_key
Rowid Tables（英語）
Rowid が設定されたテーブルに関するドキュメント
https://sqlite.org/rowidtable.html

SQLite 備忘録

2026年7月20日月曜日

SQLite3 最後に挿入された rowid を確認する（last_insert_rowid）

概要

構文

実行例

環境

DBをattachした場合の挙動

コネクション作成直後は0になる

参考URL

2026年7月10日金曜日

SQLite3 rowid を理解する

概要

実行例

環境

そのテーブルの最大 rowid + 1 が採番される

参考URL

ページ