Tous les produits
Search
Centre de documentation

MaxCompute:NET_IPV4_TO_INT64

Dernière mise à jour :Aug 10, 2026

La fonction NET_IPV4_TO_INT64 convertit une adresse IPv4 du format binaire BINARY au format entier BIGINT.

Syntaxe

BIGINT NET_IPV4_TO_INT64(BINARY <addr>)

Paramètres

addr : obligatoire. Type BINARY. Données représentant l'adresse IPv4 à convertir. La fonction NET_IPV4_TO_INT64 ne prend pas en charge les adresses IPv6.

Valeur de retour

Renvoie l'adresse IP sous forme de type BIGINT. Règles de renvoi :

  • Si la valeur d'entrée addr n'est pas une adresse IPv4 de type BINARY, une erreur est renvoyée.

  • Si la valeur d'entrée addr est NULL, la fonction renvoie NULL.

Remarque

Dans la sortie entière, les bits de poids faible de l'adresse IP sont stockés dans les bits de poids faible de l'entier. Par exemple, 1 correspond à 0.0.0.1 et 511 à 0.0.1.255. La plage de sortie est [0, 4294967295].

Exemples

  • Exemple 1 : Utilisez cette fonction conjointement avec la fonction NET_SAFE_IP_FROM_STRING. Cette dernière convertit d'abord une adresse IPv4 du format chaîne STRING vers le format binaire BINARY, puis NET_IPV4_TO_INT64 la transforme en type BIGINT.

    -- 返回 808530483
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('48.49.50.51'));
    
    -- 返回 1
    SELECT NET_IPV4_TO_INT64(NET_SAFE_IP_FROM_STRING('0.0.0.1'));
    
    -- 返回 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, le résultat renvoyé est NULL.

    -- 返回 NULL
    SELECT NET_IPV4_TO_INT64(NULL);

Fonctions associées

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