大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:IS_IPV4_COMPAT

· 52CE 我爱测

## is_ipv4_compat ## 描述 检查 IPv6 地址是否为 IPv4 兼容地址。IPv4 兼容地址是一种特殊的 IPv6 地址格式,用于在 IPv6 网络中表示 IPv4 地址。 ## 语法 ### 参数 - :IPv6 地址的二进制表示(VARCHAR 类型,16 字节) ### 返回值 返回类型:BOOLEAN 返回值含义:1 表示是 IPv4 兼容地址,0 表示不是 IPv4 兼容地址 ### 使用说明 - IPv

is_ipv4_compat

描述

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

语法

IS_IPV4_COMPAT(<ipv6_address>)

参数

  • <ipv6_address>:IPv6 地址的二进制表示(VARCHAR 类型,16 字节)

返回值

返回类型:BOOLEAN

返回值含义: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

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。