全部產品
Search
文件中心

MaxCompute:NET_IP_TO_STRING

更新時間:Aug 19, 2025

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

命令格式

STRING NET_IP_TO_STRING(BINARY <addr>)

參數說明

addr:必填。BINARY類型。待轉換的表示IPv4或IPv6地址的資料。

傳回值說明

返回STRING類型的IP地址。返回規則如下:

  • 若輸入addr為4位元組,則將IPv4地址作為STRING返回。

  • 若輸入addr為16位元組,則將IPv6地址作為STRNG返回。

  • 若輸入addr非BINARY類型的IPv4或 IPv6 地址時,則返回報錯。

  • 若輸入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函數屬於網路函數,更多網路相關函數請參見網路函數