全部产品
Search
文档中心

MaxCompute:NET_IPV4_TO_INT64

更新时间:Oct 23, 2025

Fungsi NET_IPV4_TO_INT64 mengonversi alamat IPv4 dalam format biner menjadi nilai BIGINT.

Sintaksis

BIGINT NET_IPV4_TO_INT64(BINARY <addr>)

Parameter

addr: Wajib. Alamat IPv4 dengan tipe data BINARY. Fungsi ini tidak mendukung alamat IPv6.

Nilai pengembalian

Mengembalikan nilai BIGINT yang merepresentasikan alamat IP. Aturan berikut berlaku:

  • Jika input addr bukan alamat IPv4 yang valid dalam format BINARY, fungsi mengembalikan kesalahan.

  • Jika input addr adalah NULL, fungsi mengembalikan NULL.

Catatan

Bit paling tidak signifikan dari alamat IP disimpan sebagai bit paling tidak signifikan dari bilangan bulat yang dikembalikan. Sebagai contoh, 1 merepresentasikan 0.0.0.1, dan 511 merepresentasikan 0.0.1.255. Output berada dalam rentang [0, 4.294.967.295].

Contoh

  • Contoh 1: Gunakan fungsi ini bersama dengan fungsi NET_SAFE_IP_FROM_STRING. Fungsi NET_SAFE_IP_FROM_STRING mengonversi alamat IPv4 dari format STRING ke format BINARY. Kemudian, fungsi NET_IPV4_TO_INT64 mengonversi hasil biner menjadi nilai BIGINT.

    -- Mengembalikan 808530483
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('48.49.50.51'));
    
    -- Mengembalikan 1
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.0.1'));
    
    -- Mengembalikan 511
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.1.255'));
  • Contoh 2: Jika nilai input adalah NULL, fungsi mengembalikan NULL.

    -- Mengembalikan NULL
    SELECT NET_IPV4_TO_INT64(NULL);

Fungsi terkait

NET_IPV4_TO_INT64 adalah sebuah fungsi jaringan. Untuk informasi lebih lanjut tentang fungsi jaringan, lihat Fungsi Jaringan.