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

TO_IPV4

to_ipv4​

説明​

IPv4アドレスの文字列形式を受け取り、IPv4型の値を返します。

構文​

TO_IPV4(<ipv4_str>)

パラメータ​

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

戻り値​

戻り値の型: IPv4

戻り値の意味:

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

使用上の注意​

  • to_ipv4と同等 → IPv4型。IPv4カラムでTableを作成するシナリオに適しています

例​

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

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

入力がNULLの場合は例外をスローします

SELECT to_ipv4(NULL);
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]The arguments of function to_ipv4 must be String, not NULL

無効なIPv4テキストは例外をスローします。

SELECT to_ipv4('256.1.1.1');
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Invalid IPv4 value '256.1.1.1'

Keywords​

TO_IPV4