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

概要

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

構文

last_insert_rowid()
                

実行例

環境

• Windows 11
• SQLite3 (3.53.3) Command-Line Shell

1. 最後に挿入したレコードのrowidが取得される
2. 一括で挿入した際も最後のrowidが取得される
3. 他のテーブルに挿入した場合はそちらで挿入した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

SQLite3 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_

1. アスタリスク（*）では rowidselect されない。
2. 明示的にrowidを指定すると select することができる。
3. 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

SQLite3 テーブルに主キーを設定する(PRIMARY KEY)

概要

SQLite3 でカラムに主キーを設定するにはいくつか方法があるので この記事ではその方法について記載する。

環境

• Windows 11
• SQLite3 (3.53.1) Command-Line Shell

テーブル作成時にカラムに続けて主キーを指定する

サンプルのテーブルとしてuserテーブルを作成、 id を主キーとする。

「user」テーブル

カラム名	型	制約
id	text	主キー not null制約
name	text

このテーブルを作成するためには以下のSQLを実行する。
カラム名の後にPRIMARY KEYと記述することで、そのカラムに主キーを設定出来る。

create table user (
    id     text  primary key not null
    , name text
);
                

上記のSQLを実行すると、idカラムに主キーが設定される。
そのため、idカラムには重複する値を登録することは出来なくなる。

以下は、上記のテーブルにデータを登録する例。 idカラムに重複する値を登録しようするとエラーになる。

sqlite> insert into user (id, name) values ('001', 'sample_name_1');
sqlite> insert into user (id, name) values ('002', 'sample_name_2');
sqlite> insert into user (id, name) values ('001', 'sample_name_3');
Runtime error: UNIQUE constraint failed: user.id (19)                 
                

補足

上記の方法で複数カラムを主キーとする、いわゆる「複合キー」を設定しようとするとエラーになる。 複合キーを設定するには次項で説明する「テーブル作成時にPRIMARY KEY句を使用する」を参照のこと。

以下は、複合キーを設定しようとしてエラーになる例。

