TO_IPV6_OR_DEFAULT
to_ipv6_or_default
説明
IPv6アドレスの文字列形式を受け取り、IPv6型の値を返します。無効な入力またはNULL入力の場合、デフォルト値:: を返します。
構文
TO_IPV6_OR_DEFAULT(<ipv6_str>)
パラメータ
<ipv6_str>: 文字列型のIPv6アドレス
戻り値
戻り値の型: IPv6
戻り値の意味:
- IPv6型の値を返します。そのバイナリ形式は
ipv6_string_to_num関数の戻り値のバイナリ形式と同じです - 入力がNULLまたは無効なIPv6アドレスの場合は
::を返します
使用上の注意
to_ipv6_or_default→IPv6型と同等で、IPv6カラムでTableを作成するシナリオに適しています- 無効な入力に対して例外をスローせず、代わりにデフォルト値
::を返します
例
IPv6テキスト2001:1b70:a1:610::b102:2をIPv6型に変換します。
SELECT to_ipv6_or_default('2001:1b70:a1:610::b102:2') as v6;
+-------------------------------+
| v6 |
+-------------------------------+
| 2001:1b70:a1:610::b102:2 |
+-------------------------------+
Input NULLはデフォルト値``::`を返します。
SELECT to_ipv6_or_default(NULL) as v6;
+----+
| v6 |
+----+
| :: |
+----+
無効なIPv6テキストはデフォルト値``::`を返します。
SELECT to_ipv6_or_default('not-an-ip') as v6;
+----+
| v6 |
+----+
| :: |
+----+
Keywords
TO_IPV6_OR_DEFAULT