try_ip_host-Funktion

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

Gibt die kanonische Darstellung einer IPv4- oder IPv6-Adresse zurück. Gibt einen NULL Fehler zurück, anstatt einen Fehler zu auslösen, wenn die Eingabe ungültig ist.

Syntax

try_ip_host ( ip )

Argumente

• ip: Ein STRING oder ein Wert, der eine 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 ungültig ist NULL .

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

Verwandte Funktionen

• ip_host Funktion
• try_ip_cidr Funktion