IP 函式¶

ip_prefix(ip_address, prefix_bits) -> ipprefix()¶

傳回具有 prefix_bits 子網路大小之指定 ip_address 的 IP 首碼。ip_address 可以是 VARCHAR 類型或 IPADDRESS 類型。

SELECT ip_prefix(CAST('192.168.255.255' AS IPADDRESS), 9); -- {192.128.0.0/9}
SELECT ip_prefix('2001:0db8:85a3:0001:0001:8a2e:0370:7334', 48); -- {2001:db8:85a3::/48}

ip_subnet_min(ip_prefix) -> ip_address()¶

傳回 ip_prefix 指定的子網路中，IPADDRESS 類型的最小 IP 位址。

SELECT ip_subnet_min(IPPREFIX '192.168.255.255/9'); -- {192.128.0.0}
SELECT ip_subnet_min(IPPREFIX '2001:0db8:85a3:0001:0001:8a2e:0370:7334/48'); -- {2001:db8:85a3::}

ip_subnet_max(ip_prefix) -> ip_address()¶

傳回 ip_prefix 指定的子網路中，IPADDRESS 類型的最大 IP 位址。

SELECT ip_subnet_max(IPPREFIX '192.64.0.0/9'); -- {192.127.255.255}
SELECT ip_subnet_max(IPPREFIX '2001:0db8:85a3:0001:0001:8a2e:0370:7334/48'); -- {2001:db8:85a3:ffff:ffff:ffff:ffff:ffff}

ip_subnet_range(ip_prefix) -> array(ip_address)¶

傳回 2 個 IP 位址的陣列。陣列包含 ip_prefix 指定之子網路中的最小和最大 IP 位址。

SELECT ip_subnet_range(IPPREFIX '1.2.3.160/24'); -- [{1.2.3.0}, {1.2.3.255}]
SELECT ip_subnet_range(IPPREFIX '64:ff9b::52f4/120'); -- [{64:ff9b::5200}, {64:ff9b::52ff}]

is_subnet_of(ip_prefix, ip_address) -> boolean()¶

如果 ip_address 在 ip_prefix 的子網路中，則傳回 true。

SELECT is_subnet_of(IPPREFIX '1.2.3.128/26', IPADDRESS '1.2.3.129'); -- true
SELECT is_subnet_of(IPPREFIX '64:fa9b::17/64', IPADDRESS '64:ffff::17'); -- false

is_subnet_of(ip_prefix1, ip_prefix2) -> boolean()¶

如果 ip_prefix2 是 ip_prefix1 的子網路，則傳回 true。

SELECT is_subnet_of(IPPREFIX '192.168.3.131/26', IPPREFIX '192.168.3.144/30'); -- true
SELECT is_subnet_of(IPPREFIX '64:ff9b::17/64', IPPREFIX '64:ffff::17/64'); -- false
SELECT is_subnet_of(IPPREFIX '192.168.3.131/26', IPPREFIX '192.168.3.131/26'); -- true

ip_prefix_collapse(array(ip_prefix)) -> array(ip_prefix)¶

傳回輸入 IPPREFIX 陣列的最小 CIDR 表示法。輸入陣列中的每個 IPPREFIX 都必須是相同的 IP 版本（也就是說，只有 IPv4 或只有 IPv6），否則查詢將失敗並引發錯誤。

SELECT IP_PREFIX_COLLAPSE(ARRAY[IPPREFIX '192.168.0.0/24', IPPREFIX '192.168.1.0/24']); -- [{192.168.0.0/23}]
SELECT IP_PREFIX_COLLAPSE(ARRAY[IPPREFIX '2620:10d:c090::/48', IPPREFIX '2620:10d:c091::/48']); -- [{2620:10d:c090::/47}]
SELECT IP_PREFIX_COLLAPSE(ARRAY[IPPREFIX '192.168.1.0/24', IPPREFIX '192.168.0.0/24', IPPREFIX '192.168.2.0/24', IPPREFIX '192.168.9.0/24']); -- [{192.168.0.0/23}, {192.168.2.0/24}, {192.168.9.0/24}]