全部產品
Search
文件中心

MaxCompute:NET_IP_FROM_STRING

更新時間:Aug 19, 2025

NET_IP_FROM_STRING函數用於將IPv4或IPv6地址從字串STRING格式轉換為二進位BINARY格式。

命令格式

BINARY NET_IP_FROM_STRING (STRING <str>)

參數說明

str:必填,STRING類型。待轉換的表示IPv4或IPv6地址的字串,支援的格式如下:

  • IPv4:以點分四組格式。例如10.1.x.x

  • IPv6:以冒號分隔格式。例如1234:5678:90ab:cdef:1234:5678:90ab:cdef。更多樣本,請參見IP Version 6 Addressing Architecture

說明

該函數不支援CIDR標記法,例如10.1.x.x/xx

傳回值說明

返回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函數屬於網路函數,更多網路相關函數請參見網路函數