try_ip_as_binary-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 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 representing the canonical binary form of the IP address or CIDR block. 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