NET_SAFE_IP_FROM_STRING - MaxCompute: Central de Documentação do Alibaba Cloud

A função NET_SAFE_IP_FROM_STRING converte a representação em string de um endereço IPv4 ou IPv6 para o formato binário.

Nota

Esta função é semelhante à NET_IP_FROM_STRING, mas retorna NULL em vez de gerar erro quando o parâmetro de entrada é inválido.

Sintaxe

BINARY NET_SAFE_IP_FROM_STRING(STRING <str>)

Parâmetros

str: Obrigatório. String que representa o endereço IPv4 ou IPv6 a converter. Formatos suportados:

IPv4: Formato dotted-quad. Exemplo: 10.1.x.x.
IPv6: Formato separado por dois pontos. Exemplo: 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Para mais exemplos, consulte IP Version 6 Addressing Architecture.

Nota

Esta função não suporta notação CIDR, como 10.1.x.x/xx.

Valor de retorno

Retorna um endereço IP do tipo BINARY.

Se o parâmetro de entrada for NULL, a função retorna NULL.
Se o parâmetro de entrada for inválido, a função retorna NULL.

Exemplos

-- 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');

Funções relacionadas

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