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

Apache Doris 中文参考:IS_IPV4_MAPPED

· 52CE 我爱测

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

is_ipv4_mapped

描述

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

语法

IS_IPV4_MAPPED(<ipv6_address>)

参数

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

返回值

返回类型:BOOLEAN

返回值含义:1 表示是 IPv4 映射地址,0 表示不是 IPv4 映射地址

使用说明

  • IPv4 映射地址的格式为 ::ffff:IPv4,即前 10 个字节为 0,第 11-12 字节为 0xFFFF,后 4 个字节包含 IPv4 地址
  • 输入必须是 16 字节的 IPv6 二进制数据
  • 这种格式在 RFC 4291 中定义,是最常用的 IPv6 中表示 IPv4 地址的方式
  • 输入参数为 NULL 时返回 NULL

举例

检查 IPv4 映射地址。

SELECT is_ipv4_mapped(INET6_ATON('::ffff:192.168.1.1')) as is_mapped;
+-----------+
| is_mapped |
+-----------+
| 1         |
+-----------+

检查非 IPv4 映射地址。

SELECT 
  is_ipv4_mapped(INET6_ATON('2001:db8::1')) as standard_ipv6,
  is_ipv4_mapped(INET6_ATON('::192.168.1.1')) as ipv4_compat;
+--------------+------------+
| standard_ipv6| ipv4_compat|
+--------------+------------+
| 0            | 0          |
+--------------+------------+

检查边界值。

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

输入参数为 NULL 返回 0。

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

Keywords

IS_IPV4_MAPPED

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

资料来源与适用范围

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

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

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