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

TO_IPV4_OR_DEFAULT

to_ipv4_or_default​

説明​

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

構文​

TO_IPV4_OR_DEFAULT(<ipv4_str>)

パラメータ​

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

戻り値​

戻り値の型: IPv4

戻り値の意味:

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

使用上の注意​

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

例​

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

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

入力がNULLの場合、デフォルト値0.0.0.0が返されます。

SELECT to_ipv4_or_default(NULL) as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

無効なIPv4テキストはデフォルト値 0.0.0.0 を返します。

SELECT to_ipv4_or_default('256.1.1.1') as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

Keywords​

TO_IPV4_OR_DEFAULT