Todos os produtos
Search
Central de documentação

MaxCompute:NET_IP_TO_STRING

Última atualização: Sep 17, 2026

A função NET_IP_TO_STRING converte um endereço IPv4 ou IPv6 do formato BINARY para o formato STRING.

Sintaxe

STRING NET_IP_TO_STRING(BINARY <addr>)

Parâmetros

addr: Obrigatório. Endereço IPv4 ou IPv6 a ser convertido, especificado como valor BINARY.

Valor de retorno

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

  • Se addr tiver 4 bytes, a função retornará o endereço IPv4 correspondente como valor STRING.

  • Se addr tiver 16 bytes, a função retornará o endereço IPv6 correspondente como valor STRING.

  • Se addr não for um valor BINARY que represente um endereço IPv4 ou IPv6, a função retornará um erro.

  • Se addr for NULL, a função retornará NULL.

Exemplos

-- Returns the IPv4 address 255.255.255.0
SELECT NET_IP_TO_STRING(NET_IP_NET_MASK(4, 24));

-- Returns the IPv6 address ::ffff:192.0.2.128
SELECT NET_IP_TO_STRING(CAST(unhex('00000000000000000000FFFFC0000280') AS BINARY));

-- Returns NULL 
SELECT NET_IP_TO_STRING(NULL);

Funções relacionadas

NET_IP_TO_STRING é uma função de rede. Para obter mais informações sobre funções de rede, consulte Network Functions Overview.