try_ip_as_string-Funktion

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

Gibt die kanonische Zeichenfolgendarstellung einer IP-Adresse oder eines CIDR-Blocks zurück. Gibt einen NULL Fehler zurück, anstatt einen Fehler zu auslösen, wenn die Eingabe ungültig ist.

Syntax

try_ip_as_string ( ip_or_cidr )

Argumente

• ip_or_cidr: Ein STRING Oder BINARY Wert, der einen IPv4- oder IPv6-Adress- oder CIDR-Block darstellt.

Returns

Eine STRING Darstellung der kanonischen Zeichenfolgenform des IP-Adress- oder CIDR-Blocks. Bei BINARY Eingaben wird die binäre Darstellung in das entsprechende Zeichenfolgenformular konvertiert.

Die Funktion gibt zurück NULL , wenn die Eingabe ungültig ist NULL .

Examples

> SELECT try_ip_as_string('192.168.1.1');
  192.168.1.1

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

> SELECT try_ip_as_string('192.168.1.5/24');
  192.168.1.0/24

> SELECT try_ip_as_string(X'C0A80101');
  192.168.1.1

> SELECT try_ip_as_string(X'20010DB8000000000000000000000001');
  2001:db8::1

> SELECT try_ip_as_string('invalid');
  NULL

> SELECT try_ip_as_string(X'');
  NULL

> SELECT try_ip_as_string(NULL);
  NULL

Verwandte Funktionen

• ip_as_string Funktion
• try_ip_as_binary Funktion