NET_IP_FROM_STRING - MaxCompute - Centre de documentation Alibaba Cloud

La fonction NET_IP_FROM_STRING convertit une adresse IPv4 ou IPv6 d'un format chaîne (STRING) en un format binaire (BINARY).

Syntaxe

BINARY NET_IP_FROM_STRING (STRING <str>)

Paramètres

str : Obligatoire. Type STRING. Chaîne représentant l'adresse IPv4 ou IPv6 à convertir. Les formats suivants sont pris en charge :

IPv4 : notation décimale pointée. Par exemple, 10.1.x.x.
IPv6 : notation hexadécimale séparée par des deux-points. Par exemple, 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Pour plus d'exemples, IP Version 6 Addressing Architecture.

Remarque

Cette fonction ne prend pas en charge la notation CIDR, telle que 10.1.x.x/xx.

Valeur renvoyée

Renvoie l'adresse IP au type BINARY. Règles de retour :

Si le paramètre d'entrée est NULL, renvoie NULL.
Si le paramètre d'entrée est invalide ou incorrect, renvoie une erreur.

Remarque
Si le paramètre odps.sql.udf.strict.mode est défini sur false, le système ne lève pas d'exception lorsque le paramètre d'entrée est invalide ou incorrect ; il renvoie NULL.

Exemples

--返回 0123  
SELECT NET_IP_FROM_STRING('48.49.50.51');

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

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

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

--返回 NULL
SELECT NET_IP_FROM_STRING(NULL);

-- 返回报错 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');

Fonctions associées

La fonction NET_IP_FROM_STRING fait partie des fonctions réseau. Pour plus d'informations sur les autres fonctions liées au réseau, Network Functions Overview.