IS_IPV6_STRING
更新时间：2025-10-16
描述
接收一个表示形式为字符串的 IPv6 地址作为参数，如果为格式正确且合法的 IPv6 地址，返回 true；反之，返回 false。
语法
SQL
1IS_IPV6_STRING(<ipv6_str>)参数
| Parameter | Description |
|---|---|
<ipv6_str> |
字符串类型的 ipv6 地址 |
返回值
如果为格式正确且合法的 IPv6 地址，返回 1 (true)；反之，返回 0 (false)。
- 如果输入为 NULL, 则返回 NULL
举例
SQL
1CREATE TABLE `test_is_ipv6_string` (
2 `id` int,
3 `ip_v6` string
4 ) ENGINE=OLAP
5 DISTRIBUTED BY HASH(`id`) BUCKETS 4
6 PROPERTIES (
7 "replication_allocation" = "tag.location.default: 1"
8 );
9
10insert into test_is_ipv6_string values(0, NULL), (1, '::'), (2, ''), (3, '2001:1b70:a1:610::b102:2'), (4, 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffffg');
11
12select id, ip_v6, is_ipv6_string(ip_v6) from test_is_ipv6_string order by id;
Text
1+------+------------------------------------------+-----------------------+
2| id | ip_v6 | is_ipv6_string(ip_v6) |
3+------+------------------------------------------+-----------------------+
4| 0 | NULL | NULL |
5| 1 | :: | 1 |
6| 2 | | 0 |
7| 3 | 2001:1b70:a1:610::b102:2 | 1 |
8| 4 | ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffffg | 0 |
9+------+------------------------------------------+-----------------------+