跳到主要内容
版本：26.x

IPV6_CIDR_TO_RANGE

ipv6_cidr_to_range​

描述​

根据 IPv6 地址和 CIDR 前缀长度，计算该网段的最小和最大 IPv6 地址，返回一个包含两个 IPv6 地址的结构体。

语法​

IPV6_CIDR_TO_RANGE(<ipv6_address>, <cidr_prefix>)

参数​

  • <ipv6_address>：IPv6 类型的地址或 IPv6 字符串
  • <cidr_prefix>：CIDR 前缀长度（SMALLINT 类型，范围 0-128）

返回值​

返回类型：STRUCT<min: IPv6, max: IPv6>

返回值含义：

  • 返回一个结构体，包含两个字段：min：网段的最小 IPv6 地址，max：网段的最大 IPv6 地址
  • <ipv6_address> <cidr_prefix> 输入参数任意一个为NULL， 返回NULL

使用说明​

  • CIDR 前缀长度必须在 0-128 范围内
  • 支持 IPv6 类型和字符串类型的输入
  • 计算基于网络掩码，将主机位全部置零得到最小地址，全部置一得到最大地址
  • 支持常量参数和列参数的各种组合

举例​

计算 /64 网段的地址范围。

SELECT ipv6_cidr_to_range(to_ipv6('2001:db8::1'), 64);
+-------------------------------------------------------------+
| ipv6_cidr_to_range(to_ipv6('2001:db8::1'), 64)              |
+-------------------------------------------------------------+
| {"min":"2001:db8::", "max":"2001:db8::ffff:ffff:ffff:ffff"} |
+-------------------------------------------------------------+

计算 /48 网段的地址范围。

SELECT ipv6_cidr_to_range(to_ipv6('2001:db8:1::1'), 48);
+---------------------------------------------------------------------+
| ipv6_cidr_to_range(to_ipv6('2001:db8:1::1'), 48)                    |
+---------------------------------------------------------------------+
| {"min":"2001:db8:1::", "max":"2001:db8:1:ffff:ffff:ffff:ffff:ffff"} |
+---------------------------------------------------------------------+

访问结构体中的具体字段。

SELECT 
    struct_element(ipv6_cidr_to_range(to_ipv6('2001:db8::1'), 64), "min") as min_ip, 
    struct_element(ipv6_cidr_to_range(to_ipv6('2001:db8::1'), 64), "max") as max_ip;
+------------+-------------------------------+
| min_ip     | max_ip                        |
+------------+-------------------------------+
| 2001:db8:: | 2001:db8::ffff:ffff:ffff:ffff |
+------------+-------------------------------+

参数为 NULL， 返回NULL

SELECT ipv6_cidr_to_range(to_ipv6('2001:db8::1'), NULL);
+--------------------------------------------------+
| ipv6_cidr_to_range(to_ipv6('2001:db8::1'), NULL) |
+--------------------------------------------------+
| NULL                                             |
+--------------------------------------------------+

SELECT ipv6_cidr_to_range(NULL, 48);
+------------------------------+
| ipv6_cidr_to_range(NULL, 48) |
+------------------------------+
| NULL                         |
+------------------------------+

CIDR 前缀超出范围会抛出异常。

SELECT ipv6_cidr_to_range(to_ipv6('2001:db8::1'), 129);
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Illegal cidr value '129'

Keywords​

IPV6_CIDR_TO_RANGE