sqlite> create table user (
(x1...>     id     text primary key not null
(x1...>     , name text primary key
(x1...> );
Parse error: table "user" has more than one primary key
                    

テーブル作成時にPRIMARY KEY句を使用する

カラム名に続けて主キーを指定するのではなく、テーブル作成時にPRIMARY KEY句を使用して主キーを設定することも出来る。
この方法を使用することで、複数カラムを主キーとする「複合キー」を設定することが出来る。

以下は、PRIMARY KEY句を使用して主キーを設定する例。

1. idカラムを主キーとする場合
2. idカラムとnameカラムを複合キーとして主キーに設定する場合

-- 1.
create table user (
  id     text not null
  , name text
  , primary key (id)
);

-- 2.
create table user (
  id     text not null
  , name text not null
  , primary key ( id, name )
);
                

複合キーは複数のカラムの値の組み合わせでユニークになることを保証するため、 複合キーに設定したカラムのいずれかに重複する値があっても、他のカラムの値が異なれば登録することが出来る。

以下は、複合キーを設定したテーブルにデータを登録する例。

sqlite> create table user (
(x1...>   id text  not null
(x1...>   , name text not null
(x1...>   , primary key ( id, name )
(x1...> );
sqlite> insert into user (id, name) values ('001', 'sample_name_1');
sqlite> insert into user (id, name) values ('001', 'sample_name_2');
sqlite> insert into user (id, name) values ('001', 'sample_name_1');
Runtime error: UNIQUE constraint failed: user.id, user.name (19)
                

テーブル作成後に主キーを設定する

SQLite3 では、既存のテーブルに対して主キーを ALTER TABLE等で追加設定することは出来ない。 そのため、既存のテーブルに主キーを設定するには、以下の手順で行う必要がある。

1. 新しいテーブルを作成する
2. 既存のテーブルから新しいテーブルにデータをコピーする
3. 既存のテーブルを削除する

詳しい作業手順は下記の過去記事と同じ手順になる。
結構手間がかかるので、最初のテーブル設計はきっちりやるべし。

• SQLite3 カラムの型を変更する

主キーを設定するカラムには必ず NOT NULL 制約を設定する

SQLite3 では PRIMARY KEYを指定しただけでは NULLを入力することができてしまう。

以下はidカラムに主キーを設定したテーブルにNULLを登録する例。

「user」テーブル

カラム名	型	制約
id	text	主キー
name	text

sqlite> .mode box
sqlite> .nullvalue [null]
sqlite> create table user (
(x1...>   id     text primary key
(x1...>   , name text
(x1...> );
sqlite> insert into user (id, name) values (NULL, 'sample_name_1');
sqlite> insert into user (id, name) values (null, 'sample_name_2');
sqlite> select * from user;
┌────────┬───────────────┐
│   id   │     name      │
├────────┼───────────────┤
│ [null] │ sample_name_1 │
│ [null] │ sample_name_2 │
└────────┴───────────────┘
                

• SQLite 3 コマンドラインツールでselectの結果を見やすくする
• SQLite 3 コマンドラインツールでnullの表示を見やすくする

上記の例では、idカラムに主キーを設定しているにも関わらず、 NULLを登録することが出来てしまっている。 さらに、NULLであれば複数登録することも出来てしまっている。
そのため、主キーを設定するカラムにはNOT NULL制約を設定したほうがよい。

これは過去バージョンで主キーにNULLが登録出来てしまっていたことに起因している。 SQLite は後方互換性を重視しているため修正はせず、NULLが登録できる状態を維持する方針らしい。

また、上記の例では主キーのデータ型がtextのためこのような挙動になっているが、 integer型の主キーの場合、もうちょっと厄介な挙動をする。
そのため、主キーを設定するカラムにはNOT NULL制約は必須という考えでいたほうが安全。

参考URL

• PRIMARY KEY(英語)
  公式のPRIMARY KEYに関するドキュメント
  https://www.sqlite.org/lang_createtable.html#the_primary_key
• NOT NULL constraints(英語)
  公式のNOT NULL制約に関するドキュメント
  https://www.sqlite.org/lang_createtable.html#not_null_constraints
• column-constraint(英語)
  公式のカラムに設定する各種制約に関するドキュメント
  https://www.sqlite.org/syntax/column-constraint.html

• SQLite3 備忘録：SQLite3 nullを登録できないようにカラムを設定する(NOT NULL制約)
  https://sfnovicenotes.blogspot.com/2022/04/sqlite3-nullnot-null.html
• SQLite3 備忘録：SQLite3 カラムの型を変更する
  https://sfnovicenotes.blogspot.com/2021/01/sqlite3.html

SQLite3 指定した文字を挟んで文字列を連結する (concat_ws(separator, X, Y, ...))

概要

文字列を連結（結合）するには||演算子か関数 concat() を使用するが、 カンマやドットなどの文字を挟んで連結する場合は concat_ws()を使用する。

ExcelのTEXTJOIN()関数と似たような感覚で使える。

ws は whitespace の略…か？

構文

concat_ws(separator, X, Y, ...)
                

実行例

環境

• Windows 11
• SQLite3 (3.53.1) Command-Line Shell

以下はカンマを使って文字列を連結する場合。
concat()でも同じ結果が得られるが、 concat_ws()の方が簡単に書ける。

sqlite> select concat_ws(',', 'Japan', 'Tokyo', 'Shibuya');
Japan,Tokyo,Shibuya
sqlite> select concat('Japan', ',', 'Tokyo', ',', 'Shibuya');
Japan,Tokyo,Shibuya
                

テーブルのカラムを連結する例:

sqlite> .mode box
sqlite> select * from user;
┌────┬────────────┬───────────┐
│ id │ first_name │ last_name │
├────┼────────────┼───────────┤
│ 1  │ taro       │ yamada    │
│ 2  │ jiro       │ yamada    │
│ 3  │ hanako     │ suzuki    │
└────┴────────────┴───────────┘
sqlite> select
   ...>     concat_ws('.', first_name, last_name)
   ...>         as full_name
   ...> from
   ...>     user;
┌───────────────┐
│   full_name   │
├───────────────┤
│ taro.yamada   │
│ jiro.yamada   │
│ hanako.suzuki │
└───────────────┘
                

• SQLite 3 コマンドラインツールでselectの結果を見やすくする

NULLを含む場合

区切り文字にNULLを指定した場合、他の引数の内容にかかわらず、結果はNULLになる。

sqlite> .nullvalue [null]
sqlite> select concat_ws(NULL, 'Japan', 'Tokyo', 'Shibuya');
[null]
                

区切り文字以外にNULLを指定した場合、NULLは無視され、余分な区切り文字が入ることもない。

sqlite> select concat_ws(',', NULL, 'Tokyo', 'Shibuya');
Tokyo,Shibuya
                

• SQLite 3 コマンドラインツールでnullの表示を見やすくする

参考URL

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

• SQLite3 文字列を連結する (concat(X,Y,...))
  https://sfnovicenotes.blogspot.com/2026/02/sqlite3-concatxy.html