TO_IPV4_OR_NULL

to_ipv4_or_null

説明

IPv4アドレスの文字列形式を受け取り、IPv4型の値を返します。無効な入力またはNULL入力の場合、NULLを返します。

構文

TO_IPV4_OR_NULL(<ipv4_str>)

パラメータ

• <ipv4_str>: 文字列型のIPv4アドレス

戻り値

戻り値の型: IPv4

戻り値の意味:

• IPv4型の値を返します。そのバイナリ形式はipv4_string_to_numの戻り値と等価です
• 入力がNULLまたは無効なIPv4アドレスの場合、NULLを返します

使用上の注意

• to_ipv4_or_null → IPv4型と等価で、IPv4カラムでTableを作成するシナリオに適しています
• 無効な入力に対して例外をスローせず、代わりにNULLを返します

例

IPv4テキスト255.255.255.255をIPv4型に変換します。

SELECT to_ipv4_or_null('255.255.255.255') as v4;
+-----------------+
| v4              |
+-----------------+
| 255.255.255.255 |
+-----------------+

入力がNULLの場合、NULLを返します。

SELECT to_ipv4_or_null(NULL) as v4;
+------+
| v4   |
+------+
| NULL |
+------+

無効なIPv4テキストはNULLを返します。

SELECT to_ipv4_or_null('256.1.1.1') as v4;
+------+
| v4   |
+------+
| NULL |
+------+

Keywords

TO_IPV4_OR_NULL