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

CUT_IPV6

cut_ipv6​

説明​

IPv6アドレスのタイプ（IPv4マップドまたは純粋なIPv6）に基づいて、IPv6アドレスの末尾から指定されたバイト数を切り取り、切り詰められたIPv6アドレス文字列を返します。

構文​

CUT_IPV6(<ipv6_address>, <bytes_to_cut_for_ipv6>, <bytes_to_cut_for_ipv4>)

パラメータ​

  • <ipv6_address>: IPv6型のアドレス
  • <bytes_to_cut_for_ipv6>: 純粋なIPv6アドレスに対してカットするバイト数（TINYINT型）
  • <bytes_to_cut_for_ipv4>: IPv4マップアドレスに対してカットするバイト数（TINYINT型）

戻り値​

戻り値の型: VARCHAR

戻り値の意味:

  • 切り詰められたIPv6アドレス文字列を返す
  • 入力がIPv4マップアドレスの場合、bytes_to_cut_for_ipv4パラメータを使用する
  • 入力が純粋なIPv6アドレスの場合、bytes_to_cut_for_ipv6パラメータを使用する
  • 3つのパラメータ<ipv6_address>、<bytes_to_cut_for_ipv6>、<bytes_to_cut_for_ipv4>のいずれかがNULLの場合、NULLを返す

使用上の注意​

  • IPv6アドレスがIPv4マップアドレス（形式::ffff:IPv4）かどうかを自動的に検出する
  • アドレスの型に基づいて適切なカットバイト数を選択する
  • カット操作はアドレスの末尾から開始し、指定されたバイト数をゼロに設定する
  • パラメータの値は16を超えることはできない（IPv6アドレスの総バイト数）

例​

純粋なIPv6アドレスから末尾バイトをカットする。

SELECT cut_ipv6(to_ipv6('2001:db8::1'), 4, 4) as cut_result;
+------------------+
| cut_result       |
+------------------+
| 2001:db8::       |
+------------------+

IPv4マップドアドレスから末尾バイトを切り取ります。

SELECT cut_ipv6(to_ipv6('::ffff:192.168.1.1'), 4, 4) as cut_result;
+----------------+
| cut_result     |
+----------------+
| ::ffff:0.0.0.0 |
+----------------+

異なるカッティングパラメータを使用してください。

SELECT 
  cut_ipv6(to_ipv6('2001:db8::1'), 8, 4) as ipv6_cut_8,
  cut_ipv6(to_ipv6('::ffff:192.168.1.1'), 4, 8) as ipv4_cut_8;
+------------+------------+
| ipv6_cut_8 | ipv4_cut_8 |
+------------+------------+
| 2001:db8:: | ::         |
+------------+------------+

パラメータがNULLの場合、NULLを返します

select cut_ipv6(NULL, NULL, NULL);
+----------------------------+
| cut_ipv6(NULL, NULL, NULL) |
+----------------------------+
| NULL                       |
+----------------------------+

select cut_ipv6(to_ipv6("::"), NULL, 0);
+----------------------------------+
| cut_ipv6(to_ipv6("::"), NULL, 0) |
+----------------------------------+
| NULL                             |
+----------------------------------+

select cut_ipv6(to_ipv6("::"), 4, NULL);
+----------------------------------+
| cut_ipv6(to_ipv6("::"), 4, NULL) |
+----------------------------------+
| NULL                             |
+----------------------------------+

範囲外のパラメータ値は例外をスローします。

SELECT cut_ipv6(to_ipv6('2001:db8::1'), 17, 4);
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Illegal value for argument 2 TINYINT of function cut_ipv6

SELECT cut_ipv6(to_ipv6('2001:db8::1'), 4, 122);
ERROR 1105 (HY000): errCode = 2, detailMessage = (...)[INVALID_ARGUMENT]Illegal value for argument 3 TINYINT of function cut_ipv6

Keywords​

CUT_IPV6