メインコンテンツまでスキップ
バージョン: 26.x

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_defaultIPv6型と同等で、IPv6カラムでTableを作成するシナリオに適しています
  • 無効な入力に対して例外をスローせず、代わりにデフォルト値::を返します

IPv6テキスト2001:1b70:a1:610::b102:2IPv6型に変換します。

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