MySQL 用 vsql_boolean 拡張機能

MySQL にはブール型がありません。BOOL は TINYINT(1) の別名で、1 と同じように 5 や -1 も受け付け、そのまま返します。vsql_boolean は、1 バイトで格納され、2 つの値だけを保持する STRICTBOOL カラム型を追加します。


メンテナー	VillageSQL
ソースと完全なドキュメント	villagesql/vsql-boolean
ライセンス	GPL-2.0

インストール

インストールスクリプト、Docker イメージ、またはリリース tarball で VillageSQL をインストールした場合、vsql_boolean.veb はすでにサーバーの lib/veb/ ディレクトリにあります。1 つのステートメントでサーバーにインストールします。

INSTALL EXTENSION vsql_boolean;

インストールされたことを確認します。

SELECT EXTENSION_NAME
FROM INFORMATION_SCHEMA.EXTENSIONS
WHERE EXTENSION_NAME = 'vsql_boolean';

+----------------+
| EXTENSION_NAME |
+----------------+
| vsql_boolean   |
+----------------+

自分でビルドするには、リポジトリのビルド手順に従ってください。

追加される機能

STRICTBOOL 型

STRICTBOOL カラムは、文字列 'true'/'false'、't'/'f'、'yes'/'no'、'on'/'off'、および '1'/'0' を、大文字と小文字を問わず受け付けます。文字列として渡してください。裸の数値は拒否されます。どの形式で入れても true または false として読み戻され、1 バイトを占有します。

CREATE TABLE flags (
    id     INT PRIMARY KEY,
    name   VARCHAR(16),
    active STRICTBOOL
);

関数

関数	戻り値	説明
`boolean_to_int(b)`	int	true なら 1、false なら 0
`boolean_sum(b)`	int	集約: グループ内で true の行数
`boolean_avg(b)`	real	集約: true の割合。NULL は無視

例

INSERT INTO flags VALUES
    (1, 'alpha', 'true'),
    (2, 'beta',  'no'),
    (3, 'gamma', 'on'),
    (4, 'delta', '0');

SELECT name, active FROM flags;

+-------+--------+
| name  | active |
+-------+--------+
| alpha | true   |
| beta  | false  |
| gamma | true   |
| delta | false  |
+-------+--------+

4 通りの書き方が入り、2 つの値が出てきました。数えてみます。

SELECT boolean_sum(active) AS enabled, ROUND(boolean_avg(active), 2) AS fraction
FROM flags;

+---------+----------+
| enabled | fraction |
+---------+----------+
|       2 |      0.5 |
+---------+----------+

受け付けられる書き方以外のものは、挿入時に拒否されます。INSERT INTO flags VALUES (5, 'eps', 'maybe') は ERROR 1366 (HY000): Incorrect STRICTBOOL value: 'maybe' for column 'active' at row 1 で失敗します。引用符のない 1 も同様に、ERROR 3219 (HY000): Incorrect STRICTBOOL value: '1' for column 'active' at row 1 で失敗します。

拡張機能のインストールと実行

拡張機能カタログ

拡張機能の作成

インストール

追加される機能

STRICTBOOL 型

関数

例

関連項目

​インストール

​追加される機能

​STRICTBOOL 型

​関数

​例

​関連項目

インストール

追加される機能

STRICTBOOL 型

関数

例

関連項目