すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:NET_IP_TO_STRING

最終更新日:Oct 27, 2025

NET_IP_TO_STRING 関数は、BINARY フォーマットの IPv4 または IPv6 アドレスを STRING フォーマットに変換します。

構文

STRING NET_IP_TO_STRING(BINARY <addr>)

パラメーター

addr: 必須。変換する IPv4 または IPv6 アドレスで、BINARY 値として指定されます。

戻り値

IP アドレスを表す STRING 値を返します。次のルールが適用されます。

  • addr が 4 バイトの場合、関数は対応する IPv4 アドレスを STRING 値として返します。

  • addr が 16 バイトの場合、関数は対応する IPv6 アドレスを STRING 値として返します。

  • addr が IPv4 または IPv6 アドレスを表す BINARY 値でない場合、関数はエラーを返します。

  • addr が NULL の場合、関数は NULL を返します。

-- IPv4 アドレス 255.255.255.0 を返します
SELECT NET_IP_TO_STRING(NET_IP_NET_MASK(4, 24));

-- IPv6 アドレス ::ffff:192.0.2.128 を返します
SELECT NET_IP_TO_STRING(CAST(unhex('00000000000000000000FFFFC0000280') AS BINARY));

-- NULL を返します
SELECT NET_IP_TO_STRING(NULL);

関連関数

NET_IP_TO_STRING はネットワーク関数です。ネットワーク関数の詳細については、「ネットワーク関数」をご参照ください。