SQLite 備忘録

2025年12月21日日曜日

SQLite3 エラーが起きた時に処理をキャンセルする (.bail)

コマンドラインツールコマンド一覧

概要

SQLite3のコマンドラインツールを使用している際、一連の処理でエラーになった場合、 .bailコマンドを設定しておくことでその後の処理をキャンすることができる。

SQLiteコマンドラインツールを起動する際に -bailオプションを指定することでも同様の効果を得ることができる。

これにより、連鎖的にエラーが発生したり、意味のない処理が動くことを止めることができる。

構文

コマンドラインツール起動中にBail機能をON/OFF にする。（デフォルトはOFF）


.bail on
.bail off

コマンドライン起動時にBail機能をON/OFF にする。（デフォルトはOFF）


c:\temp> sqlite3 -bail on
c:\temp> sqlite3 -bail off

実行例

環境

Windows 10 64bit
SQLite Command-Line Shell ver 3.50.2

.bailはCLIでコマンドを手入力する作業ではあまり恩恵がない。（と思う）
外部のSQLファイルを読み込んだり、シェルのコマンドラインからSQLを渡したときに効果を発揮する。

`.bail`がOFFのままの場合

以下のようなSQLファイルを準備する。

sample_01.sql


-- # 1
.bail off

-- # 2
create table user_01 (id, name);
create tbl user_02 (id, name);
create table user_03 (id, name);

bailをOFFにする
create table文を３つ実行する。
ただし、2つ目のSQL構文に誤りがあるのでエラーになるようになっている。

準備したSQLファイルをSQLite3のコマンドラインツールから読み込んでテーブル一覧を表示してみる。


.read ./sample_01.sql
.tables

SQLite 3 コマンドラインツールからSQLファイルを読み込んで実行する

実行結果


sqlite> .read ./sample.sql
Parse error near line 6: near "tbl": syntax error
  create tbl user_02 (id, name);
         ^--- error here
sqlite> .tables
user_01  user_03

２つ目のSQLが失敗し、エラーになっている。１つ目のSQLと３つ目のSQLは成功し、テーブルが２つ作成されていることがわかる。

`.bail`をONにした場合

以下のようなSQLファイルを準備する。

sample_02.sql


-- # 1
.bail on

-- # 2
create table user_01 (id, name);
create tbl user_02 (id, name);
create table user_03 (id, name);

bailをONにする
create table文を３つ実行する。
2つ目のSQL構文に誤りがあるのでエラーになるようになっている。
テーブル一覧を表示する

準備したSQLファイルをSQLite3のコマンドラインツールから読み込む。


.read ./sample_02.sql
.tables

SQLite 3 コマンドラインツールからSQLファイルを読み込んで実行する

実行結果


sqlite> .read ./sample02.sql
Parse error near line 6: near "tbl": syntax error
  create tbl user_02 (id, name);
         ^--- error here
sqlite> .tables
user_01

２つ目のSQLが失敗し、.tablesを実行すると、 user_03テーブルが作成されていないことがわかる。

よって２つ目でSQLが失敗した後、以降のSQLやコマンドはキャンセルされていることがわかる。

コマンドラインツールで手で入力する場合

以下のような実行の仕方では bailは意味がない。


sqlite> .bail on
sqlite> create table user_01 (id, name);
sqlite> create tbl user_02 (id, name);
Parse error: near "tbl": syntax error
  create tbl user_02 (id, name);
         ^--- error here
sqlite> create table user_03 (id, name);
sqlite> .tables
user_01  user_03

以下のように一度に複数のSQLを実行する場合であれば、途中で発生したエラー以降はキャンセルされる。


sqlite> .bail on
sqlite> create table user_01 (id, name); create tbl user_02 (id, name); create table user_03 (id, name);
Parse error: near "tbl": syntax error
  create tbl user_02 (id, name); create table user_03 (id, name);
         ^--- error here
sqlite> .tables
user_01

参考URL

Command Line Shell For SQLite
公式のコマンドラインツールに関するドキュメント
https://www.sqlite.org/cli.html

2025年7月13日日曜日

SQLite 3 文字列から特定の文字列があるかを確認する、特定の文字列が何文字目から始まるかを調べる。(instr())

概要

isstr() を使うとある文字列の中に含まれる指定した文字列の開始位置を取得できる。
文字列が含まれていない場合、関数は0 を返す。

構文


instr(str1, str2)

str1: 調査対象の文字列
str2: str1に含まれているであろう文字列

実行例１

環境

Windows 10
SQLite ver 3.50.1


sqlite> --# 1.                    
sqlite> select instr('sample@example.com', 'hoge');
0
sqlite> --# 2.
sqlite> select instr('sample@example.com', 'sample');
1
sqlite> --# 3.
sqlite> select instr('sample@example.com', 'example');
8
sqlite> --# 4.
sqlite> select instr('sample@example.com', 'am');
2
sqlite> --# 5.
sqlite> .nullvalue [null]
sqlite> select instr(NULL, 'example');
[null]
sqlite> select instr('sample@example.com', NULL);
[null]
sqlite> select instr(NULL, NULL);
[null]

