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

IPV6_STRING_TO_NUM

ipv6_string_to_num​

デスクリプション​

IPv6NumToStringの逆関数で、IPアドレス文字列を受け取り、IPv6アドレスをバイナリ形式で返します。

Syntax​

IPV6_STRING_TO_NUM(<ipv6_string>)

パラメータ​

  • <ipv6_string>: 文字列型のIPv6アドレス

戻り値​

戻り値の型: VARCHAR（16バイトバイナリ）

戻り値の意味:

  • IPv6の16バイトバイナリエンコーディングを返す
  • 入力がNULLの場合、例外をスローする
  • 無効なIPアドレスまたはNULL入力の場合、例外をスローする
  • 入力が有効なIPv4テキストの場合、等価なIPv6アドレス（::ffff:<ipv4>）を返す

使用上の注意​

  • 標準的なIPv6テキスト（省略形や::省略形を含む）をサポートする
  • 入力が有効なIPv4テキストの場合、IPv6のIPv4-Mapped表現に変換して返す
  • CIDR、ポート、角括弧などの拡張形式はサポートしない

例​

IPv6テキスト1111::ffffを16バイトバイナリに変換（16進数で表示）。

select hex(ipv6_string_to_num('1111::ffff')) as v6;
+----------------------------------+
| v6                               |
+----------------------------------+
| 1111000000000000000000000000FFFF |
+----------------------------------+

IPv4テキストは自動的にIPv6（::ffff:<ipv4>）にマッピングされ、16バイトのバイナリとして返されます。

select hex(ipv6_string_to_num('192.168.0.1')) as mapped;
+----------------------------------+
| mapped                           |
+----------------------------------+
| 00000000000000000000FFFFC0A80001 |
+----------------------------------+

入力がNULLの場合、例外がスローされます

select hex(ipv6_string_to_num(NULL));
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Null Input, you may consider convert it to a valid default IPv6 value like '::' first

無効な入力は例外をスローします。

select hex(ipv6_string_to_num('notaaddress'));
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Invalid IPv6 value

Keywords​

IPV6_STRING_TO_NUM