IS_IPV4_COMPAT

is_ipv4_compat

描述

检查 IPv6 地址是否为 IPv4 兼容地址。IPv4 兼容地址是一种特殊的 IPv6 地址格式，用于在 IPv6 网络中表示 IPv4 地址。

语法

IS_IPV4_COMPAT(<ipv6_address>)

参数

• <ipv6_address>：IPv6 地址的二进制表示（VARCHAR 类型，16 字节）

返回值

返回类型：TINYINT

返回值含义：1 表示是 IPv4 兼容地址，0 表示不是 IPv4 兼容地址

使用说明

• IPv4 兼容地址的格式为 ::IPv4，即前 12 个字节为 0，后 4 个字节包含 IPv4 地址
• 输入必须是 16 字节的 IPv6 二进制数据
• 这种格式在 RFC 4291 中定义，用于 IPv6 过渡期
• 最后4个字节不能为0，所以 ::0.0.0.0 不是有效的 IPv4 兼容地址，0.0.0.0 不是 IPv4 unicast address，不满足 RFC 4291 IPv4-Mapped IPv6 Address 的 定义
• 输入参数为 NULL 时返回 NULL

举例

检查 IPv4 兼容地址。

SELECT is_ipv4_compat(INET6_ATON('::192.168.1.1')) as is_compat;
+-----------+
| is_compat |
+-----------+
| 1         |
+-----------+

检查非 IPv4 兼容地址。

SELECT 
  is_ipv4_compat(INET6_ATON('2001:db8::1')) as standard_ipv6,
  is_ipv4_compat(INET6_ATON('::ffff:192.168.1.1')) as ipv4_mapped,
  is_ipv4_compat(INET6_ATON('::0.0.0.0')) as zero_ip;
+--------------+------------+---------+
| standard_ipv6| ipv4_mapped| zero_ip |
+--------------+------------+---------+
| 0            | 0          | 0       |
+--------------+------------+---------+

检查边界值。

SELECT 
  is_ipv4_compat(INET6_ATON('::0.0.0.0')) as min_ip,
  is_ipv4_compat(INET6_ATON('::255.255.255.255')) as max_ip;
+--------+--------+
| min_ip | max_ip |
+--------+--------+
| 0      | 1      |
+--------+--------+

输入参数为 NULL 返回 NULL。

SELECT is_ipv4_compat(NULL) as null_result;
+-------------+
| null_result |
+-------------+
| NULL        |
+-------------+

Keywords

IS_IPV4_COMPAT