全部產品
Search
文件中心

MaxCompute:NET_IPV4_TO_INT64

更新時間:Aug 19, 2025

NET_IPV4_TO_INT64函數用於將IPv4地址從二進位BINARY格式轉換為整數BIGINT格式。

命令格式

BIGINT NET_IPV4_TO_INT64(BINARY <addr>)

參數說明

addr:必填。BINARY類型。待轉換的表示IPv4地址的資料。NET_IPV4_TO_INT64函數不支援處理 IPv6 地址。

傳回值說明

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

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

  • 若輸入addr值為NULL時,則返回NULL。

說明

在整數輸出中,IP地址的最低有效位儲存在整數的最低有效位元中。例如,1表示0.0.0.1;511表示0.0.1.255。輸出在[0,4294967295]範圍內。

使用樣本

  • 樣本一:與NET_SAFE_IP_FROM_STRING函數一起使用,該函數先將字串STRING格式的IPv4地址轉換為二進位BINARY格式,再通過NET_IPV4_TO_INT64函數轉換為BIGINT類型。

    -- 返回 808530483
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('48.49.50.51'));
    
    -- 返回 1
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.0.1'));
    
    -- 返回 511
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.1.255'));
  • 樣本二:若輸入值為NULL時,則返回NULL。

    -- 返回 NULL
    SELECT NET_IPV4_TO_INT64(NULL);

相關函數

NET_IPV4_TO_INT64函數屬於網路函數,更多網路相關函數請參見網路函數