funktion 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.

Syntax

ip_host ( ip )

Arguments

  • ip: Ett STRING eller BINARY -värde som representerar en giltig 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.

Feltillstånd

  • Om indata inte är en giltig IPv4- eller IPv6-adress returnerar funktionen INVALID_IP_ADDRESS.

Examples

> SELECT ip_host('192.168.1.5');
  192.168.1.5

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

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

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

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

> SELECT ip_host(NULL);
  NULL

> SELECT ip_host('invalid.ip');
  Error: INVALID_IP_ADDRESS