全部产品
Search
文档中心

MaxCompute:NET_IP_FROM_STRING

更新时间:Oct 23, 2025

Fungsi NET_IP_FROM_STRING mengonversi alamat IPv4 atau IPv6 dari format STRING ke format BINARY.

Sintaksis

BINARY NET_IP_FROM_STRING (STRING <str>)

Parameter

str: Diperlukan. Nilai tipe STRING yang mewakili alamat IPv4 atau IPv6 untuk dikonversi. Format yang didukung adalah sebagai berikut:

  • IPv4: Notasi desimal bertitik. Contohnya, 10.1.x.x.

  • IPv6: Format dipisahkan oleh titik dua. Contohnya, 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Untuk informasi lebih lanjut, lihat Arsitektur Pengalamatan IP Versi 6.

Catatan

Fungsi ini tidak mendukung notasi CIDR, seperti 10.1.x.x/xx.

Nilai pengembalian

Fungsi ini mengembalikan alamat IP dalam tipe BINARY. Aturan berikut berlaku:

  • Jika parameter input adalah NULL, fungsi mengembalikan NULL.

  • Jika parameter input tidak valid, kesalahan dilaporkan.

    Catatan

    Jika parameter odps.sql.udf.strict.mode disetel ke false, sistem mengembalikan NULL alih-alih memunculkan pengecualian untuk parameter input yang tidak valid.

Contoh

--Mengembalikan 0123  
SELECT NET_IP_FROM_STRING('48.49.50.51');

--Mengembalikan =00=00=00=00=00=00=00=00=00=00=00=00=00=00=00=01
SELECT NET_IP_FROM_STRING('::1');

--Mengembalikan 0123456789@ABCDE
SELECT NET_IP_FROM_STRING('3031:3233:3435:3637:3839:4041:4243:4445');

--Mengembalikan =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');

--Mengembalikan NULL
SELECT NET_IP_FROM_STRING(NULL);

-- Kesalahan dikembalikan. 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');

Fungsi terkait

NET_IP_FROM_STRING adalah fungsi jaringan. Untuk informasi lebih lanjut tentang semua fungsi jaringan, lihat Fungsi jaringan.