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

Apache Doris 中文参考:IPV6_STRING_TO_NUM_OR_DEFAULT

· 52CE 我爱测

返回值含义: - 返回 IPv6 的 16 字节二进制编码 - 输入 NULL 返回全 0 的 16 字节二进制 - 非法 IP 地址返回全 0 的 16 字节二进制(不抛异常) - 若输入为有效 IPv4 文本,返回等效的 IPv6 地址( )

ipv6_string_to_num_or_default

描述

IPv6NumToString 的反向函数,它接受一个 IP 地址字符串并返回二进制格式的 IPv6 地址。

语法

IPV6_STRING_TO_NUM_OR_DEFAULT(<ipv6_string>)

参数

  • <ipv6_string>:字符串类型的 IPv6 地址

返回值

返回类型:VARCHAR(长度 16 的二进制)

返回值含义:

  • 返回 IPv6 的 16 字节二进制编码
  • 输入 NULL 返回全 0 的 16 字节二进制
  • 非法 IP 地址返回全 0 的 16 字节二进制(不抛异常)
  • 若输入为有效 IPv4 文本,返回等效的 IPv6 地址(::ffff:<ipv4>)

使用说明

  • 该函数不会抛出异常,非法输入统一返回 16 个 0 的二进制
  • 支持 IPv6 文本缩写;IPv4 文本会被映射为 IPv6 表示
  • 适用于容错型批量转换

举例

将 IPv6 文本 1111::ffff 转为 16 字节二进制(用 hex 展示)。

select hex(ipv6_string_to_num_or_default('1111::ffff')) as v6;
+----------------------------------+
| v6                               |
+----------------------------------+
| 1111000000000000000000000000FFFF |
+----------------------------------+

IPv4 文本会自动映射为 IPv6(::ffff:<ipv4>),再以 16 字节二进制返回。

select hex(ipv6_string_to_num_or_default('192.168.0.1')) as mapped;
+----------------------------------+
| mapped                           |
+----------------------------------+
| 00000000000000000000FFFFC0A80001 |
+----------------------------------+

参数为 NULL 返回全 0 的 16 字节二进制

select hex(ipv6_string_to_num_or_default(NULL)) as null_result;
+----------------------------------+
| null_result                      |
+----------------------------------+
| 00000000000000000000000000000000 |
+----------------------------------+

非法输入返回全 0 的 16 字节二进制(不抛异常)。

select hex(ipv6_string_to_num_or_default('notaaddress')) as invalid;
+----------------------------------+
| invalid                          |
+----------------------------------+
| 00000000000000000000000000000000 |
+----------------------------------+

Keywords

IPV6_STRING_TO_NUM_OR_DEFAULT

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

资料来源与适用范围

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

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

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