MaxCompute:NET_IP_FROM_STRING

Syntaxe

BINARY NET_IP_FROM_STRING (STRING <str>)

Paramètres

str : Obligatoire. Valeur de type STRING représentant l'adresse IPv4 ou IPv6 à convertir. Les formats pris en charge sont les suivants :

• IPv4 : notation décimale pointée. Par exemple, 10.1.x.x.

• IPv6 : format séparé par des deux-points. Par exemple, 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Pour plus d'informations, consultez IP Version 6 Addressing Architecture.

Valeur renvoyée

Cette fonction renvoie une adresse IP de type BINARY. Les règles suivantes s'appliquent :

• Si le paramètre d'entrée est NULL, la fonction renvoie NULL.

• Si le paramètre d'entrée n'est pas valide, une erreur se produit.

  Remarque

  Si le paramètre odps.sql.udf.strict.mode est défini sur false, le système renvoie NULL au lieu de lever une exception pour un paramètre d'entrée non valide.

Exemples

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

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

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

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

--Returns NULL
SELECT NET_IP_FROM_STRING(NULL);

-- An error is returned. 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

NET_IP_FROM_STRING est une fonction réseau. Pour plus d'informations sur toutes les fonctions réseau, consultez Network Functions Overview.