NET_SAFE_IP_FROM_STRING - MaxCompute

Fungsi NET_SAFE_IP_FROM_STRING mengonversi representasi string dari alamat IPv4 atau IPv6 ke format biner.

Catatan

Fungsi ini mirip dengan NET_IP_FROM_STRING, tetapi mengembalikan NULL jika parameter input tidak valid, alih-alih memunculkan kesalahan.

Sintaksis

BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)

Parameter

str: Wajib. String yang mewakili alamat IPv4 atau IPv6 untuk dikonversi. Format yang didukung adalah sebagai berikut:

IPv4: Format dotted-quad. Contohnya, 10.1.x.x.
IPv6: Format dipisahkan titik dua. Contohnya, 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Untuk lebih banyak contoh, lihat Arsitektur Pengalamatan IP Versi 6.

Catatan

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

Nilai kembali

Mengembalikan alamat IP tipe BINARY.

Jika parameter input adalah NULL, fungsi mengembalikan NULL.
Jika parameter input tidak valid, fungsi mengembalikan NULL.

Contoh

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

-- Mengembalikan =00=00=00=00=00=00=00=00=00=00=00=00=00=00=00=1
SELECT NET_SAFE_IP_FROM_STRING('::1');

-- Mengembalikan 0123456789@ABCDE
SELECT NET_SAFE_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_SAFE_IP_FROM_STRING('::ffff:192.0.2.128');

-- Mengembalikan NULL
SELECT NET_SAFE_IP_FROM_STRING(NULL);
 
-- Mengembalikan NULL
SELECT NET_SAFE_IP_FROM_STRING('123.456');

-- Mengembalikan NULL
SELECT NET_SAFE_IP_FROM_STRING('::wxyz');

Fungsi terkait

Fungsi NET_SAFE_IP_FROM_STRING termasuk dalam kategori fungsi jaringan. Untuk informasi lebih lanjut tentang fungsi jaringan, lihat Fungsi Jaringan.