try_ip_host-Funktion

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

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

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. CIDR-Notation ist nicht zulässig.

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