対象の文字列が含まれていない場合は 0 を返す
先頭で文字が見つかった場合は 1 となる
見つかった文字列の開始位置を返す
複数個所に検索文字列がある場合、最初に見つかった文字列の位置を返す
引数のどちらかがNULLの場合、 NULLを返す。

参考URL

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

2024年3月24日日曜日

SQLite 3 二つの値を比較し同じ場合NULLを返す(nullif())

概要

nullif()は引数に与えられた2つの値を比較し、同じだった場合null、違った場合第一引数を返す。
iif()の亜種のような関数。

構文


nullif(value1, value2)

value1: 二つの引数の値が異なる場合、この引数が返される。
value2: value1 と比較する値

実行例１

環境

Windows 10
SQLite ver 3.45.1


sqlite> .nullvalue [null]
sqlite> select nullif(1, 1);
[null]
sqlite> select nullif(1, 0);
1
sqlite> select nullif('sample1', 'sample1');
[null]
sqlite> select nullif('sample1', 'sample2');
sample1
sqlite> select nullif('1', 1);
1
sqlite> select nullif(true, true);
[null]
sqlite> select nullif(true, false);
1

参考URL

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

SQLite 3 NULLの場合、別の値を返す(ifnull())
https://sfnovicenotes.blogspot.com/2024/03/sqlite-3-nullifnull.html

2024年3月2日土曜日

SQLite 3 NULLの場合、別の値を返す(ifnull())

概要

値がNULLかどうかを判定して、NULLだった場合別の値を返すようにするには ifnull()関数を使う。 ifnull()はOracleのNVL()に相当する機能。

構文


ifnull(value1, value2)

value1: NULLかどうかを判定する対象。この値がNULLでなければ関数はこの値をそのまま返す。
value2: value1がNULLだった場合、この関数はこの値を返す。

実行例１

環境

Windows 10
SQLite ver 3.45.1


sqlite> .mode box
sqlite> -- 1.
sqlite> select ifnull(null, 'sample1') as result;
┌─────────┐
│ result  │
├─────────┤
│ sample1 │
└─────────┘

sqlite> -- 2.
sqlite> select ifnull(0, 'sample2') as result;
┌────────┐
│ result │
├────────┤
│ 0      │
└────────┘
sqlite> select ifnull('not null', 'sample3') as result;
┌──────────┐
│  result  │
├──────────┤
│ not null │
└──────────┘

sqlite> -- 3.
sqlite> .nullvalue [null]
sqlite> select ifnull(null, null) as result;
┌────────┐
│ result │
├────────┤
│ [null] │
└────────┘

第一引数がnullだった場合、第二引数の値を返す。
第一引数がnullでなければ、第一引数をそのまま返す。
第一引数・第二引数ともにnullだった場合、nullを返す。

実行例２

users
id	last_login	created_at
0001	2024-02-01	2024-01-31
0002		2024-02-01
0003		2024-02-03

そのまま出力。


select
    id
    , last_login
    , created_at
from
    users
;

結果
id	last_login	created_at
0001	2024-02-01	2024-01-31
0002		2024-02-01
0003		2024-02-03

last_login がNULLだった場合、「not logged in」を表示する。


select
    id
    , ifnull(last_login, 'not logged in') as last_login
from
    users
;

結果
id	last_login
0001	2024-02-01
0002	not logged in
0003	not logged in

last_login がNULLだった場合、created_at を換わりに取得する。


select
    id
    , ifnull(last_login, created_at) as last_login
from
    users
;

結果
id	last_login
0001	2024-02-01
0002	2024-02-01
0003	2024-02-03

参考URL

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

2025年12月21日日曜日

SQLite3 エラーが起きた時に処理をキャンセルする (.bail)

概要

構文

実行例

環境

.bailがOFFのままの場合

sample_01.sql

.bailをONにした場合

sample_02.sql

コマンドラインツールで手で入力する場合

参考URL

2025年7月13日日曜日

SQLite 3 文字列から特定の文字列があるかを確認する、 特定の文字列が何文字目から始まるかを調べる。(instr())

概要

構文

実行例１

環境

参考URL

2024年3月24日日曜日

SQLite 3 二つの値を比較し同じ場合NULLを返す(nullif())

概要

構文

実行例１

環境

参考URL

2024年3月2日土曜日

SQLite 3 NULLの場合、別の値を返す(ifnull())

概要

構文

実行例１

環境

実行例２

参考URL

`.bail`がOFFのままの場合

`.bail`をONにした場合

SQLite 3 文字列から特定の文字列があるかを確認する、特定の文字列が何文字目から始まるかを調べる。(instr())