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

Apache Doris 中文参考:IPV6_STRING_TO_NUM

· 52CE 我爱测

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

ipv6_string_to_num

描述

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

语法

IPV6_STRING_TO_NUM(<ipv6_string>)

参数

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

返回值

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

返回值含义:

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

使用说明

  • 支持标准 IPv6 文本(含缩写与 :: 省略形式)
  • 如果输入为有效 IPv4 文本,则转换并返回 IPv6 的 IPv4-Mapped 表示
  • 不支持 CIDR、端口、方括号等扩展形式

举例

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

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

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

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

输入 NULL 会抛出异常

select hex(ipv6_string_to_num(NULL));
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Null Input, you may consider convert it to a valid default IPv6 value like '::' first

非法输入会抛出异常。

select hex(ipv6_string_to_num('notaaddress'));
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Invalid IPv6 value

Keywords

IPV6_STRING_TO_NUM

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

资料来源与适用范围

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

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

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