Todos os produtos
Search
Central de documentação

MaxCompute:NET_IPV4_TO_INT64

Última atualização: Sep 21, 2026

A função NET_IPV4_TO_INT64 converte um endereço IPv4 em formato binário para um valor BIGINT.

Sintaxe

BIGINT NET_IPV4_TO_INT64(BINARY <addr>)

Parâmetros

addr: Obrigatório. Um endereço IPv4 do tipo de dados BINARY. Esta função não é compatível com endereços IPv6.

Valor de retorno

Retorna um valor BIGINT que representa o endereço IP. Aplicam-se as seguintes regras:

  • Se o valor de entrada addr não for um endereço IPv4 válido no formato BINARY, a função retorna um erro.

  • Se o valor de entrada addr for NULL, a função retorna NULL.

Nota

A função armazena os bits menos significativos do endereço IP como os bits menos significativos do inteiro retornado. Por exemplo, 1 representa 0.0.0.1, e 511 representa 0.0.1.255. O resultado está no intervalo de [0, 4294967295].

Exemplos

  • Exemplo 1: Use esta função com a NET_SAFE_IP_FROM_STRING. A NET_SAFE_IP_FROM_STRING converte um endereço IPv4 do formato STRING para o formato BINARY e, em seguida, a NET_IPV4_TO_INT64 converte o resultado binário em um valor 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'));
  • Exemplo 2: Se o valor de entrada for NULL, a função retorna NULL.

    -- Returns NULL
    SELECT NET_IPV4_TO_INT64(NULL);

Funções relacionadas

A NET_IPV4_TO_INT64 é uma função de rede. Para obter mais informações sobre funções de rede, consulte Network functions.