MySQL 用 vsql_network_address 拡張機能

VARCHAR に保存された IP アドレスはアルファベット順に並び、入力ミスを受け付け、アドレスがネットワーク内に入るかどうかに答えられません。vsql_network_address は、入力を検証し、正しく並べ替えられ、それに伴う包含とネットマスクの関数を備えた 4 つのカラム型を追加します。PostgreSQL の inet、cidr、macaddr、および macaddr8 型に従っています。


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

インストール

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

INSTALL EXTENSION vsql_network_address;

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

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

+----------------------+
| EXTENSION_NAME       |
+----------------------+
| vsql_network_address |
+----------------------+

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

追加される機能

型

型	保持する内容	バイト数
`INET`	ネットマスク付き (省略可) のホストアドレス。IPv4 または IPv6	19
`CIDR`	ネットワークアドレス	19
`MACADDR`	6 バイトのハードウェアアドレス	6
`MACADDR8`	8 バイトのハードウェアアドレス	8

CREATE TABLE hosts (
    id    INT PRIMARY KEY,
    label VARCHAR(16),
    addr  INET,
    mac   MACADDR
);

関数

関数	戻り値	説明
`inet_from_string(s)`, `inet_to_string(a)`	`INET`, text	テキストと `INET` を相互に変換する
`cidr_from_string(s)`, `cidr_to_string(c)`	`CIDR`, text	`CIDR` についても同様
`macaddr_from_string(s)`, `macaddr_to_string(m)`	`MACADDR`, text	`MACADDR` についても同様
`macaddr8_from_string(s)`, `macaddr8_to_string(m)`	`MACADDR8`, text	`MACADDR8` についても同様
`inet_compare(a, b)`, `cidr_compare(a, b)`, `macaddr_compare(a, b)`, `macaddr8_compare(a, b)`	int	-1、0、または 1
`inet_contains(a, b)`	int	`a` が `b` を真に包含するとき 1
`inet_contains_or_equals(a, b)`	int	`a` が `b` を包含するか、等しいとき 1
`inet_contained_by(a, b)`	int	`a` が `b` の真に内側にあるとき 1
`inet_contained_by_or_equals(a, b)`	int	`a` が `b` の内側にあるか、等しいとき 1
`inet_overlaps(a, b)`	int	どちらかが他方を包含するか、等しいとき 1
`inet_family(a)`	int	4 または 6
`inet_masklen(a)`	int	ネットマスクの長さ
`inet_set_masklen(a, n)`, `cidr_set_masklen(c, n)`	`INET`, `CIDR`	同じアドレスに異なるネットマスクを付けたもの
`inet_host(a)`, `inet_text(a)`, `inet_abbrev(a)`, `cidr_abbrev(c)`	text	マスクなしのアドレス、マスク付きのアドレス、および省略形
`inet_netmask(a)`, `inet_hostmask(a)`	`INET`	ネットマスクとその補数
`inet_broadcast(a)`	`INET`	所属するネットワークのブロードキャストアドレス
`inet_network(a)`	`CIDR`	アドレスが属するネットワーク
`macaddr_trunc(m)`	`MACADDR`	末尾 3 バイトをゼロにして、製造元プレフィックスを残す

例

INSERT INTO hosts VALUES
    (1, 'gateway', '192.168.1.1/24',  '00:1b:63:84:45:e6'),
    (2, 'printer', '192.168.1.50/24', '3c:22:fb:aa:01:02'),
    (3, 'vpn',     '10.8.0.7/16',     '00:1b:63:84:45:e7');

SELECT label, addr, inet_masklen(addr) AS mask, inet_family(addr) AS family
FROM hosts ORDER BY addr;

+---------+-----------------+------+--------+
| label   | addr            | mask | family |
+---------+-----------------+------+--------+
| vpn     | 10.8.0.7/16     |   16 |      4 |
| gateway | 192.168.1.1/24  |   24 |      4 |
| printer | 192.168.1.50/24 |   24 |      4 |
+---------+-----------------+------+--------+

行はアルファベット順ではなく、アドレス順で返ります。テキスト順では 9.0.0.1 は 10.8.0.7 の後に来ますが、アドレス順ではその前に来ます。どのホストがネットワーク上にあるかを尋ねます。

SELECT label FROM hosts
WHERE inet_contained_by_or_equals(addr, inet_from_string('192.168.1.0/24')) = 1;

+---------+
| label   |
+---------+
| gateway |
| printer |
+---------+

ネットワークとそのブロードキャストアドレスを導出します。

SELECT inet_network(inet_from_string('192.168.1.50/24')) AS network,
       inet_broadcast(inet_from_string('192.168.1.50/24')) AS broadcast;

+----------------+------------------+
| network        | broadcast        |
+----------------+------------------+
| 192.168.1.0/24 | 192.168.1.255/24 |
+----------------+------------------+

inet_contained_by は真の包含を判定するため、ネットワークと同じネットマスクを持つアドレスは、そのネットワークに包含されません。192.168.1.0/24 の中の 192.168.1.5/32 は 1 を返しますが、同じネットワークの中の 192.168.1.5/24 は 0 を返します。上の例のように、保存された行がネットワーク自身のマスクを持つ場合は inet_contained_by_or_equals を使用してください。

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

拡張機能カタログ

拡張機能の作成

インストール

追加される機能

型

関数

例

関連項目

​インストール

​追加される機能

​型

​関数

​例

​関連項目

インストール

追加される機能

型

関数

例

関連項目