try_ip_as_binary-Funktion

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

Gibt die kanonische binäre Darstellung 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_binary ( ip_or_cidr )

Argumente

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

Returns

A BINARY repräsentiert die kanonische Binärform der IP-Adresse oder des CIDR-Blocks. IPv4-Adressen werden als 4 Bytes, IPv6-Adressen als 16 Bytes dargestellt, und CIDR-Blöcke enthalten ein zusätzliches Byte für die Präfixlänge.

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

Examples

> SELECT hex(try_ip_as_binary('192.168.1.1'));
  C0A80101

> SELECT hex(try_ip_as_binary('192.168.1.5/24'));
  C0A8010018

> SELECT hex(try_ip_as_binary('2001:db8::1'));
  20010DB8000000000000000000000001

> SELECT hex(try_ip_as_binary('::ffff:192.168.1.1'));
  00000000000000000000FFFFC0A80101

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

> SELECT try_ip_as_binary('invalid');
  NULL

> SELECT try_ip_as_binary(X'');
  NULL

> SELECT try_ip_as_binary(NULL);
  NULL