funktion try_ip_host

Gäller för:check markerat ja Databricks Runtime 18.2 och senare

Important

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

Returnerar den kanoniska representationen av en IPv4- eller IPv6-adress. Returnerar NULL i stället för att generera ett fel om indata är ogiltiga.

Syntax

try_ip_host ( ip )

Arguments

  • ip: Ett STRING eller BINARY -värde som representerar en IPv4- eller IPv6-adress. CIDR-notation tillåts inte.

Returns

Samma typ som indata (STRING eller BINARY), som representerar den kanoniska formen av adressen.

Funktionen returnerar NULL om indata är NULL eller ogiltiga.

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