ip_host-Funktion

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Gibt die kanonische Darstellung einer IPv4- oder IPv6-Adresse zurück.

Syntax

ip_host ( ip )

Arguments

  • ip: Ein STRING oder ein Wert, der eine gültige IPv4- BINARY oder IPv6-Adresse darstellt.

Returns

Derselbe Typ wie die Eingabe (STRING oder BINARY), die die kanonische Form der Adresse darstellt.

Die Funktion gibt zurück NULL , wenn die Eingabe lautet NULL.

Fehlerbedingungen

  • Wenn die Eingabe keine gültige IPv4- oder IPv6-Adresse ist, gibt die Funktion INVALID_IP_ADDRESS zurück.

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