Tous les produits
Search
Centre de documentation

MaxCompute:NET_IPV4_TO_INT64

Dernière mise à jour :Sep 21, 2026

La fonction NET_IPV4_TO_INT64 convertit une adresse IPv4 au format binaire en une valeur BIGINT.

Syntaxe

BIGINT NET_IPV4_TO_INT64(BINARY <addr>)

Paramètres

addr : Obligatoire. Adresse IPv4 de type de données BINARY. Cette fonction ne prend pas en charge les adresses IPv6.

Valeur renvoyée

Renvoie une valeur BIGINT qui représente l'adresse IP. Les règles suivantes s'appliquent :

  • Si le paramètre d'entrée addr n'est pas une adresse IPv4 valide au format BINARY, la fonction renvoie une erreur.

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

Remarque

Les bits de poids faible de l'adresse IP sont stockés comme les bits de poids faible de l'entier renvoyé. Par exemple, 1 représente 0.0.0.1 et 511 représente 0.0.1.255. La sortie se situe dans la plage [0, 4294967295].

Exemples

  • Exemple 1 : Utilisez cette fonction avec la fonction NET_SAFE_IP_FROM_STRING. La fonction NET_SAFE_IP_FROM_STRING convertit une adresse IPv4 du format STRING au format BINARY. Ensuite, la fonction NET_IPV4_TO_INT64 convertit le résultat binaire en une valeur BIGINT.

    -- Returns 808530483
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('48.49.50.51'));
    
    -- Returns 1
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.0.1'));
    
    -- Returns 511
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.1.255'));
  • Exemple 2 : Si la valeur d'entrée est NULL, la fonction renvoie NULL.

    -- Returns NULL
    SELECT NET_IPV4_TO_INT64(NULL);

Fonctions associées

NET_IPV4_TO_INT64 est une fonction réseau. Pour plus d'informations sur les fonctions réseau, consultez la page Fonctions réseau.