MaxCompute:NET_IP_FROM_STRING

Sintaxe

BINARY NET_IP_FROM_STRING (STRING <str>)

Parâmetros

str: Obrigatório. Valor do tipo STRING que representa o endereço IPv4 ou IPv6 a converter. Formatos compatíveis:

• IPv4: Notação decimal com pontos. Exemplo: 10.1.x.x.

• IPv6: Formato separado por dois-pontos. Exemplo: 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Para mais informações, consulte IP Version 6 Addressing Architecture.

Valor de retorno

A função retorna um endereço IP do tipo BINARY. Regras aplicáveis:

• Se o parâmetro de entrada for NULL, a função retornará NULL.

• Se o parâmetro de entrada for inválido, ocorrerá um erro.

  Nota

  Se o parâmetro odps.sql.udf.strict.mode estiver definido como false, o sistema retornará NULL em vez de gerar uma exceção para parâmetros de entrada inválidos.

Exemplos

--Returns 0123  
SELECT NET_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_IP_FROM_STRING('::1');

--Returns 0123456789@ABCDE
SELECT NET_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_IP_FROM_STRING('::ffff:192.0.2.128');

--Returns NULL
SELECT NET_IP_FROM_STRING(NULL);

-- An error is returned. FAILED: ODPS-0130071:[0,0] Semantic analysis exception - physical plan generation failed: ODPS-0121095:Invalid argument - Invalid IP address: ::wxyz
SELECT NET_IP_FROM_STRING('::wxyz');

Funções relacionadas

NET_IP_FROM_STRING é uma função de rede. Para obter detalhes sobre todas as funções de rede, consulte Network Functions Overview.