try_ip_host Função

Aplica-se a:check marked yes Databricks Runtime 18.2 e superior

Important

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

Retorna a representação canônica de um endereço IPv4 ou IPv6. Retorna NULL em vez de gerar um erro se a entrada for inválida.

Syntax

try_ip_host ( ip )

Argumentos

  • ip: A STRING ou BINARY valor que representa um endereço IPv4 ou IPv6. A notação CIDR não é permitida.

Returns

O mesmo tipo que a entrada (STRING ou BINARY), que representa a forma canônica do endereço.

A função retornará NULL se a entrada for NULL ou inválida.

Examples

> SELECT try_ip_host('192.168.1.5');
  192.168.1.5

> SELECT try_ip_host('2001:0db8:0000:0000:0000:0000:0000:0001');
  2001:db8::1

> SELECT try_ip_host('2001:DB8::1');
  2001:db8::1

> SELECT try_ip_host('::ffff:192.0.2.128');
  ::ffff:192.0.2.128

> SELECT hex(try_ip_host(X'C0A80101'));
  C0A80101

> SELECT try_ip_host('invalid');
  NULL

> SELECT try_ip_host(X'');
  NULL

> SELECT try_ip_host(NULL);
  NULL