MaxCompute:NET_IP_FROM_STRING

構文

BINARY NET_IP_FROM_STRING (STRING <str>)

パラメーター

str: 必須。変換する IPv4 または IPv6 アドレスを表す STRING 型の値。サポートされているフォーマットは次のとおりです。

• IPv4: ドット 10 進表記。例: 10.1.x.x。

• IPv6: コロン区切りフォーマット。例: 1234:5678:90ab:cdef:1234:5678:90ab:cdef。詳細については、「IP Version 6 Addressing Architecture」をご参照ください。

戻り値

この関数は、BINARY 型の IP アドレスを返します。次のルールが適用されます。

• 入力パラメーターが NULL の場合、関数は NULL を返します。

• 入力パラメーターが無効な場合、エラーが報告されます。

  説明

  odps.sql.udf.strict.mode パラメーターが false に設定されている場合、システムは無効な入力パラメーターに対して例外をスローする代わりに NULL を返します。

例

-- 0123 を返します
SELECT NET_IP_FROM_STRING('48.49.50.51');

-- =00=00=00=00=00=00=00=00=00=00=00=00=00=00=00=01 を返します
SELECT NET_IP_FROM_STRING('::1');

-- 0123456789@ABCDE を返します
SELECT NET_IP_FROM_STRING('3031:3233:3435:3637:3839:4041:4243:4445');

-- =00=00=00=00=00=00=00=00=00=00=FF=FF=C0=00=02=80 を返します
SELECT NET_IP_FROM_STRING('::ffff:192.0.2.128');

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

-- エラーが返されます。FAILED: ODPS-0130071:[0,0] Semantic analysis exception - physical plan generation failed: ODPS-0121095:Invalid argument - Invalid IP address: ::wxyz
SELECT NET_IP_FROM_STRING('::wxyz');

関連関数

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