TO_IPV6_OR_NULL

to_ipv6_or_null

描述

输入 IPv6 地址的字符串形式，并返回 IPv6 类型的值。对于无效输入或 NULL 输入，返回 NULL。

语法

TO_IPV6_OR_NULL(<ipv6_str>)

参数

• <ipv6_str>：字符串类型的 IPv6 地址

返回值

返回类型：IPv6 (Nullable)

返回值含义：

• 返回 IPv6 类型值，其二进制形式等同于 ipv6_string_to_num 函数返回值的二进制形式
• 输入 NULL 或非法 IPv6 地址时返回 NULL

使用说明

• 等价于 to_ipv6_or_null → IPv6 类型，适合建表为 IPv6 列的场景
• 对于无效输入不会抛出异常，而是返回 NULL

举例

将 IPv6 文本 2001:1b70:a1:610::b102:2 转为 IPv6 类型。

SELECT to_ipv6_or_null('2001:1b70:a1:610::b102:2') as v6;
+-------------------------------+
| v6                            |
+-------------------------------+
| 2001:1b70:a1:610::b102:2      |
+-------------------------------+

输入 NULL 返回 NULL。

SELECT to_ipv6_or_null(NULL) as v6;
+------+
| v6   |
+------+
| NULL |
+------+

非法 IPv6 文本返回 NULL。

SELECT to_ipv6_or_null('not-an-ip') as v6;
+------+
| v6   |
+------+
| NULL |
+------+

Keywords

TO_IPV6_OR_NULL