NET_SAFE_IP_FROM_STRING - MaxCompute - Centre de documentation Alibaba Cloud

La fonction NET_SAFE_IP_FROM_STRING convertit une adresse IPv4 ou IPv6 représentée sous forme de chaîne en format binaire.

Remarque

Cette fonction est similaire à la fonction NET_IP_FROM_STRING, mais elle renvoie NULL au lieu de générer une erreur si le paramètre d'entrée n'est pas valide.

Syntaxe

BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)

Paramètres

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

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

Remarque

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

Valeur de retour

Renvoie une adresse IP de type BINARY.

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

Exemples

-- Returns 0123  
SELECT NET_SAFE_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_SAFE_IP_FROM_STRING('::1');

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

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

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

Fonctions associées

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